architecture-design

Installation
SKILL.md

Architecture design

Explore one expensive-to-reverse architecture question when current evidence cannot settle it. Return a proposed decision frontier to the Coordinator. Do not edit production code, accept a decision, or create an ADR.

For a whole-system or module-shape sketch with multi-agent alternatives and mandatory human Agree before any code, use architect instead. This skill remains the narrow seam-or-decision probe.

Process

  1. Bound one question. State why evidence cannot settle it, which decision it blocks or changes, accepted constraints and protected behavior, useful observations, and a time, cost, or scope limit. Inspect relevant code, accepted decisions, rationale, project conventions, and validation paths. Treat conflicts with accepted decisions as evidence.
  2. Build evidence-backed alternatives. For each affected module, name its interface obligations, seam, and expected leverage and locality. Keep uncertain domain terms proposed rather than assumed, and test them with ordinary, edge, and failure scenarios.
  3. Resolve empirical uncertainty with bounded research, spike, or prototype work when inspection cannot answer it. Carry evidence and limits forward. Do not call an unrun proposal evidence.
  4. Compare at least two real alternatives. If evidence leaves one, name the eliminated alternatives and why. Cover only applicable concerns: invariant ownership, dependencies, data and persistence, failure behavior, concurrency, recovery, security, and validation.
  5. Separate reversible implementation choices from material decisions. Leave reversible choices for a later accepted delivery slice.

Return

Return exactly one outcome:

Installs
21
GitHub Stars
1
First Seen
Aug 26, 2026
architecture-design — taecontrol/skills