AAM Command-Line Interface

The AAM binary provides an extensive suite of commands to scaffolding, validate, analyze, and visualize your repository boundaries.

aam status

$npx @architecture-as-memory/aam status

🩺 Running AAM Cognitive Heartbeat... ⏱ Local Telemetry: Hydrated 12 nodes and 9 relationships in 148ms. System Cognition Status: ● Domains : 3 active (Frontend, Backend, Infrastructure) ● Features : 5 capabilities mapped ● Components : 8 system components verified ● Health : 100% stable (0 syntax errors, 0 broken relationships)

aam validate

$npx @architecture-as-memory/aam validate

🔍 Running Schema Integrity Validation... ✓ Checked system.yaml ✓ Checked relationships.yaml ✓ Checked 3 domains ✓ Checked 5 features ✓ Checked 8 components 🎉 Schema validation passed with 0 errors!

Malformed Cognition & Agent ConflictsDuring heavy multi-agent iterations, lower-level AI models (such as OpenCode or sub-agent threads) may mutate yaml schemas incorrectly, producing errors like: **"malformed cognition error: map key must be unique at line 6"**. Run `aam validate` to instantly isolate the malformed file, the exact line number, and structural error locations so you can rectify it before committing.

aam doctor

$npx @architecture-as-memory/aam doctor

🩺 Running AAM Cognitive Doctor Engine... Cognition Health Diagnostics (2 warnings to review): MISSING KNOWLEDGE LINK: - architecture/components/auth-service.yaml: Node 'COMP-AUTH-SERVICE' has no knowledge_links specified. - architecture/domains/frontend.yaml: Node 'DOM-FRONTEND' has no knowledge_links specified. ⏱ Local Telemetry: Hydrated 5 nodes and 1 relationships in 247ms.

aam health

$npx @architecture-as-memory/aam health

📊 Aggregating Core Repository Cognition Metrics... ✓ Schema Syntax Integrity : PASS (100%) ✓ Structural Connectivity : PASS (89% - 1 relationship warnings) ✓ AI Scaffolding Sync : PASS (3/3 files synced) ✓ Offline Topology Hash : 6cf670695a69e7f3be8786f4f50cd8376c17b5dd 🎉 AAM Repository Health is EXCELLENT!

aam snapshot

$npx @architecture-as-memory/aam snapshot

📸 Capturing current architecture schema state... ✓ Captured snapshot: .aam/snapshots/snapshot-1716834000.json ✓ Saved active index signature: 6cf670695a69e7

aam export

$npx @architecture-as-memory/aam export -o architecture-map.html

📦 Exporting living architecture topology... ✓ Read current active graph state ✓ Bundled ReactFlow console frame assets ✓ Wrote standalone offline visualizer html: architecture-map.html 🎉 Static dashboard successfully created! Open in any browser.

aam reinforce

$npx @architecture-as-memory/aam reinforce claude

Reinforcing AAM cognition context for Claude Code / Claude Desktop... ✓ Successfully reinforced AAM reference in CLAUDE.md 🎉 Reinforcement completed! To reactivate context in an already-running AI session, ask the AI: "Please read the AAM skill file /architecture/agents/aam-skill.md"

Idempotent Reinforcement OptionsThe `aam reinforce <provider>` command appends a lightweight, non-invasive cognition anchor reference into target configuration files. Supported providers include: `claude` (CLAUDE.md), `gemini` (.gemini/GEMINI.md), `cursor` (.cursorrules), `codex` (.github/copilot-instructions.md), and `generic` (AGENT.md). Running it multiple times is perfectly safe and will not result in duplicate prompts.