Plan — Document skip-quality-gate and refine pre-validation in AGENTS.md#
Summary#
Add documentation for two recently shipped behaviors to AGENTS.md: the skip-quality-gate directive (one-time quality gate bypass for deliver phase) and the refine pre-validation rejection of non-gated tasks. Both are live and undocumented, creating a gap for agents and contributors.
Files#
| File | Action | Description |
|---|---|---|
AGENTS.md | modify | Add subsections documenting both behaviors |
Steps#
- Add
skip-quality-gatedocumentation to the Directive System section — Add a subsection after the existing directive bullets inAGENTS.md(~line 36) covering: purpose (one-time bypass of pre-PR quality checks for deliver phase), usage (/agent skip-quality-gate), one-time consumption behavior, and guardrails (only affects deliver phase, consumed immediately, does not skip code review). - Add
refinepre-validation documentation — Add a subsection documenting: eligibility requirement (task must bestatus=gated), rejection behavior for terminal and non-gated states, error messages posted to GitHub, and remediation steps (check task status, resolve why it's not gated, retry once gated). - Verify formatting and integration — Ensure new subsections integrate into existing structure without creating new top-level sections; confirm bullet-point style matches existing content.
Verification#
AGENTS.mdcontainsskip-quality-gatedirective documentation with purpose, usage, and guardrailsAGENTS.mdcontainsrefinepre-validation documentation with eligibility, error behavior, and remediation- No new top-level sections added — content integrated into existing Directive System section