{"id":"58a3a923-f9f4-4840-8ca3-fe40693e0a0d","shortId":"tj9M95","kind":"skill","title":"using-arch-compiler","tagline":"Use when starting architecture work and you need to decide whether to compile/finalise architecture or implement an already-approved architecture.","description":"# Using Architecture Compiler\n\n## Read This First\n\nBefore doing anything else:\n\n1. Read `AGENTS.md`.\n2. Treat `tools/`, `schemas/`, `config/`, and `patterns/` as read-only unless the human explicitly asked for compiler-maintenance work in this repo.\n3. Decide whether the task is about architecture selection or architecture implementation.\n\n## Routing Rule\n\nUse `skills/compiling-architecture/SKILL.md` when:\n- the user wants to turn requirements into architecture decisions\n- the user wants to write or refine a spec\n- the user wants to compile, recompile, inspect pattern selection, or finalise an architecture\n- the user has an existing prototype or codebase and needs to compile, validate, or re-approve the architecture it should converge to\n- `docs/architecture/` does not exist yet\n- `docs/architecture/architecture.yaml` is missing approval\n- implementation planning or coding exposes unresolved provider/runtime/auth/retention/message-path decisions\n- any later decision would change `constraints.*`, `constraints.saas-providers`, top-level `patterns.*`, or accepted risk posture\n- the user wants existing prototype choices to replace approved providers, boundaries, or selected patterns\n\nUse `skills/implementing-architecture/SKILL.md` when:\n- `docs/architecture/architecture.yaml` exists\n- it is approved\n- the task is to write code that follows that architecture\n- the task is to refactor an existing prototype or codebase so it conforms to the approved architecture\n- provider/runtime bindings are already concrete enough that coding will not silently replace the approved contract\n\n## Hard Stops\n\n- If the full Architecture Compiler repo is not installed in a stable local path, stop and install it before routing further. Installing only copied skill files is not enough; the workflows depend on `tools/`, `schemas/`, `config/`, and `patterns/`.\n- If no application repo exists yet, do not write app architecture artifacts into the compiler repo.\n- If an implementation task lacks approved architecture, stop and switch to the compiling skill.\n- If planning starts under the implementing skill and reveals unresolved architecture-binding choices, stop and route back to the compiling skill before more planning or coding.\n- If a previously approved architecture is recompiled or materially changed, treat the old approval as invalid until the human re-approves the new output.\n- If the user is asking to change compiler behavior or the pattern registry itself, this is compiler-maintenance work, not normal skill usage.\n\n## Output\n\nAfter choosing, explicitly say which of the two skills you are using and why.","tags":["using","arch","compiler","inetgas","agent-skills","ai-governance","architecture","architecture-as-code","architecture-harness","cost-optimization","design-pattern-registry","design-patterns"],"capabilities":["skill","source-inetgas","skill-using-arch-compiler","topic-agent-skills","topic-ai-governance","topic-architecture","topic-architecture-as-code","topic-architecture-harness","topic-cost-optimization","topic-design-pattern-registry","topic-design-patterns","topic-deterministic-compiler","topic-deterministic-execution","topic-developer-tools","topic-harness-engineering"],"categories":["arch-compiler"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/inetgas/arch-compiler/using-arch-compiler","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add inetgas/arch-compiler","source_repo":"https://github.com/inetgas/arch-compiler","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (2,625 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:37.373Z","embedding":null,"createdAt":"2026-05-18T13:22:23.919Z","updatedAt":"2026-05-18T19:14:37.373Z","lastSeenAt":"2026-05-18T19:14:37.373Z","tsv":"'1':36 '2':39 '3':63 'accept':164 'agents.md':38 'alreadi':23,219 'already-approv':22 'anyth':34 'app':280 'applic':273 'approv':24,127,142,175,188,214,229,292,331,341,349 'arch':3 'architectur':8,18,25,27,70,73,87,110,129,198,215,236,281,293,312,332 'architecture-bind':311 'artifact':282 'ask':54,357 'back':318 'behavior':361 'bind':217,313 'boundari':177 'chang':155,337,359 'choic':172,314 'choos':379 'code':146,194,223,327 'codebas':118,208 'compil':4,28,57,102,122,237,285,299,321,360,370 'compile/finalise':17 'compiler-mainten':56,369 'concret':220 'config':43,268 'conform':211 'constraint':156 'constraints.saas':157 'contract':230 'converg':132 'copi':256 'decid':14,64 'decis':88,150,153 'depend':264 'docs/architecture':134 'docs/architecture/architecture.yaml':139,184 'els':35 'enough':221,261 'exist':115,137,170,185,205,275 'explicit':53,380 'expos':147 'file':258 'finalis':108 'first':31 'follow':196 'full':235 'hard':231 'human':52,346 'implement':20,74,143,289,306 'inspect':104 'instal':241,249,254 'invalid':343 'lack':291 'later':152 'level':161 'local':245 'mainten':58,371 'materi':336 'miss':141 'need':12,120 'new':351 'normal':374 'old':340 'output':352,377 'path':246 'pattern':45,105,162,180,270,364 'plan':144,302,325 'postur':166 'previous':330 'prototyp':116,171,206 'provid':158,176 'provider/runtime':216 'provider/runtime/auth/retention/message-path':149 're':126,348 're-approv':125,347 'read':29,37,48 'read-on':47 'recompil':103,334 'refactor':203 'refin':95 'registri':365 'replac':174,227 'repo':62,238,274,286 'requir':85 'reveal':309 'risk':165 'rout':75,252,317 'rule':76 'say':381 'schema':42,267 'select':71,106,179 'silent':226 'skill':257,300,307,322,375,386 'skill-using-arch-compiler' 'skills/compiling-architecture/skill.md':78 'skills/implementing-architecture/skill.md':182 'source-inetgas' 'spec':97 'stabl':244 'start':7,303 'stop':232,247,294,315 'switch':296 'task':67,190,200,290 'tool':41,266 'top':160 'top-level':159 'topic-agent-skills' 'topic-ai-governance' 'topic-architecture' 'topic-architecture-as-code' 'topic-architecture-harness' 'topic-cost-optimization' 'topic-design-pattern-registry' 'topic-design-patterns' 'topic-deterministic-compiler' 'topic-deterministic-execution' 'topic-developer-tools' 'topic-harness-engineering' 'treat':40,338 'turn':84 'two':385 'unless':50 'unresolv':148,310 'usag':376 'use':2,5,26,77,181,389 'user':81,90,99,112,168,355 'using-arch-compil':1 'valid':123 'want':82,91,100,169 'whether':15,65 'work':9,59,372 'workflow':263 'would':154 'write':93,193,279 'yet':138,276","prices":[{"id":"9a9b57a2-c25c-47aa-9629-c345c7ae60d0","listingId":"58a3a923-f9f4-4840-8ca3-fe40693e0a0d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"inetgas","category":"arch-compiler","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:23.919Z"}],"sources":[{"listingId":"58a3a923-f9f4-4840-8ca3-fe40693e0a0d","source":"github","sourceId":"inetgas/arch-compiler/using-arch-compiler","sourceUrl":"https://github.com/inetgas/arch-compiler/tree/main/skills/using-arch-compiler","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:23.919Z","lastSeenAt":"2026-05-18T19:14:37.373Z"}],"details":{"listingId":"58a3a923-f9f4-4840-8ca3-fe40693e0a0d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"inetgas","slug":"using-arch-compiler","github":{"repo":"inetgas/arch-compiler","stars":6,"topics":["agent-skills","ai-governance","architectural-decision-records","architecture","architecture-as-code","architecture-as-code-tools","architecture-harness","cost-optimization","design-pattern-registry","design-patterns","deterministic-compiler","deterministic-execution","developer-tools","harness-engineering","harness-framework","nfr-enforcement","software-architecture-patterns"],"license":"mit","html_url":"https://github.com/inetgas/arch-compiler","pushed_at":"2026-05-18T02:16:55Z","description":"An architecture-level AI harness that compiles constraints and NFRs into explicit, reviewable architecture decisions. Combines a deterministic compiler, curated pattern registry, and agent workflow skills to drive approval, re-approval, and implementation against an architectural contract.","skill_md_sha":"4a2ecfd9518f95461baf1a929bf0e7304ce20352","skill_md_path":"skills/using-arch-compiler/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/inetgas/arch-compiler/tree/main/skills/using-arch-compiler"},"layout":"multi","source":"github","category":"arch-compiler","frontmatter":{"name":"using-arch-compiler","description":"Use when starting architecture work and you need to decide whether to compile/finalise architecture or implement an already-approved architecture."},"skills_sh_url":"https://skills.sh/inetgas/arch-compiler/using-arch-compiler"},"updatedAt":"2026-05-18T19:14:37.373Z"}}