{"_id":"007devkit","name":"007devkit","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"007devkit","version":"0.1.0","description":"CLI scaffold for TypeScript projects: AI agent system, AIM methodology and coding standards in seconds.","keywords":["cli","scaffold","devkit","ai-agents","angular","nestjs","react","nextjs","vue","nuxt","ionic","typescript","cursor","claude-code"],"homepage":"https://github.com/007devkit/007devkit#readme","bugs":{"url":"https://github.com/007devkit/007devkit/issues"},"repository":{"type":"git","url":"git+https://github.com/007devkit/007devkit.git"},"license":"MIT","author":"","type":"module","main":"dist/index.cjs","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"bin":{"007devkit":"dist/cli.js","devkit":"dist/cli.js"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","lint":"tsc --noEmit","prepublishOnly":"npm run lint && npm run build && npm test"},"dependencies":{"@clack/prompts":"^0.7.0","chalk":"^5.3.0","commander":"^12.0.0","ejs":"^3.1.10","fs-extra":"^11.2.0","ora":"^8.0.0"},"devDependencies":{"@types/ejs":"^3.1.5","@types/fs-extra":"^11.0.4","@types/node":"^20.12.0","@vitest/coverage-v8":"^1.5.0","execa":"^8.0.1","tsup":"^8.0.2","typescript":"^5.4.0","vitest":"^1.5.0"},"_id":"007devkit@0.1.0","gitHead":"7ab361bb45842ffe8099f7fb3934edbeb94f771b","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-rLeI+PPe+Ia4KJj5K74U3sq/+DhSh2X7otfpZYQ/iEO9dARMSKiW8akiuMgMncDyCEwb7qoCCGML+a+Um7tElw==","shasum":"4376332a5e38e02319f5bf2a3537b132a7cdc1a1","tarball":"https://registry.npmjs.org/007devkit/-/007devkit-0.1.0.tgz","fileCount":85,"unpackedSize":366831,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFnaPPSi7AGro1mCNcPzaS8v0VDRIqw5s8/N23Ls4VDZAiEA6dbVAFMaES9jnrZ+yBnfCNQNi1vu3k1vy/sUyK2MRnY="}]},"_npmUser":{"name":"victor198siete","email":"victor198siete@gmail.com"},"directories":{},"maintainers":[{"name":"victor198siete","email":"victor198siete@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/007devkit_0.1.0_1775229493398_0.39647180137016824"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-03T15:18:13.397Z","0.1.0":"2026-04-03T15:18:13.553Z","modified":"2026-04-03T15:18:13.824Z"},"maintainers":[{"name":"victor198siete","email":"victor198siete@gmail.com"}],"description":"CLI scaffold for TypeScript projects: AI agent system, AIM methodology and coding standards in seconds.","homepage":"https://github.com/007devkit/007devkit#readme","keywords":["cli","scaffold","devkit","ai-agents","angular","nestjs","react","nextjs","vue","nuxt","ionic","typescript","cursor","claude-code"],"repository":{"type":"git","url":"git+https://github.com/007devkit/007devkit.git"},"bugs":{"url":"https://github.com/007devkit/007devkit/issues"},"license":"MIT","readme":"<div align=\"center\">\n\n# 007devkit\n\n**Scaffold any TypeScript project with a complete AI agent system,\nAIM methodology and coding standards — in seconds.**\n\n[![npm version](https://img.shields.io/npm/v/007devkit?color=black&style=flat-square)](https://www.npmjs.com/package/007devkit)\n[![npm downloads](https://img.shields.io/npm/dm/007devkit?color=black&style=flat-square)](https://www.npmjs.com/package/007devkit)\n[![license](https://img.shields.io/github/license/victor198siete/007devkit?color=black&style=flat-square)](./LICENSE)\n[![node](https://img.shields.io/node/v/007devkit?color=black&style=flat-square)](https://nodejs.org)\n[![tests](https://img.shields.io/github/actions/workflow/status/victor198siete/007devkit/ci.yml?label=tests&style=flat-square)](https://github.com/victor198siete/007devkit/actions)\n\n```bash\nnpx 007devkit init\n```\n\n</div>\n\n---\n\n## The problem\n\nYou start a new TypeScript project. Before writing a single line of business logic, you need to set up how you'll collaborate with AI tools:\n\n- What rules does the AI follow for *your* stack?\n- How do you request a feature without re-explaining the architecture every time?\n- How do you keep context across sessions?\n- How do you onboard the AI to a bug without 5 back-and-forth messages?\n\n**007devkit solves this by generating a complete AI collaboration environment tailored to your stack.**\n\n---\n\n## What gets generated\n\n```\nyour-project/\n├── .cursorrules              ← Rules for Cursor / Windsurf\n├── CLAUDE.md                 ← Instructions for Claude Code CLI\n├── devkit.config.json        ← Installed config (for future updates)\n│\n├── agents/\n│   ├── roles/                ← One file per agent (@pm, @backend, @frontend…)\n│   ├── workflows/            ← Step-by-step guides (new module, debug, tests, review)\n│   ├── prompts/              ← Templates for feature requests, bugs, ADRs\n│   └── contexts/             ← Session state + handoff between sessions\n│\n└── docs/\n    ├── aim-methodology.md    ← R-A-C-V collaboration cycle\n    └── <stack>-standards.md  ← Coding standards for your exact stack\n```\n\nEverything is plain Markdown — readable, editable, committable. No lock-in.\n\n---\n\n## Quick start\n\n```bash\n# Run interactively in current directory\nnpx 007devkit init\n\n# Scaffold into a new directory\nnpx 007devkit init my-project\n\n# Update templates later (never overwrites your customizations)\nnpx 007devkit update\n```\n\n---\n\n## Supported stacks\n\n| Layer | Options |\n|-------|---------|\n| **Frontend** | Angular 21 + Signals, React 19, Next.js 14 (App Router), Vue 3, Nuxt 3 |\n| **Backend** | NestJS, Express / Fastify, Next.js API Routes |\n| **Mobile** | Ionic + Capacitor, React Native + Expo |\n| **Database** | PostgreSQL, MySQL, MongoDB |\n| **Monorepo** | Nx, Turborepo |\n| **AI tool** | Claude Code CLI, Cursor / Windsurf, Both |\n| **Language** | English, Español |\n\nEach combination generates a custom `.cursorrules` and `CLAUDE.md` composed from stack-specific rule blocks — no irrelevant rules, no generic boilerplate.\n\n---\n\n## Interactive setup\n\n```\n┌  007devkit — AI Dev Environment Setup\n│\n◇  Project name\n│  my-app\n│\n◇  Frontend framework\n│  ❯ Angular 21 + Signals\n│    React 19\n│    Next.js 14 (App Router)\n│    Vue 3 · Nuxt 3 · None\n│\n◇  Backend framework\n│  ❯ NestJS\n│    Express / Fastify\n│    Next.js API Routes · None\n│\n◇  Database\n│  ❯ PostgreSQL\n│    MySQL · MongoDB · None\n│\n◇  Mobile app?\n│  ❯ No mobile\n│    Ionic + Capacitor\n│    React Native / Expo\n│\n◇  Monorepo tool?\n│  ❯ No (single repo)\n│    Nx · Turborepo\n│\n◇  Primary AI tool\n│  ❯ Claude Code (CLI)\n│    Cursor / Windsurf · Both\n│\n◇  Documentation language\n│  ❯ English · Español\n│\n└  ✓ Done!\n\n  Created:\n    ✓  CLAUDE.md\n    ✓  .cursorrules\n    ✓  agents/roles/project-manager.md\n    ✓  agents/roles/backend-agent.md\n    ✓  agents/roles/frontend-agent.md\n    ✓  agents/roles/security-agent.md\n    ✓  agents/workflows/init-session.md\n    ✓  agents/workflows/new-backend-module.md\n    ✓  agents/workflows/new-frontend-component.md\n    ✓  agents/workflows/debug-issue.md\n    ✓  agents/workflows/write-tests.md\n    ✓  agents/workflows/review-code.md\n    ✓  agents/prompts/feature-request.md\n    ✓  agents/prompts/bug-report.md\n    ✓  agents/prompts/architecture-decision.md\n    ✓  agents/contexts/session-state.md\n    ✓  agents/contexts/handoff-template.md\n    ✓  docs/aim-methodology.md\n    ✓  docs/nest-backend-general-standards.md\n    ✓  docs/frontend-architecture-standards.md\n    ✓  devkit.config.json\n```\n\n---\n\n## Using the agent system\n\nOnce initialized, use agent aliases directly in your AI tool:\n\n```\n# Coordinate a new feature\n@pm: add daily attendance registration for classrooms\nType: Full Stack\n\n# Go straight to backend implementation\n@backend: create the Attendance NestJS module\nWorkflow: agents/workflows/new-backend-module.md\n\n# Report a bug with full context\n@backend: [fill in agents/prompts/bug-report.md and paste here]\n\n# Pre-PR review\n/review-code: attendance module\n\n# Resume after a break\nRead agents/contexts/session-state.md — what's pending?\n```\n\n---\n\n## AIM Methodology\n\nEvery task follows the **R-A-C-V** cycle, defined in `docs/aim-methodology.md`:\n\n| Phase | What happens |\n|-------|--------------|\n| **R** — Requirements | Define goal, actor, scope, and API contract |\n| **A** — Architecture | Select patterns per layer, list files to create |\n| **C** — Code | Atomic implementation, backend first if Full Stack |\n| **V** — Validation | Build passes · tests pass · security checked · PR ready |\n\nThe AI reads this methodology automatically at session start and applies it to every request.\n\n---\n\n## Updating templates\n\n```bash\nnpx 007devkit update\n```\n\nPrompts you for each file group. Files you've customized are never overwritten automatically.\n\nYour `devkit.config.json` tracks what's installed:\n\n```json\n{\n  \"version\": \"0.1.0\",\n  \"projectName\": \"my-app\",\n  \"blocks\": [\"angular\", \"nestjs\", \"postgresql\", \"nx\"],\n  \"aiTool\": \"both\",\n  \"language\": \"en\",\n  \"customized\": [],\n  \"installedAt\": \"2026-04-02T10:00:00.000Z\"\n}\n```\n\n---\n\n## How it works\n\n007devkit uses a **block composition** system:\n\n```\ntemplates/\n├── core/          ← Installed in every project (stack-agnostic)\n│   ├── agents/    ← Universal prompts, workflows, context templates\n│   └── docs/      ← AIM methodology\n│\n└── blocks/        ← Installed based on your selections\n    ├── frontend/angular/\n    ├── backend/nestjs/\n    ├── mobile/ionic/\n    ├── database/postgresql/\n    └── monorepo/nx/\n```\n\nEach block contributes:\n- A **role file** (`agents/roles/<agent>.md`) — identity, rules, stack-specific patterns\n- A **standards doc** (`docs/<stack>-standards.md`)\n- **Workflow files** (`agents/workflows/new-<thing>.md`)\n- A **`.cursorrules` fragment** — injected into the final file\n- A **`CLAUDE.md` fragment** — injected into the final file\n\nThe final `.cursorrules` and `CLAUDE.md` are assembled from the header scaffold + all selected fragments + footer scaffold, rendered with [EJS](https://ejs.co/) using your project variables.\n\n---\n\n## Requirements\n\n- Node.js 18+\n- Any TypeScript project\n\n---\n\n## Contributing\n\nContributions welcome — especially new stack blocks.\n\n### Adding a new stack\n\n```\ntemplates/blocks/<layer>/<framework>/\n├── role.md                    ← Agent identity, stack rules, patterns, checklist\n├── standards.md               ← Coding standards for this stack\n├── workflows/\n│   └── new-<thing>.md         ← Step-by-step creation workflow\n├── cursorrules.fragment.ejs   ← Injected into .cursorrules\n└── claude.fragment.ejs        ← Injected into CLAUDE.md\n```\n\nThen register it in `src/composer/template-composer.ts` in the appropriate blocks map, and add tests.\n\n### Development setup\n\n```bash\ngit clone https://github.com/victor198siete/007devkit\ncd 007devkit\nnpm install\nnpm run dev       # watch mode\nnpm test          # 42 tests\n```\n\n### PR checklist\n\n- [ ] New block files follow the structure above\n- [ ] Block registered in `template-composer.ts`\n- [ ] Tests added / passing (`npm test`)\n- [ ] No TypeScript errors (`npm run lint`)\n\n---\n\n## License\n\nMIT © [victor198siete](https://github.com/victor198siete)\n","readmeFilename":"README.md","_rev":"1-1efdbad1389aa35c88c7bb5520f6c6c4"}