compiling-architecture

compiling-architecture is a skill for Claude Code, Codex from inetgas/arch-compiler. It costs 66 tokens per session (9,210 once invoked), scanned A, original, MIT.

A repeatable workflow for choosing architecture patterns and finalising a software design from a structured specification and its constraints.

In plain words
What is it for?
Use it to compile an architecture, refine requirements and non-functional constraints, and prepare a design for implementation.
Why use it?
It makes architecture decisions consistent and explains why particular patterns were selected or rejected.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/inetgas/arch-compiler/compiling-architecture
Any agent
npx skills add inetgas/arch-compiler --skill compiling-architecture
Clone the repo
git clone --depth 1 https://github.com/inetgas/arch-compiler

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for compiling-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/inetgas/arch-compiler/compiling-architecture.svg)](https://agentmods.dev/skills/inetgas/arch-compiler/compiling-architecture)
Your own site
<a href="https://agentmods.dev/skills/inetgas/arch-compiler/compiling-architecture"><img src="https://agentmods.dev/badge/skills/inetgas/arch-compiler/compiling-architecture.svg" alt="Measured on agentmods" height="20"></a>
Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 9,210 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00066 $0.09210
Opus 5 $0.00033 $0.04605
Sonnet 5 $0.00013 $0.01842
Haiku 4.5 $0.00007 $0.00921

Measured 4d ago against content hash fbb5f177fabe, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

compiling-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/compiling-architecture/SKILL.md · 703 lines

How it starts

The opening of the file, as written. The whole thing — 703 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Architecture Compiler

Overview

A deterministic compiler that selects architecture design patterns from a canonical YAML spec. No LLM, no hidden defaults — same input always produces the same output. All architectural logic lives in pattern files; the compiler is intentionally simple.


Repo Structure — Read This First

Treat the compiler repo as having this contract:

arch-compiler/
├── README.md
├── AGENTS.md
├── README-AGENTS.md
├── tools/        <-- read-only for agents
├── schemas/      <-- read-only for agents
├── config/       <-- read-only for agents
├── scripts/      <-- read-only for agents
├── patterns/     <-- read-only for agents
└── skills/
    ├── using-arch-compiler/
    │   └── SKILL.md
    ├── compiling-architecture/
    │   └── SKILL.md
    └── implementing-architecture/
        └── SKILL.md

Before acting:

  1. Read AGENTS.md for repo-wide agent rules and boundaries.
  2. Read this SKILL.md for the task-specific workflow.
  3. Treat tools/, schemas/, config/, and patterns/ as read-only unless the human explicitly asks for compiler-maintenance work in this repo.
  4. Use this skill only to turn human inputs and constraints into approved architecture artifacts. Do not use it to implement application code.

The important split is:

  • AGENTS.md = global agent rules for this repo
  • skills/using-arch-compiler/SKILL.md = workflow router
  • skills/compiling-architecture/SKILL.md = how to compile and finalise architecture
  • skills/implementing-architecture/SKILL.md = how to implement an already-approved architecture

When to Use

  • You have a project spec (constraints, targets for nfr/operating_model/cost) and need to select appropriate architecture patterns
  • You want reproducible, reviewable architecture decisions (same spec → same patterns, every time)
  • You are iterating progressively on a spec — starting minimal and adding constraints over time
  • You need to audit why specific patterns were selected or rejected
  • You want cost feasibility analysis
  • You have an existing prototype or codebase and need to compile, validate, or re-approve the architecture it should converge to
  • Implementation or refactoring uncovered architecture drift, and you need to update the spec and recompile before coding continues

Read the full file on GitHub · 703 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 703 lines · 66 tokens per session scan A fbb5f177fabe

Subscribe to this mod's changes

compiling-architecture is a skill published in the GitHub repository inetgas/arch-compiler (10 stars, last pushed 3mo ago), licensed MIT. It adds 66 tokens to every session and 9,210 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

deploy-registry-server-with-cnpg

Deploy the ToolHive Registry Server to a Kind cluster with CloudNativePG (CNPG) PostgreSQL database. Use when you need a production-like PostgreSQL setup with the CNPG operator.

stacklok/toolhive-registry-server · 46 tokens

deploy-registry-server-with-otel

Deploy the ToolHive Registry Server to a Kind cluster with telemetry enabled. Use when you need to deploy the registry server for testing with OTEL metrics and tracing.

stacklok/toolhive-registry-server · 40 tokens

classification-at-scale

Classify an internal catalog against a standard taxonomy at scale using deterministic providers, tri-state signals, batch group review, and a trust flywheel — LLM judgment only for configs, ambiguous tails, and critique.

cruxible-ai/cruxible · 46 tokens

review-thread

Record review verdicts and run the StateNote review thread on an agent-operation instance — every ReviewRequest verdict is one atomic batch-direct-write that advances status and co-writes a reviewnote explaining why, and findings are corrected by appending notes rather than editing them.

cruxible-ai/cruxible · 56 tokens

create-state

Create a new Cruxible state from raw domain data through staged graph, workflow, query, and review-loop design.

cruxible-ai/cruxible · 27 tokens

overlay-and-fit

Create an overlay from a published reference state, use the inherited state plus any applied kit with the lowest-friction path, and only add local config or code when the current overlay is not enough.

cruxible-ai/cruxible · 43 tokens