{"_id":"@architecture-as-memory/aam","_rev":"10-3504007ae29d3a7915ebb96fc4b1d0e4","name":"@architecture-as-memory/aam","dist-tags":{"beta":"1.0.0-beta.6","latest":"1.0.3"},"versions":{"1.0.0-beta.1":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.1","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.1","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"fdba0cb830ed03495995d7053e81537b49599216","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.1.tgz","fileCount":43,"integrity":"sha512-g8zUrfVYozp3R4szy5QvUrqjXzMdmbe7vuredCA1VUcmgutSSeZmsSsgadYiREJigF3Pz4viam23xnnwf8AoBg==","signatures":[{"sig":"MEYCIQDapeAzXqJDuU1avAAlLGi4YgoTQZsv6erOQuNe4SuEkwIhAMK57laCX6EF4Nodsz/3qYZXzOzORG1jOhehK+bv9ei8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":130956},"main":"./src/index.js","type":"module","gitHead":"d36fdde22c4764c071f1a01e10b11aab55d4bfe1","scripts":{"start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"yaml":"^2.3.1","chalk":"^4.1.2","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.1_1779870966182_0.32081599307344333","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.2":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.2","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.2","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"ea59a7fada9d72e9681538daba1edc8823292c61","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.2.tgz","fileCount":43,"integrity":"sha512-Udv4WMgbVCOZEpGA8id5C1VSgErF/MlNuQmAkHeYAYv0CsvM5qZPP9k/gmD7+Z8+Dtmkl6tlLOynrxXWS64P/w==","signatures":[{"sig":"MEUCIHLtmij/myq0DQoy8c9I8Wd+O3njPQs1guGIcpeilXV9AiEAhIp7xJEqSf5lGZ+fh6bkXxNH4TAFO3JWWQeW7R+FeMw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":131037},"main":"./src/index.js","type":"module","gitHead":"07646d06061fba5d4fb0dde136a3f4704de0a530","scripts":{"start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"yaml":"^2.3.1","chalk":"^4.1.2","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.2_1779871349576_0.432469284632762","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.3":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.3","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.3","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"2a8b47a41cb6c309d5e2a08750d3273321f87bdf","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.3.tgz","fileCount":50,"integrity":"sha512-xdYAnawFCNHN4V+JVkOe+QL3o1fDkc1FYcJjmK8HwqH1sC3S797AsU6XFCR1xPyi5/SPz//1KqQE7FiToLYdsA==","signatures":[{"sig":"MEQCIFzGYIWRQ672i3y8wzu7780QhPxLxDdNtEWqTxpSprLyAiBM7f5AFx6EnVqQiFY29CEL7WoxAsbpjFguvMy+YfyllA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":821748},"main":"./src/index.js","type":"module","gitHead":"d8c05caf9312350046ac56c845ce53270a643e6e","scripts":{"build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.3_1779871696336_0.3193256757309997","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.4":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.4","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.4","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"0e7705d06d59e4fcb31b9bb24c34ba3397807f2e","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.4.tgz","fileCount":50,"integrity":"sha512-3e2bnaEIcgQ4jWwVtMd/9AEIZQ5sP6Za9Xfmp0CnVsjoVk3uYZhqE0j8gmZXrE+59o5cGnKdJKKw6zryp1igzg==","signatures":[{"sig":"MEUCIGsTfIP0gDVa/hp20qXiGfqlDXJtCU79BjJWrj04uzAYAiEAwVu8htHwHv2wrxe5MAiW89v2pJJJdWpSvHz6PusycXY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":830342},"main":"./src/index.js","type":"module","gitHead":"0bfb214870092e2f0614ba26423d448b511043ed","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.4_1779874610906_0.4625280497553934","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.5":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.5","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.5","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"8f8ee337db889bca22ebeb54e55f76dcbafc2304","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.5.tgz","fileCount":50,"integrity":"sha512-sqTY0Fy4z23dFCHb93m37xqnvQGxx9H5MgLBeR+7wCkppKFmOIhk5l5avYrodi3YllGBtJrPA0GRABjuMIPDOA==","signatures":[{"sig":"MEQCIGg5RW/bHSmL/d/AaDltWqWQDLmfMP/9pDVjzs02DOSNAiAyzr3HJcg1HSVbMvMyOzCSkO1OqjQfTbhU34gXzfghiw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":834143},"main":"./src/index.js","type":"module","gitHead":"b7157ae2cc7bf44b70b1f6f29cab4c81e61a540c","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.5_1779889594235_0.007785558078024835","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.6":{"name":"@architecture-as-memory/aam","version":"1.0.0-beta.6","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0-beta.6","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"747378b4b5ce1e35d26d07b53de83ed5c0774fe5","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0-beta.6.tgz","fileCount":50,"integrity":"sha512-WL4tjNQSCMuINRTTs0DiFMKMdOqtEFuHJqT+xHd/B1CfJToGIS/toHjxNYU7FcjjB1Xq7ZcGkkbCjcEbCu12Tg==","signatures":[{"sig":"MEQCIHvzSi14DoyPBzP2q6fhvHsL5xsEvqHbVv3QFb/o8JP4AiBh4DMH1URwyXD6RVSn92LGuAw8UjyN3eNkYHT0R//1Fg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":834143},"main":"./src/index.js","type":"module","gitHead":"a7852004860e4d7a7dc55668f655fff6de0f5cc1","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0-beta.6_1779894082077_0.9667851603288791","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@architecture-as-memory/aam","version":"1.0.0","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.0","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"ae7be0a0c19f65bca915f843982d059291ddedf1","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.0.tgz","fileCount":50,"integrity":"sha512-ry540tqx2lCadQCX+iJIjq6tellmno/lUQowyjCifb4rcUrMCU9I3dBman+/RvkOEr8H7z13gUhqFtYZYSgvMg==","signatures":[{"sig":"MEYCIQC0y9wRNSsDoxz7EQkQlk3QrqMStj8SInO9APzhpttriQIhAIOIqMJlqWl8X8/cW5ZljbtPRrnB+oMQ+gUrAm2QjU33","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":836167},"main":"./src/index.js","type":"module","gitHead":"eff86c3aede5bcf85a73dc33dac04646a474e2dd","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aam_1.0.0_1779894556494_0.5278491554997515","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@architecture-as-memory/aam","version":"1.0.1","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.1","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"6cf670695a69e7f3be8786f4f50cd8376c17b5dd","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.1.tgz","fileCount":50,"integrity":"sha512-X1LUcAbBaGGBc6tSIh3ieAVqnlyLyADbGk6GNEUaCiIzVCIcFO8Phkt3KP3Fl702eb1Q9W3M1WwCmg8Z5tNkPw==","signatures":[{"sig":"MEUCIQDGaoTpWBaH99o9Ffb+mP/D1GTvZNOTnSRVJ/lDFwPwsgIgTWW4adeQdeKBfy9tZ34xIF/8Wff3NID80shk+3cLi3s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":837104},"main":"./src/index.js","type":"module","gitHead":"beb1743899f5ab4cd74328baf36f52a315f0644f","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aam_1.0.1_1779895506740_0.32560587480367364","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@architecture-as-memory/aam","version":"1.0.2","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","_id":"@architecture-as-memory/aam@1.0.2","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"bin":{"aam":"bin/aam.js"},"dist":{"shasum":"5d6ee4db707268cef99eb43c0ca7ef4f8cfc2f09","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.2.tgz","fileCount":51,"integrity":"sha512-U8yDABMTSvbWpKMg/ZoGWlgbFBs8zuvhYg5L6znu7bOBkYXGqCDQeIy7j2UaNw2dWvUhVPfrzSNEA5Uw+L+28A==","signatures":[{"sig":"MEUCIBcv3FoOM5PSgOgoLEqlbIAc8C8oRJo1odTH4Z8Ldu9JAiEA6xlORTFOlmGtslURqx7NZQHrsdk/+cGq2INKjBsRbSo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":841569},"main":"./src/index.js","type":"module","gitHead":"5322cc5961fc17c37f3b66e581503f0dd079e920","scripts":{"test":"node --test ./test/cli.test.js","build":"node ./scripts/build.js","start":"node ./bin/aam.js"},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"_npmVersion":"10.9.3","description":"Living cognitive architecture maps for AI coding assistants.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"cors":"^2.8.5","yaml":"^2.3.1","chalk":"^4.1.2","express":"^4.19.2","chokidar":"^3.6.0","fs-extra":"^11.1.1","commander":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aam_1.0.2_1779955607022_0.4803460817554881","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@architecture-as-memory/aam","version":"1.0.3","description":"Living cognitive architecture maps for AI coding assistants.","bin":{"aam":"bin/aam.js"},"main":"./src/index.js","type":"module","scripts":{"start":"node ./bin/aam.js","build":"node ./scripts/build.js","test":"node --test ./test/cli.test.js"},"dependencies":{"chalk":"^4.1.2","chokidar":"^3.6.0","commander":"^11.0.0","cors":"^2.8.5","express":"^4.19.2","fs-extra":"^11.1.1","yaml":"^2.3.1"},"keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"license":"MIT","publishConfig":{"access":"public"},"_id":"@architecture-as-memory/aam@1.0.3","gitHead":"05e21ceff6233051c7c15e45584d3efaeb3da2c2","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-t/in4YJHh9cDIkgz0La0KjlvTKXg26e6RIFdh4p7tjax6IhkmqcxIwgLcDFtq5i6eNlOmy0B/Fiq/vgedcuvHA==","shasum":"5191e68d06d3437eba68d882afbc91ec13c1934c","tarball":"https://registry.npmjs.org/@architecture-as-memory/aam/-/aam-1.0.3.tgz","fileCount":51,"unpackedSize":842662,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDVf9Dd5RCUSSXeRW583KQA2tYWp/HZeRMlfp0F+vVeWgIhAKxKph80MyVBhYGNZR1viLws3MkqF19LtyBW0Ay2C5Il"}]},"_npmUser":{"name":"naresh007","email":"phoenixarjun007@gmail.com"},"directories":{},"maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aam_1.0.3_1779956412176_0.17989129288259198"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-27T08:36:06.046Z","modified":"2026-05-28T08:20:12.530Z","1.0.0-beta.1":"2026-05-27T08:36:06.335Z","1.0.0-beta.2":"2026-05-27T08:42:29.713Z","1.0.0-beta.3":"2026-05-27T08:48:16.549Z","1.0.0-beta.4":"2026-05-27T09:36:51.069Z","1.0.0-beta.5":"2026-05-27T13:46:34.380Z","1.0.0-beta.6":"2026-05-27T15:01:22.266Z","1.0.0":"2026-05-27T15:09:16.637Z","1.0.1":"2026-05-27T15:25:06.892Z","1.0.2":"2026-05-28T08:06:47.212Z","1.0.3":"2026-05-28T08:20:12.330Z"},"license":"MIT","keywords":["architecture","ai","cognition","reactflow","yaml","developer-tools","software-architecture","claude-code","cursor","codex","llm","agentic-ai","ai-native","graph-visualization"],"description":"Living cognitive architecture maps for AI coding assistants.","maintainers":[{"name":"naresh007","email":"phoenixarjun007@gmail.com"}],"readme":"# Architecture-As-Memory (AAM)\r\n\r\n```\r\n    ___    ___    ___  ___ \r\n   /   |  /   |  /   |/   |\r\n  / /| | / /| | / /|   /| |\r\n / ___ |/ ___ |/ / |  / | |\r\n/_/  |_/_/  |_/_/  |_/  |_|\r\n  ARCHITECTURE-AS-MEMORY (AAM) v1.0.0\r\n```\r\n\r\nAn offline, local-first cognition scaffolding system designed to capture, visualize, and sustain architectural boundaries in AI-native software repositories.\r\n\r\nAAM acts as a living memory layer that anchors both human developers and AI agents to the structural boundaries of a system, preventing architectural erosion and cognitive drift.\r\n\r\n---\r\n\r\n## 1. The Core Philosophy\r\n\r\n### The Cognitive Drift Problem\r\nIn AI-native repositories, code mutation occurs at unprecedented velocities. While AI agents can generate hundreds of lines of correct implementation code in seconds, the human mental model of the codebase degrades rapidly. \r\n\r\nWithout a lightweight, structured anchor:\r\n1. **Context Window Saturation**: Agents treat the entire codebase as an amorphous text block, leading to flat files, duplicate implementations, or circular dependencies.\r\n2. **Mental Drift**: Human engineers lose track of *why* components are structured a certain way, leading to high architectural friction.\r\n3. **Decay of Intent**: Critical design decisions are lost in transient chat windows instead of being persisted.\r\n\r\n### How AAM Differs from Existing Tools\r\n\r\n| Dimension | AAM | LLM Wiki Systems | Dependency Graphs |\r\n| :--- | :--- | :--- | :--- |\r\n| **Primary Unit** | Architectural Intent & Capability | Long-form Technical Prose | AST Imports / File Topology |\r\n| **Main Consumer** | Dual (AI Agents & Humans) | Humans Only | Build Systems & Linters |\r\n| **Mutation Rate** | Incremental / Low churn | Infrequent / Out of date | Volatile / Automated |\r\n| **Focus** | \"Why is this system here?\" | \"How do I configure this?\" | \"Which file imports another?\" |\r\n\r\n*   **Unlike a Dependency Graph**: AAM is *not* a file-to-file AST import parser. Physical imports change too rapidly and contain high noise. AAM represents a developer's high-level mental model.\r\n*   **Unlike an LLM Wiki**: It is not written in free-form prose. Free-form prose is expensive for LLMs to read and difficult to validate. AAM uses structured, highly compressed YAML nodes that are immediately actionable.\r\n\r\n---\r\n\r\n## 2. The Architectural Cognition Model\r\n\r\nAAM organizes codebase understanding into exactly four local, structured layers:\r\n\r\n```\r\n  System (system.yaml)\r\n    → Domains (domains/*.yaml)\r\n        → Features / Capabilities (features/*.yaml)\r\n            → Components / Services (components/*.yaml)\r\n```\r\n\r\n1. **System**: The global, top-level identity, description, and stack characteristics of the repository.\r\n2. **Domains**: High-level business or technical boundaries (e.g., `Frontend`, `Backend`, `Data-Ingestion`). \r\n3. **Features (The Capability Anchor)**: Cross-cutting business goals that developers actually reason about (e.g., `Authentication`, `Invoice-Generation`). Features are shared cognition units across domains.\r\n4. **Components**: The modular units of service, UI views, databases, or frameworks that exist *solely to support features* (e.g., `login-ui-component`, `auth-api-service`).\r\n\r\nRelationships are contextual, directional topologies (e.g. `communicates_with`, `consumes`, `publishes_to`) defined globally or locally.\r\n\r\n---\r\n\r\n## 3. CLI Reference & Installation\r\n\r\n### Installation\r\nInitialize AAM directly inside your project root:\r\n```bash\r\n# Initialize cognition folders and detect active AI systems\r\nnpx @architecture-as-memory/aam init\r\n```\r\n\r\n### CLI Commands\r\n\r\n```bash\r\n# Display a quick colorized operational heartbeat of repository cognition health\r\nnpx @architecture-as-memory/aam status\r\n\r\n# Compile a unified health dashboard aggregating validation, doctor, git, and performance telemetry\r\nnpx @architecture-as-memory/aam health\r\n\r\n# Validate AAM schema syntax, duplicate IDs, and broken references\r\nnpx @architecture-as-memory/aam validate\r\n\r\n# Audit cognitive health (detect circular dependencies, feature explosion, naming synonym drift)\r\nnpx @architecture-as-memory/aam doctor\r\n\r\n# Calculate a stable, format-insensitive SHA-256 signature of the current topology\r\nnpx @architecture-as-memory/aam hash\r\n\r\n# Save a snapshot definition of the current topology under .aam/snapshots/\r\nnpx @architecture-as-memory/aam snapshot\r\n\r\n# Export the current living architecture into a standalone, single-file offline visualizer bundle\r\nnpx @architecture-as-memory/aam export -o architecture-map.html\r\n\r\n# Start the local YAML watcher server and open the interactive architecture map\r\nnpx @architecture-as-memory/aam dev\r\n```\r\n\r\n---\r\n\r\n## 4. Multi-Agent Governance Model\r\n\r\nIn multi-agent environments or multi-tool runtimes (such as Claude Desktop sub-agents, Gemini multi-agent workflows, OpenCode task agents, or Codex runtimes), ontology consistency and graph stability are protected by a strict governance rule:\r\n\r\n> ⚠️ **CRITICAL AI GOVERNANCE RULE**: ONLY THE PRIMARY ORCHESTRATION AGENT MAY WRITE OR UPDATE ARCHITECTURE COGNITION DIRECTLY. Sub-agents may analyze implementation details but must never mutate architecture YAML files. \r\n\r\nThis prevents duplicate mutations, structural corruption, and ontology fragmentation during highly concurrent workspace operations.\r\n\r\n---\r\n\r\n## 5. AI-Native Integration Workflow\r\n\r\nAAM is designed to sit alongside your AI assistant's system instructions seamlessly.\r\n\r\n### Step 1: Lightweight Bootstrap Injection\r\nDuring `aam init`, AAM scans your project (up to depth 3) for standard instruction files (`CLAUDE.md`, `.cursorrules`, `.gemini/GEMINI.md`, `AGENT.md`, etc.). It appends a lightweight, idempotent, marker-guarded reference pointing to AAM:\r\n\r\n```markdown\r\n<!-- AAM START -->\r\n\r\nThis repository uses Architecture-as-Memory (AAM).\r\n\r\nBefore implementing:\r\n- Read /architecture/architecture.index.yaml\r\n- Read affected feature and domain YAML files\r\n- Maintain architectural cognition incrementally\r\n\r\nAfter implementation:\r\n- Sub-agents may analyze implementation details but must never mutate architecture cognition directly. Only the primary orchestration agent may write or update architecture YAML nodes.\r\n- Update only affected architecture nodes\r\n- Append relationships instead of regenerating globally\r\n- Preserve stable IDs\r\n\r\nDetailed operational rules:\r\n- /architecture/agents/aam-skill.md\r\n\r\n<!-- AAM END -->\r\n```\r\n\r\n### Step 2: Slash Command Protocol\r\nWhen asking your assistant to build a feature, use custom slash commands or prompt triggers. This hydrates their context window with only the relevant architectural layers instead of dump-loading the whole project:\r\n\r\n```\r\n/aam FEAT-AUTHENTICATION Add password reset support via SMTP.\r\n```\r\n\r\nYour assistant is trained via `aam-skill.md` to:\r\n1. Parse the target capability and its associated component schemas.\r\n2. Formulate an implementation plan respecting existing design boundaries.\r\n3. Complete the coding task.\r\n4. Update affected AAM schemas incrementally (updating responsibilities, appending relationships, and maintaining stable IDs).\r\n\r\n---\r\n\r\n## 6. Hook Philosophy\r\n\r\nAAM strictly adheres to a **Local-First, Capabilities-Based, Non-Destructive** hook paradigm:\r\n\r\n- **No Silent Mutations**: Post-task hooks never auto-write code, preventing corrupt states.\r\n- **Validation Filtering**: When running `aam hooks install claude`, it appends a post-task verification directive in `CLAUDE.md` and creates a local Git `post-commit` hook.\r\n- **Developer Review Prompt**: The hook runs `validate` and `doctor` to identify semantic mismatches, presenting a colorized report prompting the engineer to keep the architectural representation in sync.\r\n\r\n---\r\n\r\n## 7. Interactive Operating Console\r\n\r\nThe AAM visual viewer (`aam dev`) offers a stunning, distraction-free graphite + ember cockpit:\r\n\r\n- **Calm UI**: Designed for long engineering sessions under heavy cognitive load. No neon cyber-glow or resource-intensive 3D physics.\r\n- **Interactive Tree State Preservation**: Zoom, pan coordinates, active inspector sidebars, and expanded tree layers are entirely preserved through incremental patching when live SSE reloads trigger.\r\n- **Fuzzy Search Command Palette**: Triggered instantly with `Ctrl+K`. Indexes names, stable IDs, descriptions, capabilities, and technical enhancements. Center coordinates are targeted smoothly to keep orientation intact.\r\n","readmeFilename":"README.md"}