{"_id":"@adobe-thillai/aio-cli-plugin-ccma","_rev":"7-77189d90a0b5b5160dbb1139ef3c3d4b","name":"@adobe-thillai/aio-cli-plugin-ccma","dist-tags":{"latest":"2.0.3"},"versions":{"1.0.0":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"1.0.0","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@1.0.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"2e8e1e50e481b9e0b3499a0f4abe2cb570afc95b","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-1.0.0.tgz","fileCount":83,"integrity":"sha512-lma3TiB0u2URpbRv1N5/emPMiDSsh4gLryWvo6Mf88FkFH76RhD/8bks88B6pDHKkynGNiu6KApvMWAqVL9KKA==","signatures":[{"sig":"MEUCIFi2AuEWTdUQES/lPSwwMz5/U/FRCUwU6xNq13EigfY3AiEAs/g00Il4+CDKIysLWftgurujlzBR0clJUiurp8i+2A0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":468546},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"7b1f7aadd31359c3e7a73da9874132f65ab130c1","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_1.0.0_1785678055892_0.10374148693989538","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"1.1.0","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@1.1.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"a0bcd00e6c2fc3805a3217f746fb0e0cc3f7798b","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-1.1.0.tgz","fileCount":84,"integrity":"sha512-wxD6extGnIEuZGK5w7j5NL0W83HyELmR+QvcVI/hQ4/6zmVlVVMksWYxQ3INH+ijBLb7qpXEsP4NcNBWUm8oNw==","signatures":[{"sig":"MEYCIQDVJJLjjRiglRRnxLLVTnMB7A7poLwW2QVal3GqwWta/gIhAJ9DQ2dAYdZjjreyHUXIvT8oMfZsk0elawXUxbnFpX7+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":474691},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"934c3193e382fc4e8d3a3e2c7cff59d7189073a2","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_1.1.0_1785922969475_0.18804523146801633","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"1.2.0","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@1.2.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"abb8fb9f145fb895826412c517a0f41962c14830","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-1.2.0.tgz","fileCount":88,"integrity":"sha512-FC8sR60/6iYCUWfzK8t2hjblam7U4nMgZfanavEDWcI8TKGhHjRpvxKIWyZ+ya1jEKSxfbz1yZbF2XGHkgnx9g==","signatures":[{"sig":"MEUCIQCwWZ1RXhVbbhm2nZxXIKZcy2RwuLDBDria2Q/Ye7ullAIgRC7bLbcapMo6wUb0uXSVR2IDDPiKEEw5bs6Dc4mJs2I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":493138},"oclif":{"bin":"aio","topics":{"ccma":{"description":"Adobe App Builder AI Toolkit — install and manage Claude Code SDLC workflows in an App Builder project"},"ccma mcp":{"description":"Wire and verify MCP servers used by the App Builder AI Toolkit"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"1b9a81a77f8db62c847bd80e412437a2e6e8ecf7","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.0.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_1.2.0_1787650293329_0.810366750837902","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"2.0.0","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@2.0.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"957b80c7107b0f1f711073d4b75ad808d460e16e","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-2.0.0.tgz","fileCount":165,"integrity":"sha512-Pvtl7PMLYGZtzx4HLs6JnWPITPIqSRIH6BGxQiwBOG1Zr1TnAhcwQmlGMOHsO4DLTlriofMcb4XQbcuVOtiW6Q==","signatures":[{"sig":"MEYCIQCV33H+O/LO/4SjY5/nVlAKGDoBbZiWhP530lUvqPcdlQIhAKvmvxHMjgrA4KPxo0aCATelA/JLkZXjQNgZlX7nJIQ7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2165930},"oclif":{"bin":"aio","topics":{"ccma":{"description":"Adobe App Builder AI Toolkit — install and manage Claude Code SDLC workflows in an App Builder project"},"ccma mcp":{"description":"Wire and verify MCP servers used by the App Builder AI Toolkit"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"efb30bf14869b6a7eb96dad7b4af8f9eecb63857","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"js-yaml":"^3.14.1","fs-extra":"^11.0.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_2.0.0_1789117913838_0.8048942600704927","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"2.0.1","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@2.0.1","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"f237872a6b4b78576aee769cb469f2ca431d5885","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-2.0.1.tgz","fileCount":161,"integrity":"sha512-MhMCQfZycdykfL/8kvTU6ioWRXj2gvnO4RwDl+Slq/8OUo6L/e7V0QEs3ujehZRMSwaB3vKIeuKQk9uS9pbRew==","signatures":[{"sig":"MEYCIQCeHhZutLKdA2fh2hd+h+FqF3LyIO3MOBIdujeuEdUnpgIhAI/+be2zFWgVSYIqr0VycoCzb/TyM0m0ckrxPqZ0mG5x","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2154010},"oclif":{"bin":"aio","topics":{"ccma":{"description":"Adobe App Builder AI Toolkit — install and manage Claude Code SDLC workflows in an App Builder project"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"bcdfc94deba5a1381f4adaac8f3b91ce621ce4e3","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"js-yaml":"^3.14.1","fs-extra":"^11.0.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_2.0.1_1789120144793_0.12912713718202995","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"2.0.2","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","_id":"@adobe-thillai/aio-cli-plugin-ccma@2.0.2","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccma#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"dist":{"shasum":"d623770d9f22c2db3a28792194f0b432a76dbf9d","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-2.0.2.tgz","fileCount":167,"integrity":"sha512-eRV51ca+RrTe8Je64e0Dxt3MoOGQ0Ga15wPP9Qvmniem6Mh2Tganj/OQV/NKw6jn3aRw9uPIY7aR1O9B6IA9+A==","signatures":[{"sig":"MEUCIQCBeOa56cldR8plQGPqZREByxsDQDKnSrxDQ8Z6ZbR8lAIgPgbCUHVKHId9fP/iNQRZVHXrjbbDuQ+xAwtPZcjp3v4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2175221},"oclif":{"bin":"aio","topics":{"ccma":{"description":"Adobe App Builder AI Toolkit — install and manage Claude Code SDLC workflows in an App Builder project"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"12b3c7f018fca3b7cae6e3b4f0d494cc3534f640","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:developer":"node scripts/setup-project.mjs --role developer"},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccma.git","type":"git"},"_npmVersion":"10.9.2","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"js-yaml":"^3.14.1","fs-extra":"^11.0.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccma_2.0.2_1789134107001_0.4860816949579858","host":"s3://npm-registry-packages-npm-production"}},"2.0.3":{"name":"@adobe-thillai/aio-cli-plugin-ccma","version":"2.0.3","description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project . --role full","setup:project:lead":"node scripts/setup-project.mjs --role lead","setup:project:developer":"node scripts/setup-project.mjs --role developer","generate:github":"node scripts/generate-github-assets.mjs"},"oclif":{"bin":"aio","commands":"./src/commands","topics":{"ccma":{"description":"Adobe App Builder AI Toolkit — install and manage Claude Code or GitHub Copilot SDLC workflows in an App Builder project"},"ccma mcp":{"description":"Wire and verify MCP servers used by the App Builder AI Toolkit"},"ccma agent":{"description":"Choose and install the agent toolkit flavour (ClaudeCode or GitHub Copilot)"}}},"keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools","github-copilot"],"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+ssh://git@github.com/OneAdobe/project-ccma.git"},"bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"homepage":"https://github.com/OneAdobe/project-ccma#readme","engines":{"node":">=18.0.0"},"dependencies":{"@oclif/core":"^3.26.0","fs-extra":"^11.0.0","js-yaml":"^4.3.2"},"_id":"@adobe-thillai/aio-cli-plugin-ccma@2.0.3","gitHead":"b09e6a4d19524e4368303255462cffc95179ba1f","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Hp2WRcgHaS4ROLFoQZjR6QhWtmyd64VXgSavHbrUVkMo9dffF819aUWFqKq2DsBrlDkZfXtIOJLWVkyRDPBrMA==","shasum":"6cc858456988ba5c81be924432455025b3320613","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccma/-/aio-cli-plugin-ccma-2.0.3.tgz","fileCount":254,"unpackedSize":2657133,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIE5zqpdDiQAs82bhAdXO5bXf82Y6LMEXJQZTdl7VjYSGAiEAiqE80tvlGUW2PXOhEiYeem7LBWBxJdOEKLy1IacADtA="}]},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"directories":{},"maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aio-cli-plugin-ccma_2.0.3_1789644432699_0.57854076451148"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-02T13:40:55.627Z","modified":"2026-09-17T11:27:13.034Z","1.0.0":"2026-08-02T13:40:56.052Z","1.1.0":"2026-08-05T09:42:49.665Z","1.2.0":"2026-08-25T09:31:33.480Z","2.0.0":"2026-09-11T09:11:54.064Z","2.0.1":"2026-09-11T09:49:04.985Z","2.0.2":"2026-09-11T13:41:47.166Z","2.0.3":"2026-09-17T11:27:12.850Z"},"bugs":{"url":"https://github.com/OneAdobe/project-ccma/issues"},"author":{"name":"Thillai Prabu"},"license":"Apache-2.0","homepage":"https://github.com/OneAdobe/project-ccma#readme","keywords":["adobe-app-builder","claude-code","mcp","sdlc","adobe-io-runtime","commerce-migration","ai-tools","github-copilot"],"repository":{"type":"git","url":"git+ssh://git@github.com/OneAdobe/project-ccma.git"},"description":"Phase-gated SDLC commands, specialist agents, guardrails, and domain knowledge for Adobe App Builder development in Claude Code.","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"readme":"# Adobe App Builder AI Toolkit (Claude Code)\n\nPhase-gated SDLC for Adobe App Builder development — greenfield apps and Commerce → App Builder migrations — powered by Claude Code.\n\nExtracted from [commerce-compass](https://github.com/OneAdobe) as a standalone tool, so App Builder\nworkflows can be installed, versioned, and developed independently of general Commerce\nmodule-development tooling.\n\n---\n\n## Quick Reference\n\n| Task | Command |\n|---|---|\n| Start session / switch requirement | `/appbuilder-init` |\n| Create a new requirement | `/new-requirement <name>` |\n| Check phase status (all requirements) | `/appbuilder-status` |\n| New feature (full workflow) | `/dev-action <description>` |\n| Scaffold a runtime action | `/action-create <name> <type>` |\n| Scaffold a UI extension | `/ui-extension-create <extension-point> <label>` |\n| Scaffold API Mesh | `/mesh-create <description>` |\n| Commerce → App Builder migration plan | `/appbuilder-migrate` |\n| Migration effort estimate | `/appbuilder-estimate` |\n| Live Adobe docs lookup | `/appbuilder-docs <topic>` |\n| Validate structure | `/appbuilder-validate-quick` |\n| Pre-commit check | `/review-before-commit` |\n| Full PR review | `/review` |\n| Pre-deploy validation | `/deploy-check [Stage\\|Production]` |\n| Configure workspace | `/workspace-setup [Stage\\|Production]` |\n| Project health & tech debt | `/tech-debt-triage` |\n\n### Phase Commands (role-gated)\n| Command | Role | Purpose |\n|---|---|---|\n| `/phase1` | Architect, Lead | Requirements & architecture |\n| `/phase2` | Architect, Lead | Scaffold project structure |\n| `/phase3` | Developer, Lead | Implement actions & extensions |\n| `/phase4` | Developer, Lead | Test, validate, deploy to Stage |\n\n---\n\n## How It Works\n\nThe toolkit enforces a phase-gated SDLC. Each phase has clear ownership, gates,\nand deliverables. No phase skipping. No code before requirements are signed off.\n\n```\nPhase 0 — Environment      /appbuilder-init\nPhase 1 — Requirements     /phase1   (Architect/Lead)\nPhase 2 — Scaffold         /phase2   (Architect/Lead)\nPhase 3 — Implement        /phase3   (Developer)\nPhase 4 — Deploy to Stage  /phase4   (Developer)\n```\n\nEach requirement (e.g. `loyalty-app`, `order-sync`) lives in its own directory with a `REQUIREMENTS.md` and per-requirement `.phase-state.json`. A single App Builder project can track multiple requirements independently.\n\n```\nproject-root/\n├── loyalty-app/REQUIREMENTS.md   ← requirement spec + phase markers\n├── order-sync/REQUIREMENTS.md\n├── .claude/active-requirement    ← which requirement is being worked on\n├── app.config.yaml               ← shared App Builder config\n└── actions/                      ← shared runtime actions\n```\n\nPhase state is persisted in `<req-dir>/.phase-state.json`.\n\n---\n\n## Project Types\n\n**Greenfield** (`APPBUILDER_PROJECT_TYPE=greenfield`)\nBuilding a new App Builder app from scratch. Follows Phase 0 → 4.\n\n**Migration** (`APPBUILDER_PROJECT_TYPE=migration`)\nMoving existing Commerce custom modules to App Builder. Adds:\n- `/migration-approach` — choose full ACCS/SaaS migration vs a lighter PaaS + App Builder extension\n- `/appbuilder-migrate` — analyse Commerce modules, produce `MIGRATION_PLAN.md`\n- `/appbuilder-estimate` — effort estimation report with complexity tiers and risk multipliers\n- `/accs-workstream-hop-plan` — break the workstream plan into 5 trackable hops\n- `/accs-workstream-hop-execute <hop>` — execute one hop with gated, per-component tracking\n\n---\n\n## Setup\n\n### Prerequisites\n\n```bash\nnode >= 18\nnpm install -g @adobe/aio-cli\naio login\n```\n\n### Recommended install sequence\n\n1. **Install or update the plugin**\n\n   ```bash\n   aio plugins:install @adobe-thillai/aio-cli-plugin-ccma\n   # or, if already installed\n   aio plugins:update @adobe-thillai/aio-cli-plugin-ccma\n   ```\n\n2. **Select the agent toolkit for your App Builder project**\n\n   Use the interactive picker when you want to choose between **Claude Code** and\n   **GitHub Copilot** during setup:\n\n   ```bash\n   aio ccma:agent:select --project /path/to/your/app-builder-project --role full --type greenfield\n   # Which agent toolkit would you like to install into this project?\n   #   1. ClaudeCode\n   #   2. GitHub Copilot\n   ```\n\n   `ccma:agent:select` accepts the same `--project`, `--role`, and `--type` flags as\n   `ccma:setup`, plus `--agent claude-code|github-copilot` to skip the prompt.\n\n3. **Run toolkit setup directly when you already know the target agent**\n\n   `ccma:setup` installs the selected toolkit into the target project. By default it installs\n   the **Claude Code** flavour (`.claude/*`). To install the **GitHub Copilot** flavour instead\n   (`.github/agents`, `.github/skills`, `.github/prompts`, `.github/instructions`,\n   `.github/hooks`, `.github/copilot-instructions.md`), pass `--agent github-copilot`.\n\n   ```bash\n   aio ccma:setup --project /path/to/your/app-builder-project --role full --type greenfield\n   aio ccma:setup --agent github-copilot --project /path/to/your/app-builder-project\n   ```\n\n   This copies the toolkit assets into the target project and, for Claude Code installs,\n   also wires the CodeGraph, FluffyJaws, and commerce-extensibility-tools MCP servers.\n\nRoles:\n- `full` — all commands and agents (Architect)\n- `lead` — Phase 2/3/4 commands (Lead Developer)\n- `developer` — Phase 3/4 + daily workflow commands (Developer)\n\nTypes:\n- `greenfield` — building a new App Builder app from scratch\n- `migration` — moving existing Commerce custom modules to App Builder\n\n### Tool setup / MCP re-verification\n\nWire (or re-verify) just the commerce-extensibility-tools MCP server:\n\n```bash\naio ccma:mcp:setup --project /path/to/your/app-builder-project\n```\n\nThe `.github/*` tree is generated from the `.claude/*` source of truth by\n`scripts/generate-github-assets.mjs` (see `npm run generate:github`), following the block-by-block\nmapping: agents → `.agent.md`, skills → `<name>/SKILL.md` (unchanged format), simple commands →\n`.prompt.md`, phase-gated/multi-step commands → skills, guardrails → `.instructions.md` with\n`applyTo` scoping, and the phase-gate hook → a JSON wrapper around the same script. MCP wiring\n(commerce-extensibility-tools, CodeGraph, FluffyJaws) is currently Claude Code only — wire those\nmanually via VS Code's MCP settings for GitHub Copilot projects.\n\n### Environment Variables\n\nCreate `.env` in your App Builder project root:\n```bash\nAIO_runtime_namespace=<your-namespace>\nAIO_runtime_auth=<your-auth-key>\nSERVICE_API_KEY=<oauth-s2s-client-id>\nSERVICE_API_SECRET=<oauth-s2s-client-secret>\nCOMMERCE_BASE_URL=https://your-commerce-store.example.com\nCOMMERCE_ACCESS_TOKEN=<integration-token>\nCOMMERCE_WEBHOOKS_PRIVATE_KEY=<hmac-key-if-using-webhooks>\nLOG_LEVEL=info\n```\n\n**Never commit `.env` to git.** It is automatically added to `.gitignore` by the setup script.\n\n---\n\n## Git Branching Strategy\n\nThis repository follows the branch model defined in the toolkit coding standards:\n\n- `main` — protected, production-ready history only\n- `develop` — integration branch and default PR target for feature work\n- `feature/<ticket-id>-<description>` — cut from `develop`, merged back into `develop`\n- `release/<version>` — cut from `develop` to stabilize a release, then merged to `main` and back to `develop`\n- `hotfix/<ticket-id>-<description>` — cut from `main` for urgent production fixes, then merged to `main` and back to `develop`\n- Tags: `v<major>.<minor>.<patch>` from `main` before Production deploys\n\nIn practice:\n\n1. Start feature work from `develop`\n2. Open feature PRs against `develop`\n3. Promote to `main` only through release or hotfix branches after CI passes\n\nSee `CONTRIBUTING.md` for the contributor flow.\n\n---\n\n## Slash Commands\n\n### Core Workflow\n- **`/appbuilder-init`** — Session start. Detects environment, displays phase dashboard.\n- **`/appbuilder-status`** — Current phase and next action.\n- **`/appbuilder-docs <topic>`** — Live Adobe docs lookup (WebSearch).\n\n### Development\n- **`/dev-action <description>`** — Orchestrator: architect design → implementation → security review → tests.\n- **`/action-create <name> [type]`** — Scaffold one runtime action. Types: webhook, event-handler, api-proxy, scheduled.\n- **`/ui-extension-create <point> <label>`** — Scaffold Admin UI SDK extension.\n- **`/mesh-create <description>`** — Create API Mesh configuration.\n\n### Migration\n- **`/migration-approach`** — Choose full ACCS/SaaS migration vs a lighter PaaS + App Builder extension.\n- **`/appbuilder-migrate`** — Analyse Commerce modules → produce `MIGRATION_PLAN.md`.\n- **`/appbuilder-estimate`** — Effort estimation report (`ESTIMATION_REPORT.md`).\n- **`/accs-workstream-hop-plan`** — Break the workstream plan into 5 trackable hops (`accs-hop-state.md`).\n- **`/accs-workstream-hop-execute <hop>`** — Execute one hop: gated pre-check, per-component dispatch, validation.\n\n### Quality & Review\n- **`/review-before-commit`** — Pre-commit: validate structure, check credentials, review staged changes.\n- **`/review [files]`** — Full PR review with parallel agent checks (architect, security, QA).\n- **`/appbuilder-validate-quick`** — Fast structure + pre-deploy check.\n\n### Deployment\n- **`/deploy-check [Stage|Production]`** — Go/no-go: automated checks + parallel agent review + smoke test checklist.\n- **`/workspace-setup [Stage|Production]`** — Verify aio auth, workspace binding, env vars, services.\n\n### Maintenance\n- **`/tech-debt-triage`** — Full project health check: oversized actions, missing tests, security gaps, dependency audit.\n\n---\n\n## Specialist Agents\n\nInvoked automatically by workflow commands — not called directly.\n\n| Agent | Role |\n|---|---|\n| `appbuilder-architect` | Design, action type selection, migration planning, storage strategy |\n| `appbuilder-developer` | Implementation, action code, event handlers, UI extensions |\n| `appbuilder-security-reviewer` | IMS auth, HMAC verification, credential safety, PII |\n| `appbuilder-qa-engineer` | jest tests, coverage analysis, smoke test checklists |\n| `appbuilder-devops-engineer` | CI/CD pipelines, workspace config, deployment procedures |\n\n---\n\n## Guardrails (Always Active)\n\n| Guardrail | Rule |\n|---|---|\n| `credential-security` | No hardcoded secrets. `.env` only. Workspace secrets for Production. |\n| `locked-core-principle` | Never touch Commerce PHP. Extend via APIs, Events, Webhooks. |\n| `pii-protection` | No PII in logs. IDs only. TTL on customer data in state. |\n| `deployment-safety` | Confirm workspace before deploy. Never auto-deploy to Production. |\n\n---\n\n## Directory Layout (installed into target project)\n\n```\n<your-project>/\n├── CLAUDE.md                    # Loaded on every session — all instructions\n├── REQUIREMENTS.md              # Requirements + phase markers (created by /phase1)\n├── MIGRATION_PLAN.md            # Migration plan (created by /appbuilder-migrate)\n├── app.config.yaml              # App Builder runtime manifest\n├── .env                         # Local credentials (gitignored)\n└── .claude/\n    ├── settings.json            # Permissions + hooks + env vars\n    ├── agents/                  # 5 specialist agents\n    ├── commands/                # 19 slash commands\n    ├── guardrails/              # 4 safety rules (always loaded by agents)\n    ├── skills/                  # 7 reference knowledge files\n    ├── prompts/                 # 4 review templates\n    ├── context/                 # 5 runtime state files (fill in per project)\n    └── hooks/                   # Harness hooks (quality log, phase gate)\n```\n\n---\n\n## Prerequisites for Commerce Integration\n\nBefore the App Builder app can receive Commerce events or webhooks:\n1. Install `adobe/commerce-eventing` (Composer) in Commerce\n2. Configure IMS in Commerce Admin → Stores → Configuration → Adobe Services → Adobe I/O\n3. Connect the App Builder project in Developer Console → your project → Event Provider\n4. For webhooks: install `magento/module-webhook` and configure in Commerce Admin → System → Webhooks\n\n---\n\n## References\n\n- App Builder docs: https://developer.adobe.com/app-builder/docs/\n- Admin UI SDK: https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/\n- Commerce Events: https://developer.adobe.com/commerce/extensibility/events/\n- Commerce Webhooks: https://developer.adobe.com/commerce/extensibility/webhooks/\n- API Mesh: https://developer.adobe.com/graphql-mesh-gateway/\n- aio CLI: https://developer.adobe.com/runtime/docs/guides/tools/cli_install/\n","readmeFilename":"README.md"}