subagent-council
Multi-perspective review council for pre-execution prompt sharpening and post-execution project code audit (compatible with SDD)
SKILL.mdskills/subagent-council/SKILL.md
GitHubSub-Agent Council
The Council provides a structured, multi-perspective review to eliminate ambiguous assumptions before coding, and audits changes before task completion.
Mode 1: Review Prompt (Pre-Execution Gate)
Trigger before planning or coding begins to dissect instructions and surface hidden constraints.
3 Evaluation Lenses:
- Clarifier Lens (Ambiguity & Assumptions):
- Identify implicit or subjective requirements.
- Formulate clear, binary acceptance criteria (pass/fail).
- Skeptic Lens (Edge Cases & Blast Radius):
- Evaluate boundary and failure scenarios: empty input, malformed data, race conditions.
- Flag potential destructive side effects on external files or database schemas.
- Minimalist Lens (YAGNI & Lean Engineering):
- Eliminate unnecessary abstraction layers (no factory pattern for a single implementation).
- Ensure the solution uses native platform features or stdlib first.
Output Template:
### [Council: Prompt Review]
- **Identified Critical Assumptions**: [List of assumptions]
- **Measurable Acceptance Criteria**:
- [ ] Criterion 1
- [ ] Criterion 2
- **Minimal Execution Path**: [Maximum 3-5 sequential steps]
Mode 2: Review Project (Post-Execution Audit)
Trigger at the end of each task or before marking work as complete.
3 Audit Lenses:
- Correctness Lens (Verification & Invariants):
- Verify every acceptance criterion is demonstrably met.
- Require terminal execution evidence showing exit code 0.
- Security Lens (Safety & Resilience):
- Audit input sanitization at trust boundaries, path traversal risks, and credential exposure.
- Architecture Lens (Simplicity & Diff Hygiene):
- Eliminate dead code, scratch files, and unrequested refactoring.
Output Template:
### [Council: Project Review]
- **Verdict**: [APPROVED | REVISION_REQUIRED | BLOCKED]
- **Verification Evidence**: [Command line + Exit code 0 output]
- **Critical Findings**: [Bugs / vulnerabilities if any]
- **Required Cleanup**: [Lines/files to revert or remove]