Skip to content

Describe issue phases, planning, and relationships #88

Description

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

  • Add Lifecycle with phase-specific issue evolution and gates
  • Add Planning with Why/How/What decomposition rules
  • Add Relationships with containment, sequence, and parallelism rules
  • Reduce Format to universal rules and type-page routing

Validation

  • Verify Process index and all internal links
  • Run documentation checks, CI, and the Copilot review loop

Metadata

Metadata

Labels

NoReleaseNo release required

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions