pdda
Re-orient to this repo's PDDA operating order. Walks the ROUTER.md startup sequence, names the canonical next file for the task at hand, and reports current PDDA state (active docs, roadmap coverage,
SKILL.mdutils/pdda/templates/pdda/SKILL.md
GitHub/pdda — re-orient to the repo's operating order
A thin re-orientation pass. It does not re-specify any contract; it points at the canonical files and surfaces current state. The source of truth always remains the files themselves.
Steps
Resolve the target repository root with
git rev-parse --show-toplevelfrom the project being worked on; run the following reads and commands from that root. If it is not a Git checkout, use the explicitly supplied project directory. ReadROUTER.mdand follow its startup sequence. Do not summarize the whole repo — load the read-order and the canonical entry points.Name the next file for the current task. Using the routing hints in
ROUTER.md, state the one file the user should look at next given what they're working on (e.g. PDDA contract →PROJECT/PDDA.md; install/extraction →utils/pdda/PDDA-INSTALL.md; repo-local state →ROADMAP.md). Point to one clear file, not a scavenger hunt.Report current PDDA state by running the deterministic surface:
utils/pdda/pdda.sh runIf the user only wants a quick state read, a narrower check is fine (
utils/pdda/pdda.sh status-table,utils/pdda/pdda.sh roadmap-coverage). Report deterministic findings first; do not override them with prose.Give the operator a short orientation: current enforcement mode (
.pdda-mode), what active workPROJECT/2-WORKINGholds, and any findings worth attention — then the recommended next action.
Keep it dumb
- Do not paste the contract, the roadmap rules, or the changelog rules — link to where they live.
- Do not edit anything. This is a read + report pass.
- If
utils/pdda/pdda.shis absent, PDDA isn't installed here; say so and stop.