anvil-architect

Designs software architecture through parallel candidate sketches before implementation begins.

1|Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rogerznts/anvil --skill anvil-architect-rogerznts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: anvil-architect
Source: https://github.com/rogerznts/anvil/tree/main/anvil/.claude/skills/anvil-architect
Command: npx skills add https://github.com/rogerznts/anvil --skill anvil-architect-rogerznts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Jumping straight into code on non-trivial work locks in the wrong structure early. This Skill forces design-first thinking: it grounds the problem in the existing system, generates multiple competing architecture sketches in parallel, synthesizes the best one, and only then fills in implementation against the agreed contract. ## Core Features & Use Cases - Grounded design exploration: Traces the existing system (via the anvil-how skill, git history, and ADRs) so new designs respect real constraints instead of guesses. - Parallel candidate sketches: Runs multiple model runners through anvil-arena, each producing a type sketch, signatures, module map, and prose rationale, then synthesizes one design. - Red-flag screening and scrap loop: Rejects shallow modules, information leakage, temporal decomposition, and pass-through methods, and triggers a full redesign when implementation friction reveals a wrong architecture. - Use Case: Before building a new billing module, invoke the architect to produce two structurally distinct designs, compare their interface depth, ship the chosen skeleton as a scaffold commit, and implement against it. ## Quick Start Ask the assistant to architect the new feature before writing any code, describing the problem and the systems it must integrate with.

Frequently Asked Questions about anvil-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design software architecture before writing code?▼

Start by grounding the problem in the existing system, then sketch types, function signatures, and module boundaries with not-implemented bodies. Generate at least two structurally distinct candidate designs and synthesize the strongest one before implementing against it.

How to compare multiple architecture design candidates?▼

Compare candidates on interface depth: the capability hidden behind the public surface relative to its size. Screen each against red flags like shallow modules, information leakage, temporal decomposition, and pass-through methods before synthesis.

When should I scrap an architecture and redesign from scratch?▼

Scrap when friction repeats in the same shape: recurring workarounds, types needing escape hatches like any or casts, or callers forced to know internal rules. Single hard cases do not condemn a design; repeated patterns of the same deviation do.

What are signs of a shallow module in software design?▼

A shallow module exposes a large interface while hiding little complexity. Signs include callers coordinating several methods for one operation, public options exposing internal stages, and learning the interface not saving callers from learning the implementation.

Does design-first workflow require a human approval checkpoint?▼

No, the checkpoint is opt-in. By default the workflow proceeds directly from synthesized design to implementation, but you can request a pause to review and sign off on the design before any code is written.