setup-audit

Extract architecture principles by running an automated audit over the repository to detect tech stack, file structure, patterns, and conventions. The audit generates a per-repo architecture-principles document describing the actual software architecture observed in the codebase.

Merge architecture audits from multiple repositories by using the --merge workflow, which unifies individual per-repo audit outputs into a common reference document for cross-repo architectural alignment.

Document software architecture patterns by auditing the repository to identify existing conventions and generate an architecture-principles.md reference, producing actionable guidance to align team practices and onboard new contributors.

The architecture audit requires no external dependencies or environment setup, running directly as an automated standalone process to analyze the codebase and produce reference files in the .claude/references directory.

Use a single-repo architecture audit to extract principles and conventions for one repository, and switch to the multi-repo --merge workflow when you need to unify separate audits into a common reference across multiple codebases.