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:

Installs
20
Repository
venhdev/skills
GitHub Stars
1
First Seen
Sep 6, 2026
clarify — venhdev/skills