Replace the stale common/ structure docs with the current skills/ bucket
layout. Root and bucket READMEs now index every SKILL.md by invocation
type, AGENTS.md lists the ten actual buckets, and the project context
pack is condensed to purpose, structure, conventions, and validation.
Add an explicitly invoked Pi orchestration skill that drives a plan from the
current conversation or an @file through a published spec, linked dependency-aware
tickets, and one-at-a-time isolated implementation to a merged PR, using Herdr
and Pi agents with no Bun CLI or orchestration runtime.
- orchestrate-herdr (SKILL.md + dispatcher/run-loop/state references): worker-node
selection and Herdr discovery/validation, plan-and-publish, one-at-a-time task
loop (claim, isolate, implement, verify, four-axis review, scoped fix rounds max
three, transient retries max two, reconcile uncertain side effects, escalate),
PR/merge/close gates, authoritative worker-node state, cross-system recovery,
and owned-only cleanup that preserves dirty worktrees and retained state.
- dual-review: self-contained correctness/security + maintainability review axis
(four-axis review with code-review).
- to-spec and to-tickets: drop disable-model-invocation so the orchestration
workflow can invoke them.
- READMEs: list the two new skills.
Reorganize README.md with category sections (engineering, pkm, etc.)
for both user-invoked and model-invoked skills. Add new subcategory
READMEs for skill-authoring and thinking-and-docs. Replace
/setup-matt-pocock-skills references with setup-skills across all SKILLs.