sills-audit-architecture

Inspect whether the repository and application are structured clearly and remain maintainable.

Install

npx sills-audit-architecture install

The installer supports --codex, --claude, --global, --force, --dry-run, and --target PATH.

Use

$sills-audit-architecture Audit this project.

What it inspects

Application and package boundaries, component responsibilities, services, integrations, state, coupling, dependencies, duplication, complexity, testability, documentation drift, and generated-code incoherence.

What it gives you

• A dated human-readable audit report.
• Structured JSON for automation and remediation agents.
• Explicit tested and untested coverage.
• Evidence, raw tool output, and manual-review queues.
• Prioritised findings with severity, confidence, impact, recommendations, and verification steps.
• Concrete positive findings worth preserving.
• A remediation handoff another agent can follow.

Modes

source, runtime, full, changed, ci, and verify, with quick, standard, and deep depth profiles where the environment permits.

Report-only safety

The skill never changes the audited product. It may create files only inside the selected audit directory. It does not install dependencies into the project or mutate real data.

Limitations

The report states all unavailable roles, routes, workflows, states, platforms, and tools. Automated passes are not proof of complete quality, compliance, or security.