clarify
Installation
SKILL.md
clarify — Architectural Deliberation Engine
Uncover hidden assumptions, evaluate architectural trade-offs, and establish definitive system invariants before implementation planning begins.
Operating Invariants
- Zero Filesystem Mutations: Maintain zero filesystem mutations; forbid editing files, drafting code diffs, or executing mutating commands.
- Architectural Scope Discipline: Confine inquiry strictly to high-impact architectural decisions, failure modes, and system invariants; forbid syntax bikeshedding, micro-optimizations, or tangential scope expansion.
- Strict Turn-Halt Interview: Formulate strictly one question per turn and halt turn immediately to await user response; forbid multi-question lists or cascading without user answers.
- Deliberation Budget: Limit inquiries to a maximum of 3 to 5 questions; forbid open-ended interrogation loops. Short-circuit immediately to synthesis when no architectural ambiguities remain.
- Contradiction Circuit Breaker: If proposed requirements conflict with established SSOT specifications or ADRs, halt immediately, cite the contradiction with file pointers, and resolve before proceeding; forbid executing against contradictory specifications.
Domain Engine & Standards
1. Deliberation Dimensions
Evaluate proposals against 5 core architectural dimensions: