{"_id":"@aimlsuperagent/agent","_rev":"10-4b1da2b1783a6ea9c9aafb6cde1a41a2","name":"@aimlsuperagent/agent","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@aimlsuperagent/agent","version":"0.1.0","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.0","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/whisperaiml/superagent-repo/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"0cf204f20282c53a9e4e2ec8e4025a69dce0c307","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.0.tgz","fileCount":44,"integrity":"sha512-pwG8gTmMrzJyPnizAR9NldequwWtatxxIvtrjd5+je065Nbk/6Ot/wBk5PB9bO0P++0+IuwjyV76eF6D+Hsj7w==","signatures":[{"sig":"MEUCIQD50JND+yXIzrGvDllXnsRIXKSKzuNU/DrmbGTQqX0O8QIgObifS2vZDu+yG+kEpk0dlKV2GTCBDHiDtf0rx2Mq8FE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63400},"type":"module","engines":{"node":">=18"},"gitHead":"085d6eb5fb9dbbcd9c9942b97ee06e5a7f6ef493","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-private-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"aimlnexus","email":"admin@aimlsuperagent.com"},"repository":{"url":"git+https://github.com/whisperaiml/superagent-repo.git","type":"git"},"_npmVersion":"10.9.2","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"23.6.0","publishConfig":{"access":"restricted","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.0_1780277716672_0.5467015577936707","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aimlsuperagent/agent","version":"0.1.1","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.1","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"2b7bf5381f0e64c1633bdd9d37c50fc0d32c05eb","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.1.tgz","fileCount":45,"integrity":"sha512-KuZuMzZqU0hUZNP2DjjFpT/fxG5sJjKt6w/hDka4lOLS312WKL5i2SJz76rfZFi27YokZLt9httHhSAHcd9Grg==","signatures":[{"sig":"MEYCIQDkqeelg0Gtt2PtpiiNywx2KGi1cdR1Pw1ytOtYQK/dNQIhAIbRiXeCCvUHaa1QGKo9RNqXnQO79Sa4Py6rmKMaXSN5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73971},"type":"module","engines":{"node":">=18"},"gitHead":"64dc17b6d1cc0e5dc3593d982079a79fcaed7286","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-private-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b9bb8fe-2374-4e37-a256-d77bb969428a"}},"repository":{"url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git","type":"git"},"_npmVersion":"11.13.0","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"24.16.0","publishConfig":{"access":"restricted","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.1_1780308746976_0.7576893130198608","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aimlsuperagent/agent","version":"0.1.2","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.2","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"b7ca465e6a23c4a344f6cffc4f3aa4f8c8772b8e","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.2.tgz","fileCount":45,"integrity":"sha512-yDuy5+QoUyQBUpg/YtQhzCJT+8EFZHb2hj9YNQppcmMJacc7BPERqxq5byW1flCpuiVEbzcI9UkzO2hVf7eGZw==","signatures":[{"sig":"MEUCIAHsedH+lBFZhkhFooAoTSRljH0ShttW/znL7dHy9dfdAiEA6HB8vso6RzgN/r13Sl0LqPKE0toV//VHeZ1LbcqYx2g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aimlsuperagent%2fagent@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":74139},"type":"module","engines":{"node":">=18"},"gitHead":"69f1a935d45e1a17be298c432e561d19cded7061","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-public-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b9bb8fe-2374-4e37-a256-d77bb969428a"}},"repository":{"url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git","type":"git"},"_npmVersion":"11.13.0","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"24.16.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.2_1780309710725_0.8750177021072778","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aimlsuperagent/agent","version":"0.1.3","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.3","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"58acc3260a30ff4ff6f5d6e0dc83cd7040333be1","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.3.tgz","fileCount":46,"integrity":"sha512-SIcsTaqcfgmPJQ0meLfofIXIhKXr0ZLZEKZkv+kxC5dyjzFKRh1y0s1gcgj3krB50UNAUnAV4XpkWM1GDuljyg==","signatures":[{"sig":"MEYCIQCajTmM+LupRMx+BHRVySAg3id1bdhl6C8f/nEDPN0nAgIhAKKHWm5oVz6nDR7uTqwy4RLvU+FFZNh/97XgsHHkjFjW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74780},"type":"module","engines":{"node":">=18"},"gitHead":"141dd61a6c92bdcf19aeb9a393ce331f5f80cb68","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","postinstall":"node scripts/postinstall.js","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-public-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"aimlnexus","email":"admin@aimlsuperagent.com"},"deprecated":"Deprecated: use 0.1.4. This release included internal release-log packaging that was removed from latest.","repository":{"url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git","type":"git"},"_npmVersion":"10.9.2","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"23.6.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.3_1780450236756_0.11354688146602987","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@aimlsuperagent/agent","version":"0.1.4","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.4","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"182502cc1ec21af275e3dd7c4543a55677847921","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.4.tgz","fileCount":45,"integrity":"sha512-P30wTsjd0Odv8MSRbCKoCPZsDGYaeALLRP1tZfOO6cQyeZbvdwkYUHl0IZPUqPuFsLJjrl0x8sbjoYXqTvodWw==","signatures":[{"sig":"MEYCIQCct+oAtj8lOanuXENuMaTA5wmTPuwAWED6hZ0LdJrWvgIhALGvA7Iv5hSTt/h4vSz1Cf97t9W/FxQI8IJQ+mEnHR/i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71177},"type":"module","engines":{"node":">=18"},"gitHead":"3a5445ca4588996d82ad7a091cd776f56455dedf","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","postinstall":"node scripts/postinstall.js","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-public-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"aimlnexus","email":"admin@aimlsuperagent.com"},"repository":{"url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git","type":"git"},"_npmVersion":"10.9.2","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"23.6.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.4_1780452024165_0.28322218994267656","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@aimlsuperagent/agent","version":"0.1.5","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"license":"MIT","_id":"@aimlsuperagent/agent@0.1.5","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"homepage":"https://aimlsuperagent.com","bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"bin":{"aiml-superagent":"bin/aiml-superagent.js"},"dist":{"shasum":"5d5fba91d85aff0d3124b89be87a461ab22ff969","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.5.tgz","fileCount":45,"integrity":"sha512-e7UYt/czVgr49p0M9tEiQq+z1sL+BYQhn/FxbUAw1GNoPpAxFBk3Sz1w+uXRO95mDc1vHThJRoOw7I0EAkcS3w==","signatures":[{"sig":"MEUCIHyR97Qw/Uss5J3NEpUfH4zBfPuhCmedWm1CJxyKrnD6AiEAmiCuB2Kror/CfP1LVeqBgIMbyq+ep+Q9C98St0Zwta8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71875},"type":"module","engines":{"node":">=18"},"gitHead":"316ad3f7027112db86e309dce2b93d1efdabd4ad","scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","postinstall":"node scripts/postinstall.js","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","check:release":"node bin/aiml-superagent.js check . --release --strict","prepublishOnly":"node scripts/assert-public-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"_npmUser":{"name":"aimlnexus","email":"admin@aimlsuperagent.com"},"repository":{"url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git","type":"git"},"_npmVersion":"10.9.2","description":"A token-efficient operating framework for AI coding assistants.","directories":{},"_nodeVersion":"23.6.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent_0.1.5_1780454403702_0.2412355373519488","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@aimlsuperagent/agent","version":"0.1.6","description":"A token-efficient operating framework for AI coding assistants.","type":"module","bin":{"aiml-superagent":"bin/aiml-superagent.js"},"scripts":{"check":"node bin/aiml-superagent.js check .","check:json":"node bin/aiml-superagent.js check . --json","check:release":"node bin/aiml-superagent.js check . --release --strict","pack:dry-run":"npm pack --dry-run --cache ./.npm-cache","postinstall":"node scripts/postinstall.js","prepublishOnly":"node scripts/assert-public-publish-ready.js && node bin/aiml-superagent.js check . --release --strict"},"keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"homepage":"https://aimlsuperagent.com","repository":{"type":"git","url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git"},"bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"engines":{"node":">=18"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"license":"MIT","_id":"@aimlsuperagent/agent@0.1.6","gitHead":"712572b3d3d7c288586e4f697ee3d3bb3b3717e3","_nodeVersion":"23.6.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-g582WlU8RBdVT8s/0lQOWvP+UO00iTh5JlukU85N0VuZrPSvFDK6eAa+DPgKkJtTxJJWT3Ppx42wt8YgiJV8rw==","shasum":"311eb5ac8d31327666592b9d3d7a7c7ebca1c50e","tarball":"https://registry.npmjs.org/@aimlsuperagent/agent/-/agent-0.1.6.tgz","fileCount":45,"unpackedSize":73055,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCNNCgC5Rj2ndsacc609QgqKZ34IxFeMlDsFhymHBwu+AIgeqZ4PwqrxZ6vw/wXGIU4H1GppBDhE+NslKkdVqr1Vns="}]},"_npmUser":{"name":"aimlnexus","email":"admin@aimlsuperagent.com"},"directories":{},"maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent_0.1.6_1780457244657_0.42370075554331144"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-01T01:35:16.480Z","modified":"2026-06-03T03:27:24.916Z","0.1.0":"2026-06-01T01:35:16.826Z","0.1.1":"2026-06-01T10:12:27.139Z","0.1.2":"2026-06-01T10:28:30.890Z","0.1.3":"2026-06-03T01:30:36.947Z","0.1.4":"2026-06-03T02:00:24.312Z","0.1.5":"2026-06-03T02:40:03.892Z","0.1.6":"2026-06-03T03:27:24.781Z"},"bugs":{"url":"https://github.com/marvinbfreedman/aimlsuperagent/issues"},"license":"MIT","homepage":"https://aimlsuperagent.com","keywords":["ai","coding-agent","agents","context-minimizer","developer-tools","llm"],"repository":{"type":"git","url":"git+https://github.com/marvinbfreedman/aimlsuperagent.git"},"description":"A token-efficient operating framework for AI coding assistants.","maintainers":[{"name":"aimlnexus","email":"admin@aimlsuperagent.com"}],"readme":"# AiML SuperAgent\n\nA token-efficient operating framework for AI coding assistants.\n\nAiML SuperAgent turns an AI coding assistant into a long-term project operator. It keeps scoped memory, verifies production reality before changing code, protects secrets, tracks deployments, minimizes wasted context, and produces small safe diffs.\n\nThis is not another prompt collection. It is a repeatable operating layer for real repositories.\n\n## Why AiML SuperAgent?\n\nMost AI coding assistants fail on long-running projects for two reasons:\n\n1. They forget durable production facts.\n2. They overload themselves with stale or irrelevant context.\n\nA behavior file such as `CLAUDE.md` can teach an assistant how to behave in one session: think first, keep changes small, avoid assumptions, and verify results. That is useful and should be kept.\n\nAiML SuperAgent adds the missing operating layer:\n\n- scoped project memory\n- source-of-truth files\n- production-first verification\n- secret-safe notes\n- deployment logs\n- incident memory\n- context minimization\n- task-traceable diffs\n- model-agnostic workflows\n\nUse `CLAUDE.md` for behavior. Use AiML SuperAgent for project operation.\n\n## The Core Idea\n\nThe goal is not bigger notes.\n\nThe goal is smaller active context.\n\nAiML SuperAgent separates durable memory from temporary work. The assistant starts with high-signal files, then searches only the parts of the repo relevant to the current task.\n\nDefault read order:\n\n1. `AGENTS.md`\n2. `REPO_SOURCE_OF_TRUTH.json`\n3. `WORKING_NOTES.md`\n4. the current task prompt\n5. targeted source files found by search\n\nDefault skip list:\n\n- `node_modules`\n- build output\n- `.next`\n- `dist`\n- `coverage`\n- derived data\n- generated artifacts\n- large logs\n- resolved incidents\n- old screenshots\n- unrelated archives\n\nThat is the Context Minimizer.\n\n## What This Repo Provides\n\n```text\naiml-superagent/\n  README.md\n  AGENTS.md\n  bin/\n    aiml-superagent.js\n  docs/\n    01-operating-model.md\n    02-context-minimizer.md\n    03-project-memory.md\n    04-verification-loop.md\n    05-secret-safe-operations.md\n    06-deployment-discipline.md\n    07-note-hygiene.md\n    08-model-agnostic-use.md\n    09-agent-evaluation.md\n    10-adoption-playbook.md\n    11-anti-patterns.md\n    12-context-budget.md\n    13-package-analytics.md\n    comparison-claude-md.md\n    release-checklist.md\n  schemas/\n    repo-source-of-truth.schema.json\n  templates/\n    AGENTS.template.md\n    REPO_SOURCE_OF_TRUTH.template.json\n    WORKING_NOTES.template.md\n    DEPLOYMENT_LOG.template.md\n    INCIDENT_REPORT.template.md\n    SAFE_ENV_AUDIT.template.md\n    PRODUCTION_CHECK.template.md\n    TASK_BRIEF.template.md\n  examples/\n    nextjs-vercel-app/\n      README.md\n      AGENTS.md\n      REPO_SOURCE_OF_TRUTH.json\n      WORKING_NOTES.md\n```\n\n## Quick Start\n\nInstall the package in your project. This is the recommended setup for teams and CI because the CLI version is pinned in `package.json`:\n\n```bash\nnpm i -D @aimlsuperagent/agent\n```\n\nCopy the templates into a project:\n\n```bash\nnpx @aimlsuperagent/agent init .\n```\n\nCheck a project for SuperAgent readiness:\n\n```bash\nnpx @aimlsuperagent/agent check .\n```\n\n## After Init\n\nAfter `init` and `check`, tell your AI coding assistant:\n\n```text\nRead AGENTS.md, REPO_SOURCE_OF_TRUTH.json, and WORKING_NOTES.md first.\nUse them as the project operating context.\nBefore changing code, confirm which backend, service, deployment, or environment is live when relevant; check DEPLOYMENT_LOG.md and PRODUCTION_CHECK.md when available; inspect the relevant source file; avoid stale notes; make the smallest safe diff; run the fastest meaningful proof; and update durable memory only if reality changed.\nDo not store secrets, credential values, private customer data, local machine paths, or scratch-only notes in committed files.\n```\n\nGenerated notes are intended to be safe to commit only after you keep them value-free: record names, roles, decisions, and verification summaries, never credential values, private customer data, local machine paths, or scratch-only notes.\n\nFor personal machine-wide use, install the CLI globally:\n\n```bash\nnpm i -g @aimlsuperagent/agent\naiml-superagent check .\n```\n\nFreshly initialized projects are expected to show `needs-review` until template placeholders for project name, dates, and proof commands are replaced.\n\nFrom this repository, maintainers can run:\n\n```bash\nnpm run check\nnpm run pack:dry-run\n```\n\nBefore making a repo public:\n\n```bash\nnpx @aimlsuperagent/agent check . --release\n```\n\nFor CI where medium-risk findings should fail the build:\n\n```bash\nnpx @aimlsuperagent/agent check . --strict\n```\n\n## Package Analytics\n\nCLI analytics is disabled by default.\n\nEnable it only when you want package usage events sent to the AiML SuperAgent tracking endpoint:\n\n```bash\nAIML_SUPERAGENT_ANALYTICS=1 aiml-superagent check .\n```\n\nYou can also enable or disable it per command:\n\n```bash\naiml-superagent check . --analytics\naiml-superagent check . --no-analytics\n```\n\nThe package sends only privacy-safe operational metadata: command name, package version, Node major version, platform, architecture, CI flag, duration, exit code, readiness label, and finding counts. It does not send file contents, absolute paths, repo names, project names, environment variable values, credentials, or note contents. Like any HTTP request, the receiving endpoint may also receive normal request metadata such as IP address and user-agent.\n\nUse `AIML_SUPERAGENT_ANALYTICS_ENDPOINT` to point the package at a different compatible endpoint.\n\n## The Operating Loop\n\nEvery task follows the same loop:\n\n```text\n1. Orient\n   Read only the source-of-truth files and the active task.\n\n2. Verify\n   Check production reality before changing code when the answer depends on live state.\n\n3. Narrow\n   Search for the smallest source area that can solve the task.\n\n4. Patch\n   Make the smallest safe diff.\n\n5. Prove\n   Run the fastest meaningful test or runtime check.\n\n6. Record\n   Update durable notes only if reality changed.\n```\n\n## Framework Guarantees\n\nAiML SuperAgent is designed to make an assistant:\n\n- explicit about assumptions\n- resistant to stale context\n- careful with secrets\n- aware of production and deployment state\n- less likely to edit the wrong repo\n- less likely to over-refactor\n- more likely to leave a useful audit trail\n\nIt does not guarantee correctness. It gives the assistant a better operating system for reaching correctness.\n\n## Maturity Model\n\nAiML SuperAgent adoption has four levels:\n\n| Level | Name | Description |\n| --- | --- | --- |\n| 0 | Behavior only | A single behavior file tells the assistant to be careful. |\n| 1 | Scoped memory | The project has source-of-truth files and working notes. |\n| 2 | Verified operation | The assistant checks production reality and records proof. |\n| 3 | Context-minimized operation | The assistant loads only durable memory and targeted task context by default. |\n\nThe public goal of this framework is Level 3.\n\n## Model Support\n\nAiML SuperAgent is model-agnostic. It works with:\n\n- Claude\n- GPT-5.5\n- Codex\n- Cursor\n- Perplexity\n- Gemini\n- local models\n- future coding agents\n\nThe model can change. The operating discipline should remain stable.\n\n## Recommended Adoption Path\n\n1. Add `AGENTS.md`, `REPO_SOURCE_OF_TRUTH.json`, and `WORKING_NOTES.md`.\n2. Fill in production owners, deployment surfaces, package manager, test commands, and secret names.\n3. Add `DEPLOYMENT_LOG.md` after the next live deploy.\n4. Add incident reports only for issues that change future behavior.\n5. Run `npx @aimlsuperagent/agent check`.\n6. Iterate until the checker reports no high-risk gaps.\n\n## Design Principles\n\n- Memory should be durable, scoped, and revisable.\n- Context should be loaded by relevance, not by habit.\n- Secrets should be referenced by name and role, never by value.\n- Production reality beats repo assumptions.\n- A small verified diff beats a large plausible rewrite.\n- Notes should reduce future token use, not increase it.\n\n## How This Improves on a Single Behavior File\n\nThe viral `CLAUDE.md` approach is valuable because it gives assistants simple behavioral rules. AiML SuperAgent builds on that idea by adding project-level operation:\n\n- where to find durable facts\n- how to avoid stale context\n- how to verify live systems\n- how to record deployments and incidents\n- how to protect secrets\n- how to keep memory useful over months, not just one session\n\nSee [docs/comparison-claude-md.md](docs/comparison-claude-md.md).\n\n## Status\n\nPublic release candidate. The repository and npm package are public under the MIT License.\n\nPackage name: `@aimlsuperagent/agent`.\n\nInstall globally with `npm i -g @aimlsuperagent/agent`, or run directly with `npx @aimlsuperagent/agent`. See [docs/npm-publishing.md](docs/npm-publishing.md).\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","readmeFilename":"README.md"}