Repository navigation
Relocate issue guidance into the OKF section #89
Description
Activity
Implementation started from live
origin/mainat92d25fcafter confirming bootstrap squashd4c4a15is 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
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
Local validation is complete for draft PR #91.
pwsh -NoProfile .github/scripts/Update-DocumentationIndex.ps1 -Checkpassedpwsh -NoProfile .github/scripts/Test-DocumentationLink.ps1passed: all documentation links resolve- Super-Linter v8.7.0 passed the documentation/config scope, including Markdown, natural-language, and codespell validators
zensical build --cleanpassed with no issues
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
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
- The PR remains open and
- added a commit that references this issue
on Jul 25, 2026
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.mdandIssues/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, andTypes/index.mdexist with complete frontmatter and generated navigation tablesIssues/Process/Format.mdIssues/Types/Hierarchy.mdsrc/zensical.tomlpoints to the new locationsTechnical 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
Validation