Documentation section: Guide
The loop
How the skills follow one item from claim to merge, which skills run outside that loop, and how ideas, strategy, corrections, and data flow between them.
On purview.dev each diagram is an interactive LikeC4 sequence: select a step to read what the skill
reads, writes, and commits. Every diagram comes from one model,
pm-skills.c4.
Outside the loop
Section titled “Outside the loop”| Skill | When it runs |
|---|---|
pm-park |
Any time, capture only |
pm-review |
Weekly |
pm-risk |
Capture a risk any time; manage the register when no workflow is active |
pm-checkpoint push/pop |
Emergency suspension; the operation resumes at its checkpoint |
pm-shape, pm-discover, pm-strategy |
Think before building, no workflow active |
pm-item, pm-board, pm-roadmap, pm-status, pm-up-next |
On request, when no workflow is active (their read-only views also mid-workflow) |
pm-rejoin |
Any time the position is unclear; it hands back to the stage |
pm-bug |
A defect needs the facts a fix needs; it routes to a fix or the roadmap |
pm-revise |
Built work is wrong; it may interrupt to correct |
pm-export |
A tool needs the plan as JSON, or the export needs checking |
pm-docs-site |
Plan the site as an item; its build modes run in execute |
Captures, emergencies, and pauses during a workflow have their own diagrams in Non-interruption guarantee.
An idea reaches the roadmap in steps: pm-park (or pm-discover, or pm-bug for a defect) writes
the inbox, pm-review triages it, and pm-shape turns it into a brief and roadmap items. A defect can
skip the brief and become an item directly.
Strategy
Section titled “Strategy”pm-strategy sets milestones and focus, then re-plans the roadmap so Next is ordered by the focus
milestone; pm-board renders that order.
Corrections
Section titled “Corrections”pm-revise writes the correction to the brief’s ## Revisions (an open item) or opens a revision
item with Revisits (a done item), then hands back to the stage skill.
When CI fails, the completion record is already in the pull request but not merged, so it is reversible and the fix goes on the same pull request.
Back on the loop
Section titled “Back on the loop”When a session loses its thread, pm-rejoin finds the true position from git and the planning files,
and repairs NOW.md only after you choose to rejoin.
pm-export writes planning/planning.json from all of the above, and the pm-docs-site site renders
it: see Planning files.