| name | task-planning-and-pr-protocol |
| description | Standardize Codex task planning and PR output. Use when work needs a task plan, PR description, validation evidence, risk assessment, rollback notes, docs/test summary, review rubric, or .github/pull_request_template.md. |
Task Planning And PR Protocol
Purpose
Make agent work auditable from plan through PR by standardizing validation, risks, docs, tests, rollback, and follow-ups.
Inspect First
- existing PR templates, review rubrics, task docs,
AGENTS.md, validation scripts, release docs, and project-specific contribution rules
Procedure
-
Define task protocol.
- Planning expectations.
- Validation evidence.
- Test and docs update rules.
- Risk and rollback notes.
- For broad, risky, dependency, data, auth, CI, or user-facing behavior changes, route pre-implementation inspection through
$pre-edit-investigation-gate.
-
Add PR structure.
.github/pull_request_template.md
docs/development/task-protocol.md
docs/development/review-rubric.md
-
Align reviewers.
- Use
agent-reviewer categories P0-P3.
- Use
$agent-reviewer categories P0-P3.
- Include release and migration notes when relevant.
-
Keep it usable.
- Templates should be short enough to fill out honestly.
- Avoid ceremony for tiny changes unless risk is non-trivial.
Validation
- Confirm PR template includes summary, validation, tests, docs, risks, rollback, and follow-ups.
- Confirm task protocol points to real commands.
Completion Criteria
- Agent-generated PRs include enough evidence for review without requiring archaeology.