The issue model needs a dedicated OKF subtree so agents can navigate from a small index to process guidance or the body rules for one native issue type without loading a monolithic format page.
Request
Create the Ways-of-Working/Issues/ section by relocating the existing issue guidance atomically, then add separate process and type pages. Preserve green navigation and links at every step.
Acceptance criteria
Issues/index.md routes readers into Process and Types subtrees
- Process contains concise Format, Lifecycle, Planning, and Relationships pages
- Types contains a concise Hierarchy overview plus Epic, PBI, Task, and Bug pages
- Every page has
title and description frontmatter and one clear conceptual owner
- Existing Issue Format and Issue Hierarchy content is relocated without broken inbound links, anchors, navigation, or generated indexes
- Workflow remains authoritative for phase definitions
- Sub-issues, dependencies, and parallelism have one canonical explanation
- The four native operational issue types have distinct, non-duplicative body and lifecycle guidance
- All child pull requests pass index, link, lint, clean-build, CI, and Copilot review gates
Technical decisions
Structure: Process and Types are separate indexed subtrees so their child Tasks can proceed independently after the atomic relocation.
Atomic relocation: Moving the existing pages, navigation entries, generated indexes, and every inbound reference is one Task and one pull request. No compatibility stubs remain.
Parallel content: After relocation, Process content and Types content touch separate subtrees and may execute in parallel.
Small pages: Each page states one concept once and links outward rather than copying Workflow or another type page.
Delivery plan
Delivery is tracked through native Task sub-issues. Relocation completes first; Process and Types content then proceed as dependency-free siblings and may run concurrently.
The issue model needs a dedicated OKF subtree so agents can navigate from a small index to process guidance or the body rules for one native issue type without loading a monolithic format page.
Request
Create the
Ways-of-Working/Issues/section by relocating the existing issue guidance atomically, then add separate process and type pages. Preserve green navigation and links at every step.Acceptance criteria
Issues/index.mdroutes readers into Process and Types subtreestitleanddescriptionfrontmatter and one clear conceptual ownerTechnical decisions
Structure: Process and Types are separate indexed subtrees so their child Tasks can proceed independently after the atomic relocation.
Atomic relocation: Moving the existing pages, navigation entries, generated indexes, and every inbound reference is one Task and one pull request. No compatibility stubs remain.
Parallel content: After relocation, Process content and Types content touch separate subtrees and may execute in parallel.
Small pages: Each page states one concept once and links outward rather than copying Workflow or another type page.
Delivery plan
Delivery is tracked through native Task sub-issues. Relocation completes first; Process and Types content then proceed as dependency-free siblings and may run concurrently.