Once the issue guidance has an OKF Process subtree, it needs concise pages that explain how an issue evolves through the existing workflow, when planning introduces Why/How/What detail, and how native relationships distinguish containment from order.
Request
Add Lifecycle, Planning, and Relationships pages under Issues/Process/, and reduce the universal Format page to rules shared by every type. Link to Workflow for phase definitions rather than restating it.
Acceptance criteria
- Lifecycle maps issue-body, type, readiness, and relationship changes onto Capture, Refine, Plan, Build, Review, Ship, and Operate
- Workflow remains the sole owner of phase definitions
- Planning explains progressive Why/How/What decomposition without duplicating spec/design ownership
- Relationships defines native sub-issues as containment and progress
- Relationships defines native blocked-by/blocking edges as execution order
- Ready siblings without dependency edges are explicitly eligible for parallel execution
- Manual
Parent:, Blocked by:, child-link lists, and list-order sequencing are rejected as duplicate sources of truth
- Format contains only universal issue rules and routes type-specific guidance to the Types subtree
- Process index, links, lint, clean build, CI, and Copilot review are green
Technical decisions
Phase ownership: Workflow.md defines the phases. Lifecycle states only what happens to issues as they pass through them.
Planning altitude: Epic carries strategic Why and outcome-level What; PBI carries delivery-level How and bounded What; Task/Bug carries the concrete deliverable and implementation decisions. Each child still explains its local purpose and acceptance criteria.
Native relationships: GitHub relationships are authoritative. Prose records rationale, never a second relationship graph.
Implementation plan
Process pages
Validation
Once the issue guidance has an OKF Process subtree, it needs concise pages that explain how an issue evolves through the existing workflow, when planning introduces Why/How/What detail, and how native relationships distinguish containment from order.
Request
Add Lifecycle, Planning, and Relationships pages under
Issues/Process/, and reduce the universal Format page to rules shared by every type. Link to Workflow for phase definitions rather than restating it.Acceptance criteria
Parent:,Blocked by:, child-link lists, and list-order sequencing are rejected as duplicate sources of truthTechnical decisions
Phase ownership:
Workflow.mddefines the phases. Lifecycle states only what happens to issues as they pass through them.Planning altitude: Epic carries strategic Why and outcome-level What; PBI carries delivery-level How and bounded What; Task/Bug carries the concrete deliverable and implementation decisions. Each child still explains its local purpose and acceptance criteria.
Native relationships: GitHub relationships are authoritative. Prose records rationale, never a second relationship graph.
Implementation plan
Process pages
Validation