📖 [Docs]: Issue planning, types, and relationships are defined

[Marius Storhaug (MariusStorhaug)]

Issue guidance now explains how bodies, types, readiness, and native relationships evolve from capture through operation while keeping the Workflow page authoritative for phase definitions.

New: Issue lifecycle, planning, and relationships

The Process section now maps issue evolution onto the shared workflow, explains progressive Why/How/What decomposition, and establishes GitHub sub-issues and dependency edges as the authoritative containment and execution-order model. Ready siblings without dependency edges can proceed in parallel.

New: Native issue type guidance

Dedicated Epic, PBI, Task, and Bug pages now define the body detail, readiness, planning altitude, and completion rules for each native type. The shared hierarchy page focuses on taxonomy, routing, containment, and promotion or demotion.

Changed: Universal issue format

Issue Format now contains only rules shared by every native type and routes readers to the type-specific guidance. Manual relationship fields, copied child lists, and list-order sequencing are explicitly rejected.

---

Technical details

• Added Lifecycle, Planning, and Relationships pages under Issues/Process/.
• Reduced Format to universal title, body, metadata, audit, and Markdown rules.
• Integrated the complete final Types guidance from PR 📖 [Docs]: Native issue types now have dedicated guidance #93 and preserved both Process and Types navigation subsections.
• Consolidated Tasks Define Epic, PBI, Task, and Bug issue bodies #87 and Describe issue phases, planning, and relationships #88 into this combined pull request after verifying the Types trees are identical.

Relevant issues (or links)

• Fixes Define Epic, PBI, Task, and Bug issue bodies #87
• Fixes Describe issue phases, planning, and relationships #88

[Copilot]

Pull request overview

This PR expands the “Issues → Process” documentation to define how issues evolve through the workflow, how planning detail is added progressively, and how GitHub-native relationships define containment and execution order—while simplifying the “Format” page down to universal rules.

Changes:

• Added new Process pages for lifecycle, planning, and relationship guidance.
• Refactored “Issue Format” to only include rules shared by all issue types and defer type-specific detail elsewhere.
• Updated site navigation and the Process index to include the new pages.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/zensical.toml	Adds the new Process pages to the Zensical nav tree.
src/docs/Ways-of-Working/Issues/Process/Relationships.md	Defines native containment/dependency semantics and rejects manual relationship duplication.
src/docs/Ways-of-Working/Issues/Process/Planning.md	Introduces “planning altitudes” and progressive Why/How/What decomposition guidance.
src/docs/Ways-of-Working/Issues/Process/Lifecycle.md	Maps how issues’ bodies/types/relationships evolve across workflow phases.
src/docs/Ways-of-Working/Issues/Process/index.md	Updates the Process index entries to include the new pages.
src/docs/Ways-of-Working/Issues/Process/Format.md	Replaces the prior detailed format spec with universal rules and cross-links to the new guidance.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

src/docs/Ways-of-Working/Issues/Types/PBI.md:25

• “nested-PBI” is hyphenated here but elsewhere the docs use “nested PBI(s)”. Keeping it unhyphenated avoids inconsistent terminology.

- Explain the decomposition into Task, Bug, or nested-PBI children.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated no new comments.

[Marius Storhaug (MariusStorhaug)]

Generated-index note: Process/index.md now has an accurate section description. Update-DocumentationIndex.ps1 propagates that frontmatter into the parent Issues/index.md row, so both one-line changes travel together in 2c3d91b. The parent-row update is generated Process integration, not broader authored scope.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated no new comments.