{"_id":"@1yian/apa","_rev":"10-a2ce43deec6b9d46aa8a8607dca6b4b0","name":"@1yian/apa","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"@1yian/apa","version":"1.0.0","keywords":["claude","claude-code","apa","agent","planning","architecture"],"license":"MIT","_id":"@1yian/apa@1.0.0","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/yian/plan-a#readme","bugs":{"url":"https://github.com/yian/plan-a/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"9ca6b6d0a38781daa249064a358728fe84390d4a","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.0.0.tgz","fileCount":21,"integrity":"sha512-WbvdtwuVrLHR78BustU9yHm9Ac9IVBeQBv6J55KTGL+pW1jD4u18rq1dNJ0Jrlw9XzDZhaxpPB3DxHimIpXjCw==","signatures":[{"sig":"MEUCICeDMjrn1G7khcebxWk4PcXSANuqGFFPxFbx1DJ6SNMmAiEA0nsqXGPClNldBM4BpP0SOXCgsqZAly/h4eHoCdhvJaQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":143349},"engines":{"node":">=14.0.0"},"gitHead":"c9479e3120c4da4e49ce2b2363062b3e8f0ca7f7","_npmUser":{"name":"1yian","email":"ywong227@gmail.com"},"repository":{"url":"git+https://github.com/yian/plan-a.git","type":"git"},"_npmVersion":"11.6.2","description":"APA (Agent Planning Architecture) for Claude Code","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.0.0_1768591926026_0.784446605698474","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@1yian/apa","version":"1.0.1","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.0.1","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"5fe7df8bdf39f77752ca281cac0609e12d8a03fd","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.0.1.tgz","fileCount":22,"integrity":"sha512-MxYzgoAITcnmC55aT07RjmYzQ5qXLg3K0+l8g0XcagWl3wBf0Yw0s+TFuYHsQyCRBucdO2mrdeoKPAwY744mxQ==","signatures":[{"sig":"MEUCIAKITpFP7Lkn2Ie+uuSEXSJGlXYaYo6/8e1q/VIoyxYgAiEAyInphF7+uwluaQ7nXWq0tw/1Sfe/2wANQ75WuYrF7gk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":144996},"engines":{"node":">=14.0.0"},"gitHead":"4671f9815ae142248bf2a1384536ef917deeaf4a","_npmUser":{"name":"1yian","email":"ywong227@gmail.com"},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.6.2","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.0.1_1768592680669_0.3793272254264959","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@1yian/apa","version":"1.0.2","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.0.2","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"dc5a90547d64a198f4b154f317f4e5ed7c1e01c4","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.0.2.tgz","fileCount":22,"integrity":"sha512-VTvcOH6LLFTOjd35XYeBPP0+w18hHF2lLrvSz2zjA+3dGZ927XXvt+mZJ3XjSRoR5ksuMY+9+jwFn3zw9oW3uw==","signatures":[{"sig":"MEYCIQCsvxmj9AroZxRfo2FiPjNZcfn5rMmzG/BGmZinK1zbYQIhAOFpMCThD+ANvWKgEaa/Kby9Lt6uvl0UH7ZV4PHNsfiB","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148109},"engines":{"node":">=14.0.0"},"gitHead":"35514fcf5cac7e4fede2968879a839f92d86137e","_npmUser":{"name":"1yian","email":"ywong227@gmail.com"},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.6.2","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.0.2_1768593708645_0.5999190310877884","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@1yian/apa","version":"1.0.3","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.0.3","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"70abad62a325b49dc9b2991e8ab26ebb91a6ec5e","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.0.3.tgz","fileCount":22,"integrity":"sha512-T55qtzSNrIhd99Rm3TJzfz8d5icnf2ZtSFHE1PSFHcDBdMwbyA7cJrZ7ForkC+Adyc3HFQ+UmCsK+mZwJbNbuQ==","signatures":[{"sig":"MEUCID7bYv87yIhJysKrFeqe3LqQIJG2fYpfXW0icauffzEHAiEAgKypn+ZLCcST0iqmEvqet/naRx+45bQoJb5chKhc7ew=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148136},"engines":{"node":">=14.0.0"},"gitHead":"42a0cebdf90e5fb271b662613fa1065705593376","_npmUser":{"name":"1yian","email":"ywong227@gmail.com"},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.6.2","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.0.3_1768594205107_0.7690785782894229","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@1yian/apa","version":"1.1.0","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.1.0","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"77b8ad1e2217aecb1a0c8df0b272a4357a290485","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.1.0.tgz","fileCount":22,"integrity":"sha512-gvGzJzGnisErh0QrsyyK9pATlIfO9h9un4bduGGjkwV4+qy8SIRN15KV7+2GiRHK3gdrW3BgAQYTLxptAxS81A==","signatures":[{"sig":"MEUCIQCmw37QQ0G/SF6/c039LhJ1B22GS7m5razbpDY/SA3kYwIgbh5n0K4nQQFnBVxOB0XjhYnLETnDeSJnwZQUuKfCUPI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":148090},"engines":{"node":">=14.0.0"},"gitHead":"7267ddf3ad23acfd6972ca276d6f18f582404aab","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.7.0","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.1.0_1768849191991_0.8081302640263834","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@1yian/apa","version":"1.2.0","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.2.0","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"6614456622a825b967742285844dbe31dc03373a","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.2.0.tgz","fileCount":25,"integrity":"sha512-9jetuVzvUypPd4QYNIdtJ7Z+fy9387CDct6LXd+XNYcNZOBdvk2EuvrAHBZbLpLaTLxXEDBQ+5aw0gEPS1cYxQ==","signatures":[{"sig":"MEQCIC9VyFgMklb7KtsJnW2lYNKtnYErUNEADNQ6eaTFwvDKAiAWhOnICVFdf/xHNF1xAntSoa5SDudvHnQtKJ7n0ddKrQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":168892},"engines":{"node":">=14.0.0"},"gitHead":"ab29581e19f1abbd35bc718d955d5350a33319ec","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.7.0","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.2.0_1768882329612_0.4159244096805699","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@1yian/apa","version":"1.3.0","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.3.0","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"547c0e55b9ae614b7ea65e81e1be4ffb71f02802","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.3.0.tgz","fileCount":27,"integrity":"sha512-/z4TaGajWc55F5BYQi/NC2flQKhZ9PZICvXyG2cV8U98M5nKXJy9H7KEqGMkAq0e800yVEeW3dTr5uUkqRQRRg==","signatures":[{"sig":"MEUCIF846WgRFhcrIWuvK3KLsGXfOXMNXtHZ+eHEbrzdN9ceAiEAujSmLbevE7zx4B85YP/QR7hVEw55gPJi+0wziZL4pP0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":194153},"engines":{"node":">=14.0.0"},"gitHead":"9815d8c38b8edd6fa17060eae72029f9a7c23630","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.7.0","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.3.0_1769011932096_0.27592609791069656","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@1yian/apa","version":"1.3.1","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.3.1","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"751d904b300049768170b0b9157eb482a615b8bd","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.3.1.tgz","fileCount":27,"integrity":"sha512-MlasAxSVcRM6w8fBWpyiZYvAQBknfveqFUvU2gI12f8n2dThfjGE27kZdIXK97hq0PrprYFYyCVGVu9KGn+X7g==","signatures":[{"sig":"MEYCIQDjEstLICpcV4RHBCKSjB5T35Y+8ms6z4x1O60SrKDp9AIhANSnUwURgnIs7vd9j9LHM5j1CC9gtKu+YNz9MHcLNNil","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@1.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":199222},"engines":{"node":">=14.0.0"},"gitHead":"1fac0243889d759c51ca64187083e94c0cf9be72","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.8.0","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.3.1_1769097832422_0.17804445402970348","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@1yian/apa","version":"1.4.0","keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","_id":"@1yian/apa@1.4.0","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"homepage":"https://github.com/1yian/apa#readme","bugs":{"url":"https://github.com/1yian/apa/issues"},"bin":{"apa":"bin/apa.js"},"dist":{"shasum":"638275d05c25458e8ca7ca8e7bb41fb6bd6f49c8","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-1.4.0.tgz","fileCount":32,"integrity":"sha512-wisR3tCzFsyyfQovNxSkKOiaaKTQ7mSr78RR8zY3E/b16IoSG9tetF/DXDjkLPlykRnPut8czDw3XGplVt5/iA==","signatures":[{"sig":"MEUCIB6XZG7FCb6CGow55VjHDQjx7BHuESgwUFoACYnNva4EAiEA/b4aBarM6e7mVwoFOkIBwdH1cMGgcIt/vATDdDEbvB0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":275611},"engines":{"node":">=14.0.0"},"gitHead":"df3b3c972b6bb2cd33a8ddc4cc636b66120cbf74","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"repository":{"url":"git+https://github.com/1yian/apa.git","type":"git"},"_npmVersion":"11.8.0","description":"ALWAYS PLAN AHEAD!","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apa_1.4.0_1769099342174_0.8803876521695291","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@1yian/apa","publishConfig":{"access":"public"},"version":"2.0.0","description":"ALWAYS PLAN AHEAD!","bin":{"apa":"bin/apa.js"},"keywords":["claude","claude-code","planning","multi-agent"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/1yian/apa.git"},"engines":{"node":">=14.0.0"},"gitHead":"ab6eeff3425b1d8b516101633127b22fc24af5b3","_id":"@1yian/apa@2.0.0","bugs":{"url":"https://github.com/1yian/apa/issues"},"homepage":"https://github.com/1yian/apa#readme","_nodeVersion":"24.12.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-Yu6rbNWxnCb+Ci7wISdJ0GUWgWldbCYdFQshobFxhg2C2UyFzYF6eaJNN3WYFLP7nUNnV2mlnu7cdIqYp+DVGA==","shasum":"79878eb957cc1b06d47cbaa4eff0c82a86e0cdfd","tarball":"https://registry.npmjs.org/@1yian/apa/-/apa-2.0.0.tgz","fileCount":32,"unpackedSize":275654,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1yian%2fapa@2.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDHcU4SjaYsoZQlMgc/ZKNFUeF/RsTjHhf8gUa6+QP0FwIgHmBIcxodeoq9uS8dSgeFoskh+wQMpz7fyFR66ExpvHE="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d18a6a18-07b7-4d99-bc83-6505b79ec9b7"}},"directories":{},"maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/apa_2.0.0_1769099957087_0.0656500543465417"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-16T19:32:05.872Z","modified":"2026-01-22T16:39:17.468Z","1.0.0":"2026-01-16T19:32:06.185Z","1.0.1":"2026-01-16T19:44:40.829Z","1.0.2":"2026-01-16T20:01:48.789Z","1.0.3":"2026-01-16T20:10:05.325Z","1.1.0":"2026-01-19T18:59:52.150Z","1.2.0":"2026-01-20T04:12:09.785Z","1.3.0":"2026-01-21T16:12:12.281Z","1.3.1":"2026-01-22T16:03:52.566Z","1.4.0":"2026-01-22T16:29:02.319Z","2.0.0":"2026-01-22T16:39:17.235Z"},"bugs":{"url":"https://github.com/1yian/apa/issues"},"license":"MIT","homepage":"https://github.com/1yian/apa#readme","keywords":["claude","claude-code","planning","multi-agent"],"repository":{"type":"git","url":"git+https://github.com/1yian/apa.git"},"description":"ALWAYS PLAN AHEAD!","maintainers":[{"name":"1yian","email":"ywong227@gmail.com"}],"readme":"# Always Plan Ahead (APA)\n\n*Manage complex projects with a team of AI assistants, smoothly and efficiently.*\n\n## What is APA?\n\n**Always Plan Ahead (APA)** is fork of [APM](https://github.com/sdi2200262/agentic-project-management) that brings real-world project management principles into your AI-assisted workflows. \n\nIt is built on addresses a fundamental challenge of LLMs: **context window limitations** by transforming Claude Code from an implementor to an orchestrator of implementation subagents and by enforcing a persistent memory system.\nThis frees up context usage in your Claude session, allowing for longer sessions that accomplish more at a higher quality.\n\n## Installation\n\nInstall APM CLI globally via NPM:\n\n```bash\nnpm install -g @1yian/apa\n```\n\nOr install locally in your project:\n\n```bash\nnpm install @1yian/apa\n```\n\nWhen you run `apm init`, simply select your AI assistant from the list, and APM will automatically configure the appropriate command structure for your environment.\n\n</details>\n\n## Getting Started\n\nFollow these simple steps to start using APM in your project:\n\n1. **Navigate to your project directory** in your terminal.\n\n2. **Run the APA initialization command in your repo:**\n   ```bash\n   apa init .\n   ```\n\n3. **APM automatically installs:**\n   - `.apa/` directory with APM guides and initial assets\n   - APM slash commands in your Claude's local command directory\n   - Necessary installation meta-data\n\n5. **Open your AI assistant chat** and enter the slash command:\n   ```\n   /apa.init\n   ```\n\n6. **Follow the established APA workflow:**\n\n   **Traditional Workflow:**\n   ```\n   /apa.init → /apa.plan → /apa.implement\n   ```\n\n   **Specification-Driven Workflow (New):**\n   ```\n   /apa.init → /apa.specify → /apa.plan → /apa.implement\n   ```\n\n   **Full Workflow with Constitution (Recommended for Complex Projects):**\n   ```\n   /apa.init → /apa.constitution → /apa.specify → /apa.plan → /apa.implement\n   ```\n\n## Features\n\n### 🎯 Specification-Driven Development\n\nAPA now supports optional specification-driven workflow adapted from [GitHub Spec-Kit](https://github.com/github/spec-kit):\n\n- **`/apa.specify`**: Create structured feature specifications with prioritized user stories, acceptance criteria, and measurable success criteria\n- **`/apa.constitution`**: Establish project principles, quality standards, and technical constraints\n- **Research Phase**: Explicit investigation and documentation before implementation\n- **Living Documents**: Specifications and plans evolve during implementation\n\n**When to use:**\n- ✅ Complex features requiring detailed requirements\n- ✅ Brownfield projects needing documentation of existing systems\n- ✅ Projects with multiple stakeholders requiring alignment\n- ✅ Features with unclear scope benefiting from structured analysis\n\n**When to skip:**\n- ⚠️ Simple, well-defined features (go directly to `/apa.plan`)\n- ⚠️ Personal projects or prototypes\n\n### 🤖 Multi-Agent Orchestration\n\n- **Manager Agent**: Orchestrates implementation subagents and coordinates task execution\n- **Implementation Agents**: Execute individual tasks with focused context\n- **Persistent Memory**: Session summaries and research findings preserved across sessions\n- **Adaptive Planning**: Plans evolve based on discoveries during implementation\n\n### 📋 Structured Planning\n\n- **Context Synthesis**: Structured requirements gathering through question rounds\n- **Project Breakdown**: Phases and tasks with dependencies and guidance\n- **Constitution Compliance**: Validate plans against project principles\n- **Discovery-Driven**: Exploratory phases for brownfield and uncertain work\n\n## Workflow Comparison\n\n| Feature | Traditional APA | Specification-Driven |\n|---------|----------------|---------------------|\n| **Requirements** | Gathered in Context Synthesis | Structured specification created first |\n| **User Stories** | Implicit in planning | Explicit, prioritized (P1, P2, P3) |\n| **Success Criteria** | Defined during planning | Measurable, technology-agnostic |\n| **Brownfield Support** | Discovery during implementation | \"As-is\" and \"to-be\" documented upfront |\n| **Constitution** | Optional template | Integrated with compliance validation |\n| **Research** | Ad-hoc during tasks | Explicit Phase 0 with documentation |\n| **Best For** | Simple, well-defined features | Complex features, brownfield, stakeholder alignment |\n\n## Commands\n\n### Core Commands\n\n- **`/apa.init`**: Initialize APA session\n- **`/apa.plan`**: Create implementation plan through Context Synthesis and Project Breakdown\n- **`/apa.implement`**: Execute implementation plan with Manager-Agent orchestration\n- **`/apa.status`**: Check current session status\n- **`/apa.resume`**: Resume paused session\n- **`/apa.reassess`**: Strategic replanning when major discoveries invalidate plan\n\n### Specification-Driven Commands (New)\n\n- **`/apa.constitution`**: Establish project principles and quality standards\n- **`/apa.specify`**: Create structured feature specification from natural language\n\n## Documentation\n\n### Guides\n\n- **[Specification-Driven Workflow](dot-apa/guides/specification-driven-workflow.md)**: Complete guide to using specification-driven development in APA\n- **[Living Plan Philosophy](dot-apa/guides/living-plan-philosophy.md)**: How plans evolve during implementation\n- **[Research Phase Guide](dot-apa/guides/research-phase-guide.md)**: Structuring investigation and documentation\n- **[Context Synthesis Guide](dot-apa/guides/context-synthesis-guide.md)**: Requirements gathering methodology\n- **[Project Breakdown Guide](dot-apa/guides/project-breakdown-guide.md)**: Task breakdown methodology\n- **[Manager Guide](dot-apa/guides/manager-guide.md)**: Manager agent orchestration\n- **[Memory System Guide](dot-apa/guides/memory-system-guide.md)**: Persistent memory and session summaries\n\n### Templates\n\n- **[Specification Template](dot-apa/specification-template.md)**: Structured feature specification\n- **[Constitution Template](dot-apa/constitution-template.md)**: Project principles and standards\n- **[Implementation Plan Template](dot-apa/implementation-plan-template.md)**: Task breakdown structure\n\n## Example: Specification-Driven Workflow\n\n### Scenario: Adding OAuth2 to Existing App\n\n```bash\n# 1. Initialize session\n/apa.init\n\n# 2. Establish project principles (optional)\n/apa.constitution Create constitution focused on security, testing, and backward compatibility\n\n# 3. Create feature specification\n/apa.specify Add OAuth2 authentication to existing JWT-based auth system. Support Google and GitHub providers. Existing users should be able to link OAuth2 accounts.\n\n# 4. Create implementation plan (uses specification as input)\n/apa.plan\n\n# 5. Execute implementation\n/apa.implement\n```\n\n**What you get:**\n\n- **Constitution** (`apa/[branch]/constitution.md`):\n  - Security-first principle\n  - Test-first requirement\n  - Backward compatibility constraint\n\n- **Specification** (`apa/[branch]/specification.md`):\n  - Current State: JWT-based auth documented\n  - User Story 1 (P1): New users can sign up with OAuth2\n  - User Story 2 (P1): Existing users can link OAuth2 accounts\n  - Success Criteria: 90% of new users choose OAuth2\n\n- **Implementation Plan** (`apa/[branch]/implementation-plan.md`):\n  - Phase 0: OAuth2 Integration Research\n  - Phase 1: OAuth2 Core Implementation\n  - Phase 2: Migration & Testing\n  - Constitution compliance validated\n\n- **Research Findings** (`apa/[branch]/research.md`):\n  - Current auth system analysis\n  - OAuth2 library recommendation\n  - Migration strategy\n\n## Credits\n\nAPA is a fork of [APM](https://github.com/sdi2200262/agentic-project-management) by [@sdi2200262](https://github.com/sdi2200262).\n\nSpecification-driven workflow adapted from [GitHub Spec-Kit](https://github.com/github/spec-kit) by [@github](https://github.com/github).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}