📖 [Docs]: Ways of working now follows the canonical issue model

[Marius Storhaug (MariusStorhaug)]

Ways of Working now treats Epic and PBI as planning aggregates while Task and Bug delivery leaves own implementation and pull-request closure. Workflow is the single process entry point, and ordinary stage procedures live under Ways of Working.

Changed: Agent setup remains actionable

AGENTS.md retains the complete agent-only installation and operating contract: improvement/escalation, ecosystem setup, local identity, README/CONTRIBUTING orientation, worktree discipline, micro-commits, push-every-commit, and MSXOrg memory's direct-main policy.

Changed: Docs use bare backing plus canonical worktree

Each docs repository uses docs.git as a bare backing repository and docs as its clean readable default-branch worktree. Missing installs create that topology directly. Safe simple clones migrate with local branches/tags verified and a retained backup; canonical and legacy worktrees are reused; unsafe states fail with rollback/actionable guidance. Memory remains a simple checkout.

Changed: Refresh-first discovery is enforced

The copied bootstrap seed refreshes and proves an existing bare default branch before creating/loading the canonical worktree. The full bootstrap then validates every configured context repository before any index traversal.

---

Technical details

• Makes Workflow.md the sole process and stage-routing owner.
• Moves stage procedures to Ways-of-Working/Workflow-Stages/.
• Restores all material root AGENTS policy without copying stages.
• Aligns Git Worktrees and bootstrap on sibling docs.git + docs topology.
• Preserves branches/tags during simple-clone migration and rolls back failures.
• Tests the executable Markdown seeds and all supported/unsafe topology states hermetically.

Relevant issues (or links)

• Fixes Align ways-of-working guidance with the issue model #86