**Mandatory pre-merge gate.** Encodes the PR review triage workflow: retrieve all automated and human reviews (Copilot review is auto-triggered on PR open), classify actionable vs. advisory comments, prioritise by blocking/suggestion/nit, batch fixes by file, phase them efficiently, and use scripts/pr_review_reply.py to reply and resolve threads. A PR must NOT be merged or treated as ready to merge until this workflow is complete. USE FOR: reading a new PR review and deciding what to fix in which order; preparing a batch reply file after all fixes are committed; distinguishing nits to acknowledge from blockers that gate merge. DO NOT USE FOR: posting individual replies one-by-one (use pr-review-reply skill instead); authoring the initial PR description; re-requesting review before replies are posted.
Encodes the post-review response loop using scripts/pr_review_reply.py: reply to inline PR comments referencing the fix commit, then resolve threads. USE FOR: responding to GitHub PR review comments after fixing the raised issues; batch-reply-and-resolve in one pass; obtaining comment IDs and thread node IDs from the GitHub API. DO NOT USE FOR: authoring the initial PR description (use the GitHub agent); requesting a new review before replies are posted; re-opening resolved threads.
Orchestrates the full research sprint: fetch-before-act source warming, Research Scout → Synthesizer → Reviewer → Archivist → Orchestrator commit pipeline. USE FOR: starting a research topic with a formal synthesis deliverable; coordinating the research fleet end-to-end; producing D4 docs/research/*.md files with YAML frontmatter (title, status) and required headings (Executive Summary, Hypothesis Validation, Pattern Catalog, Recommendations, Sources). DO NOT USE FOR: single source lookups; non-research implementation tasks; documentation updates without new research.
Encodes the pre-planning protocol from AGENTS.md: create a workplan doc before any multi-phase session execution, scaffold it with scripts/scaffold_workplan.py, and commit it before Phase 1 runs. USE FOR: any session with ≥3 phases or ≥2 agent delegations; any session spanning more than one day; creating an auditable plan history in git. DO NOT USE FOR: single-phase tasks with no delegation; quick one-off commits with no sub-agent orchestration.
Governs the full agent session lifecycle: scratchpad init/close, encoding checkpoint at session start, compaction guard, phase gate protocol, and session summary. USE FOR: starting a new session (prune_scratchpad.py --init); writing ## Session Start with governing axiom; managing cross-agent context in .tmp/<branch>/<date>.md; running the pre-compact checkpoint sequence; writing ## Session Summary and running prune_scratchpad.py --force at session end. DO NOT USE FOR: individual task execution (use the agent directly); committing changes (Orchestrator commits after Review approval); research synthesis (use the Research fleet).
Encodes the mandatory 6-step inter-phase checkpoint sequence that executive-tier agents run after every domain phase and before delegating the next. Includes the context window alert trigger conditions and session handoff prompt template. USE FOR: running the post-phase prune → checkpoint → commit → grep sweep → review → compact sequence; triggering the context-window alert and generating a handoff prompt; ensuring no domain phase is skipped or batched without a gate record. DO NOT USE FOR: deciding which agent to delegate to (use delegation-routing); session start/close lifecycle (use session-management); individual script command syntax (see docs/toolchain/).
Encodes the full pre-commit guardrail sequence from AGENTS.md as a reusable checklist for any agent before git commit or git push. USE FOR: running lint, format, tests, and compliance checks before every commit; determining which checks apply based on which file types changed; installing pre-commit hooks once per clone; verifying CI passes before requesting review. DO NOT USE FOR: test authoring decisions (use the testing guide); release pipeline logic (use the Release Manager agent).
5-step workflow for enriching and executing secondary research sprints on bare-bones GitHub issues (title + URL). Runs Endogenous-First: corpus check before web scouting. Produces a D4 synthesis doc and closes the issue.