Wabachi

Repository analysis and Architecture Canon tooling

Wabachi provides deterministic repository-analysis workflows for codebase understanding. It can resolve a repository and revision, execute registered analysis providers, generate auditable provider matrices, and validate or render an explicit Architecture Canon.

Quick start

Requires Node.js 24 or newer.

npm install --global wabachi

wabachi --version
wabachi --help

For an ephemeral invocation:

npx --yes wabachi --help

Start here

Read the practical usage manual for repository analysis, provider matrices, retained outputs, and Architecture Canon workflows.

Use live discovery for the installed surface:

wabachi --help
wabachi skill

The bundled agent Skill is available at skills/wabachi/SKILL.md; npm installation ships it as documentation and does not activate a plugin.

Analysis model

Wabachi keeps repository facts and architecture declarations explicit. Repository analysis is performed by registered providers, while Architecture Canon input is supplied as an explicit document and validated before rendering.

The matrix workflow emits retained artifacts so provider output, correlations, and reports can be inspected rather than treated as opaque agent context.

Architecture rendering is npm-native: wabachi architecture render ./architecture.json --out ./artifacts/site uses the bundled React Flow + ELK renderer and does not require Java, Docker, Chromium, Structurizr, a CDN, or network access.

Development

pnpm install --frozen-lockfile
pnpm run verify

pnpm run verify is the repository's authoritative local verification entry point. pnpm run test:package builds, packs, installs, and executes the npm package in an isolated smoke-test environment.

Security

Report vulnerabilities privately as described in SECURITY.md.

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.