Architecture
Craft architecture phase - run the repo's boundary-check harness over the change, triage violations (fix the edge or document an exception); gates the PR. Also useful standalone.From its SKILL.md
npx -y skills add scolladon/craft --skill architectureAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.7 KB, as published. Nobody here has run it
craft:architecture
Preamble (always runs — non-overridable)
-
Manifest read (lint if standalone). Standalone: scope = current branch vs default branch.
-
Resolve the active technique set from
phase.harness(the resolved descriptor), using the same ADR-149 discovery precedence — default-off favours no-op:- Declared —
phase.harness.techniquePlan(engine-emitted) wins outright: each entry specifies techniqueid,runcommand,mode(gate|triage), optionalscope, optionaltriage-procedureref.run-styledefaults tosync. - Derived — absent a declaration, read the repo's own boundary-check conventions (README / CONTRIBUTING / craft config) and derive one technique per documented dependency/import-boundary validation command, each GATE or TRIAGE per its nature.
- No-op (terminal) — absent any declared or derived technique: record
NO-OP(architecture): no techniques declared/probedand release thepropose-gate entry; the phase ends here. This phase is default-off; no-op is the expected outcome in most repos.
Every resolved technique command — declared or derived — is trusted operator input (same trust model as the manifest and
context:files); the derived tier reads the repo's own committed conventions, never an untrusted external source.For each resolved technique, run its
probe(config-file presence / binary resolvable). A failed probe declines the technique by absence:NO-OP(architecture:<technique-id>): declined — probe absent. When every technique is declined: the phase ends here. - Declared —
Procedure (default body — a manifest override: replaces everything below)
- Per-active-technique walk (
run-style: syncdefault — no lock against teardown). For each technique in the resolved active set, scope per the technique'sscope(default: the change's touched code, never wider). Capture the violation/finding report. - The PR waits for triage (orchestrator invariant): on a non-empty finding set,
spawn craft:harness-triager with: the findings; the gate; the commit message
fix(architecture): <technique-id> <scope>(orchore(architecture): <technique-id> <scope>for an exception-only landing); global + architecture-phasecontext:files verbatim; the technique'striage-procedureref (if declared). - Verify the triager's commit; run the phase gate; record per-finding outcomes in the run record.