Free during Early Access
ASA Engine
Deterministic Architecture Toolchain
Structural scanner. Slice generator. Contract system. Boundary enforcement.
Runs locally. Offline. Your code never leaves your machine.
Installation
# Install
pip install asa-engine
# Run in your project directory
asa scan
# JSON output (for CI or automation)
asa scan --json
# Skip the web report link
asa scan --no-url
Requires Python 3.10+. Works on macOS, Linux, and Windows.
What it measures
The scanner calculates the AI Chaos Index (ACI) — a 0–100 score based on five root causes of structural failure in AI-generated codebases:
Oversized files (500+ LOC), deep directory nesting — signals that boundaries aren't enforced.
Circular import chains, god files with 10+ local imports — blast radius multipliers.
Mixed naming conventions, inconsistent patterns across features.
Test-to-source ratio, organized test directories — the regression safety net.
CI/CD pipeline presence, environment configuration — production guardrails.
What the CLI does not detect
The CLI is a detection tool, not a diagnostic. It measures structural signals — but some risks are only visible through expert analysis:
CLI detects
- → Oversized files and deep nesting
- → Circular import chains
- → Naming inconsistency
- → Missing tests and CI/CD
- → Structural risk score (ACI)
Beyond CLI — requires audit
- → Cross-boundary semantic coupling
- → Architecture drift across 50+ AI sessions
- → Deployment fragility patterns
- → Failure pattern analysis (FP001–FP021)
- → Risk cost modeling and remediation plan
The CLI is the X-ray. The audit is the diagnosis and treatment plan.
Why scan first?
Founders testing risk
Get an instant signal before committing to a full audit. If ACI is low, you may not need one.
Engineers validating structure
Run it after every major feature to catch drift early. Integrate with CI using --json output.
Teams wanting objective data
Replace gut feelings with a measurable score. Track ACI over time to see if your architecture is improving or degrading.
Full engine commands
During Early Access, the complete ASA architecture toolchain is available for free. Core commands (scan, create-slice) will always remain free.
Structural Diagnostics
asa scan [path]
AI Chaos Index diagnostic — 5 root causes, risk band, web bridge URL. Always free.
asa scan --json
JSON output for CI pipelines and automation.
Deterministic Slice Architecture
asa create-slice domain/slice
Scaffold a new ASA slice with directory structure and empty spec. Always free.
asa generate-contract domain/slice
Transform slice spec into a deterministic contract (JSON).
asa generate-skeleton domain/slice
Generate handler, repository, and schema files from contract.
asa regenerate-slice domain/slice
Regenerate slice files while preserving your custom code.
asa implement-slice domain/slice
Safety check — generates contract and skeleton if missing.
Architecture Enforcement
asa lint domain/slice
Structural + boundary lint. Validates contract compliance.
asa lint-ts domain/SliceName
TypeScript boundary lint — detects cross-domain import violations.
asa sync-contracts
Validate all contracts across domains. CI-ready.
Frontend Integration
asa generate-frontend domain/SliceName
Generate a frontend UI slice from a backend contract.
asa generate-zod domain/slice
Generate type-safe Zod schema from backend contract.
Early Access notice: All commands are currently available without a license. Core commands (scan, create-slice) will always remain free. Advanced enforcement commands may require a license in the future — with 90 days advance notice.
Example output
$ asa scan
ASA Structural Risk Assessment
==================================
Scanning: /home/dev/my-saas-app
Language: Typescript (Nextjs detected)
Files analyzed: 127
AI Chaos Index: 72 / 100
Risk Band: Unstable
Breakdown:
RC01 Architecture Drift ██████░░░░ 48
RC02 Dependency Corruption ███████░░░ 55
RC03 Structural Entropy ███░░░░░░░ 25
RC04 Test Infrastructure █████████░ 82
RC05 Deployment Safety ████████████ 100
Primary Risk Vector: RC04 — Test Infrastructure
→ No test files detected. 127 source files.
────────────────────────────────────────────
→ Visual report: https://vibecodiq.com/scan/report#eyJ...
────────────────────────────────────────────
Your code never leaves your machine.
Risk bands
| ACI Score | Band | Interpretation |
|---|---|---|
| 0–30 | Stable | Architecture handles AI-assisted development well. |
| 31–55 | Fragile | Hidden coupling. Targeted fixes prevent escalation. |
| 56–75 | Unstable | Active structural decay. Velocity declining. |
| 76–100 | Critical | Codebase resists change. Rewrite risk rising. |
Limitations
The CLI scanner uses static heuristics — file structure, import graphs, naming patterns, and configuration detection. It does not:
- Execute your code or run tests
- Analyze runtime behavior or performance
- Detect business logic errors
- Replace a full architectural review by an expert
The ACI score is a directional indicator of structural risk — not a guarantee. False positives are possible, especially in monorepos or projects with unusual directory structures.
CLI vs. Quick Scan
| ASA Engine CLI (free) | Quick Scan ($297) | |
|---|---|---|
| Runs | Locally on your machine | Expert analysis by architect |
| Time | ~2 minutes | 24 hours |
| ACI score | Automated heuristic | Weighted expert scoring |
| Root causes | All 5 (automated detection) | All 5 (with context analysis) |
| Failure patterns | Structural signals | Full detection (FP001–FP021) |
| Report | Terminal + JSON | PDF with findings |
| Remediation | None | Prioritized recommendations |
The CLI gives you immediate automated diagnostics. The Quick Scan adds expert judgment, context analysis, and actionable recommendations.
Detected high risk?
The CLI gives you detection. The audit gives you the full picture.
→ Root cause mapping across every boundary
→ Stabilization plan with prioritized fixes
→ Structural enforcement design for CI/CD
→ Expert validation — not just heuristics