{"_id":"@capitalthought/create-agents-first","_rev":"3-4777f1f602a26d939e8c0056afa7d409","name":"@capitalthought/create-agents-first","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@capitalthought/create-agents-first","version":"0.1.0","keywords":["agents-first","mcp","model-context-protocol","scaffold","cli","agents-md"],"author":{"name":"Joshua Baer","email":"josh@capitalfactory.com"},"license":"MIT","_id":"@capitalthought/create-agents-first@0.1.0","maintainers":[{"name":"joshuabaer","email":"npmjs@joshspam.com"}],"homepage":"https://agentsfirst.dev/principles/","bugs":{"url":"https://github.com/capitalthought/agentsfirst/issues"},"bin":{"create-agents-first":"bin/index.js"},"dist":{"shasum":"08f6c8a8c0f1da8d0f6806bc9f1fa042469de61b","tarball":"https://registry.npmjs.org/@capitalthought/create-agents-first/-/create-agents-first-0.1.0.tgz","fileCount":13,"integrity":"sha512-B26AygFiqYP6OUv6jqfayh9sVYuxLsAY6FwsiGJM7pAy+VbbyEdR6YMZwpsSGk3A3mUNwMVk276vKGtyvBU+pg==","signatures":[{"sig":"MEQCIBYdPwNYMCPjxCUDaf9D+CKWEyZMNtTDBAycqxJTCsPvAiAnmEBkwg2B8wWTJRBBR4jNEhsRSZf1C8EiRdI+2UhNzQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30749},"type":"module","engines":{"node":">=20"},"gitHead":"f79f6b7175ce7e819244e1c8cda90545cf3380c6","_npmUser":{"name":"joshuabaer","email":"npmjs@joshspam.com"},"repository":{"url":"git+https://github.com/capitalthought/agentsfirst.git","type":"git","directory":"tools/create-agents-first"},"_npmVersion":"11.12.1","description":"Scaffold an Agents-First project — MCP server + AGENTS.md + prep gate + typed state. See https://agentsfirst.dev","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/create-agents-first_0.1.0_1778032152669_0.759767397388722","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@capitalthought/create-agents-first","version":"0.1.1","keywords":["agents-first","mcp","model-context-protocol","scaffold","cli","agents-md"],"author":{"name":"Joshua Baer","email":"josh@capitalfactory.com"},"license":"MIT","_id":"@capitalthought/create-agents-first@0.1.1","maintainers":[{"name":"joshuabaer","email":"npmjs@joshspam.com"}],"homepage":"https://agentsfirst.dev/principles/","bugs":{"url":"https://github.com/capitalthought/agentsfirst/issues"},"bin":{"create-agents-first":"bin/index.js"},"dist":{"shasum":"aeda56059eec5d0259c84811791d28f4ca9d5d7d","tarball":"https://registry.npmjs.org/@capitalthought/create-agents-first/-/create-agents-first-0.1.1.tgz","fileCount":13,"integrity":"sha512-pthufKIJO0ZQZqFWtHSYfkLncaD79nylzsdpXnKbDKxSdOt++lmlIdmH5tDGdG04jf/Bl0PKPvSE3TOsCaR0LA==","signatures":[{"sig":"MEUCIEFk+gFFT4fshqCPuMWXPMKc7SH3Q9ng53fOepM+v1E+AiEAxZ8MX/lyCuTKp0ZQlWFXz21usINXCi1JDu2f3oM8q+4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31713},"type":"module","engines":{"node":">=20"},"gitHead":"aeddb37c3fcd0c5c7aedf39c708d2042d9d7442c","_npmUser":{"name":"joshuabaer","email":"npmjs@joshspam.com"},"repository":{"url":"git+https://github.com/capitalthought/agentsfirst.git","type":"git","directory":"tools/create-agents-first"},"_npmVersion":"11.12.1","description":"Scaffold an Agents-First project — MCP server + AGENTS.md + prep gate + typed state. See https://agentsfirst.dev","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/create-agents-first_0.1.1_1778199003510_0.4299203654355266","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@capitalthought/create-agents-first","version":"0.2.0","description":"Scaffold an Agents-First project — MCP server + AGENTS.md + prep gate + typed state. See https://agentsfirst.dev","license":"MIT","author":{"name":"Joshua Baer","email":"josh@capitalfactory.com"},"homepage":"https://agentsfirst.dev/principles/","repository":{"type":"git","url":"git+https://github.com/capitalthought/agentsfirst.git","directory":"tools/create-agents-first"},"bugs":{"url":"https://github.com/capitalthought/agentsfirst/issues"},"keywords":["agents-first","mcp","model-context-protocol","scaffold","cli","agents-md"],"type":"module","bin":{"create-agents-first":"bin/index.js"},"engines":{"node":">=20"},"gitHead":"e22377e00fd544eca6eaaa6e84cad6c6d52e2e0c","_id":"@capitalthought/create-agents-first@0.2.0","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-1ZXRb5OeXoVLycbyipIWY4aoQ3ejNST9NWDJxjhpT+jUSpHVjf/J/0mXPw14mOCKbIBWWjSzjGXxdxuRrODuZQ==","shasum":"cac3c8d91c58ff8b5f490611bb87a120ebda7aaf","tarball":"https://registry.npmjs.org/@capitalthought/create-agents-first/-/create-agents-first-0.2.0.tgz","fileCount":14,"unpackedSize":36917,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC35ODszp2UYgvj6L0+SW9DcIValnJeFXUuQqh2kpfn2AIhAOrmSj4eAXNWz7dfDG2zE1LzGAoaI5uP+PHK1rYT/rU5"}]},"_npmUser":{"name":"joshuabaer","email":"npmjs@joshspam.com"},"directories":{},"maintainers":[{"name":"joshuabaer","email":"npmjs@joshspam.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/create-agents-first_0.2.0_1778431315061_0.7276022835707452"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-06T01:49:12.549Z","modified":"2026-05-10T16:41:55.337Z","0.1.0":"2026-05-06T01:49:12.818Z","0.1.1":"2026-05-08T00:10:03.676Z","0.2.0":"2026-05-10T16:41:55.215Z"},"bugs":{"url":"https://github.com/capitalthought/agentsfirst/issues"},"author":{"name":"Joshua Baer","email":"josh@capitalfactory.com"},"license":"MIT","homepage":"https://agentsfirst.dev/principles/","keywords":["agents-first","mcp","model-context-protocol","scaffold","cli","agents-md"],"repository":{"type":"git","url":"git+https://github.com/capitalthought/agentsfirst.git","directory":"tools/create-agents-first"},"description":"Scaffold an Agents-First project — MCP server + AGENTS.md + prep gate + typed state. See https://agentsfirst.dev","maintainers":[{"name":"joshuabaer","email":"npmjs@joshspam.com"}],"readme":"# @capitalthought/create-agents-first\n\nScaffold an Agents-First project in one command.\n\n```bash\nnpx @capitalthought/create-agents-first my-project\n```\n\nYou get an MCP server scaffold built around the 8 implementation principles from [Agents First](https://agentsfirst.dev): Interface First, Contract First, Prep Gates, Typed State, Visible Outputs, Multi-Model Verification, Perspective Dispatch, and Autonomous Recovery.\n\n## Usage\n\n```bash\nnpx @capitalthought/create-agents-first my-project\ncd my-project\nnpm install\nnpm run prep         # verify the prep gate passes\nnpm run dev          # run the MCP server (stdio)\n```\n\nThen point Claude Code, Cursor, or Windsurf at `tsx src/server.ts` (dev) or `node dist/server.js` (after `npm run build`). The agent immediately sees `my-project_prep`, `example_create`, and `example_list`.\n\n## What you get\n\n- `src/server.ts` — MCP server with stdio transport (Interface First)\n- `AGENTS.md` — usage rules your agent reads before acting (Contract First)\n- `src/prep.ts` + `<project>_prep` MCP tool — pre-flight checks (Prep Gates)\n- `src/state.ts` — Zod-validated typed state with versioned schema (Typed State)\n- `src/recovery.ts` — `withRetry` + `escalate` helpers (Autonomous Recovery)\n- `// TODO: ship to Slack/email/task manager` markers in tools (Visible Outputs)\n- `package.json`, `tsconfig.json`, `.gitignore`, `env.example.txt` (copy to `.env`), `README.md`\n\nAbout 250 LOC total. Read it in 5 minutes, ship in another 5.\n\n## The 8 principles\n\nThe full thesis: <https://agentsfirst.dev>\n\nPer-principle deep dives: <https://agentsfirst.dev/principles/>\n\n## Publishing\n\nThis package publishes to npm via `npm publish --access public` from a granular access token scoped to `@capitalthought` with bypass-2fa enabled. The token lives in 1Password (Capital Factory Employee vault, \"npm — NPM_TOKEN (@capitalthought)\").\n\nFull flow: see `~/icloud/Claude/ref-npm-publishing.md`. Cliff notes:\n\n1. Bump `version` in `package.json`\n2. `npm publish --access public` (token via `~/.npmrc` or `NODE_AUTH_TOKEN` env)\n3. Or push a git tag matching `create-agents-first-v*` if a CI publish workflow is wired up\n\n## License\n\nMIT — see `LICENSE`.\n","readmeFilename":"README.md"}