Relocate issue guidance into the OKF section

[MariusStorhaug]

Issue Format and Issue Hierarchy currently live as large top-level Ways of Working pages with inbound links and navigation entries throughout the repository. They must move into the new OKF subtree without creating a broken intermediate state.

Request

Atomically relocate the existing guidance to Issues/Process/Format.md and Issues/Types/Hierarchy.md, create the Issues, Process, and Types indexes, and update navigation plus every inbound path and anchor in the same pull request. Preserve existing semantics; later Tasks own the new process and type content.

Acceptance criteria

• src/docs/Ways-of-Working/Issues/index.md, Process/index.md, and Types/index.md exist with complete frontmatter and generated navigation tables
• Issue Format is moved to Issues/Process/Format.md
• Issue Hierarchy is moved to Issues/Types/Hierarchy.md
• src/zensical.toml points to the new locations
• Every inbound repository link and heading anchor resolves to the new paths
• No compatibility stub, duplicate legacy page, or unindexed issue-guidance page remains
• Page content changes only where required for paths, titles, or navigation
• Index check, link validation, lint, clean Zensical build, CI, and Copilot review are green

---

Technical decisions

Atomic cutover: File moves, indexes, navigation, and all inbound references land together because deferring references would make the first pull request fail its own link and index checks.

Stable concepts: Format remains the universal body-format owner; Hierarchy remains the type and containment overview. Later Tasks split detailed process and type rules into nearby pages.

No redirect stubs: OKF indexes provide discovery. Old filenames are removed rather than preserved as duplicate routing pages.

---

Implementation plan

Relocation

• Inventory all inbound links and anchors to Issue Format and Issue Hierarchy
• Create the indexed Issues/Process and Issues/Types structure
• Move the two pages without semantic expansion
• Update Zensical navigation and every inbound reference

Validation

• Regenerate and verify documentation indexes
• Validate links, lint, and clean site build
• Complete CI and the Copilot review loop

[MariusStorhaug]

Implementation started from live origin/main at 92d25fc after confirming bootstrap squash d4c4a15 is an ancestor.

• Inventoried 25 inbound legacy path occurrences across navigation, generated indexes, Ways of Working pages, and agent guides
• Confirmed native relationships: parent Create the OKF issue guidance section #85, blocked by completed Configure Epic and PBI issue types #82, blocking Define Epic, PBI, Task, and Bug issue bodies #87 and Describe issue phases, planning, and relationships #88
• Confirmed the atomic move remains limited to relocation, metadata required by the new indexes, and path/anchor updates

[MariusStorhaug]

Atomic relocation is published in draft PR #91 from commit 2215cae.

• Created the indexed Issues, Issue Process, and Issue Types structure
• Moved Issue Format and Issue Hierarchy with 98% similarity; only required relative paths changed inside the pages
• Updated Zensical navigation and all 25 inventoried inbound legacy path occurrences
• Removed both legacy paths with no redirect stubs or duplicate pages
• Index and full-link checks pass; complete local validation is in progress

[MariusStorhaug]

Local validation is complete for draft PR #91.

• pwsh -NoProfile .github/scripts/Update-DocumentationIndex.ps1 -Check passed
• pwsh -NoProfile .github/scripts/Test-DocumentationLink.ps1 passed: all documentation links resolve
• Super-Linter v8.7.0 passed the documentation/config scope, including Markdown, natural-language, and codespell validators
• zensical build --clean passed with no issues

[MariusStorhaug]

PR #91 has completed its automated gates.

• Build, Links, and Lint jobs passed; every reported Super-Linter validator is green
• Explicit Copilot review completed with COMMENTED, zero inline comments, and a clean-round result
• All issue implementation and validation checklist items are complete
• The pull request is ready for the independent human approval gate

[MariusStorhaug]

PR #91 is ready for human review and squash auto-merge is enabled.

• The PR remains open and BLOCKED; it has not merged
• Organization rules require independent approval of the last reviewable push and code-owner review where applicable
• Auto-merge will wait for that independent human gate while preserving the green checks