Compiling Architecture

Turns a constraints/NFR spec into a deterministic, cost-audited architecture pattern selection.

Works with setup

Test report

Verdict
Works with setup
Score
8.0/10
Tested
Jul 16, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · fc109e2

Real friction, confirmed live: copying only skills/compiling-architecture/ (the standard install) leaves the skill referencing tools/archcompiler.py, schemas/, config/, patterns/ that don't exist anywhere under it -- `ls ~/.codex/arch-compiler/tools/archcompiler.py` and the ~/.claude/arch-compiler equivalent both 404. Cloning the FULL repo to a stable path and running the compiler for real against the bundled fixture worked perfectly: deterministic exit-0 YAML output matching the schema, patterns selected as documented.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 4/5
  • Triggers reliably 5/5
  • Output vs. baseline 7/10
  • Docs & honesty 4/5

What Compiling Architecture does

Workflow skill wrapping a real Python compiler (tools/archcompiler.py) that selects architecture design patterns from a canonical pattern registry based on a YAML spec of constraints, NFRs, and cost ceilings — same input always produces the same output, with mandatory human approval gates before finalising. Triggers when a user wants to select architecture patterns, compile/recompile a spec, or audit why patterns were selected or rejected. Requires the full arch-compiler repo (tools/, schemas/, config/, patterns/) cloned to a stable path, not just the skill folder.

How to install Compiling Architecture

git clone https://github.com/inetgas/arch-compiler.git
mkdir -p ~/.claude/skills
cp -r arch-compiler/skills/compiling-architecture ~/.claude/skills/compiling-architecture
# NOTE: the skill itself is non-functional from this copy alone -- see testNotes

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Compiling Architecture

  • /compiling-architecture Turns a constraints/NFR spec into a deterministic, cost-audited architecture pattern selection.

It also activates on plain-language prompts like these:

  • Pick an architecture pattern for a 99.9% uptime e-commerce API
  • Recompile my architecture spec now that GDPR compliance is required
  • Explain why this pattern was rejected against my cost ceiling

Frequently asked questions

Is the Compiling Architecture skill free?
Yes. The skill itself is free from inetgas/arch-compiler. SkillProof publishes the install command and an independent test verdict at no cost.
Does Compiling Architecture work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 16, 2026. Verdict: Works with setup. Real friction, confirmed live: copying only skills/compiling-architecture/ (the standard install) leaves the skill referencing tools/archcompiler.py, schemas/, config/, patterns/ that don't exist anywhere under it -- `ls ~/.codex/arch-compiler/tools/archcompiler.py` and the ~/.claude/arch-compiler equivalent both 404. Cloning the FULL repo to a stable path and running the compiler for real against the bundled fixture worked perfectly: deterministic exit-0 YAML output matching the schema, patterns selected as documented.
What is the Compiling Architecture SkillProof Score?
8.0/10 — installs cleanly 4/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 4/5.
How do I install Compiling Architecture?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Compiling Architecture with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.