{"_id":"@aldoawp/workflow","_rev":"6-4c02b8f8911241a3daaaaeff9ea4b615","name":"@aldoawp/workflow","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@aldoawp/workflow","version":"1.0.0","keywords":["ai","agents","workflow","copilot","templates"],"author":{"name":"aldoawp"},"license":"MIT","_id":"@aldoawp/workflow@1.0.0","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"homepage":"https://github.com/aldoawp/workflow#readme","bugs":{"url":"https://github.com/aldoawp/workflow/issues"},"dist":{"shasum":"656f83b95bf104159c487ef3339e0a0edcce731f","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.0.tgz","fileCount":56,"integrity":"sha512-MqTpc9x4Pn6dqNz+f4sygwjaSBkQDH+25DlcOBp51K2nzjiHOtUzMndO6LdXkbn4S8fKuNMx2bCy5rgDex2Z2A==","signatures":[{"sig":"MEYCIQCl9bdmgbfHZTSKgQcgrD5ucuoAXnlNsjjf/zOoOc552AIhALPgQxd3DLR28VHtEahqJQ8Wk/BXsgFk2LPw307pq8nS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":319900},"gitHead":"4b28976ee0950c810ab7655901dd1f304d6a15e7","_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"repository":{"url":"git+https://github.com/aldoawp/workflow.git","type":"git"},"_npmVersion":"11.3.0","description":"AI agent workflow configuration — skills, templates, and docs.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/workflow_1.0.0_1779032502235_0.6367199466577669","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aldoawp/workflow","version":"1.0.1","license":"MIT","_id":"@aldoawp/workflow@1.0.1","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"dist":{"shasum":"afd6eb14f916960d1deef406009fdced91a82282","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.1.tgz","fileCount":57,"integrity":"sha512-0j3w0kZN4HfIAC4XM48uFmManTfptpBMzJmYh0ZIeS+4RYuOwa6Io+37u+2auU4T+S8JL2lEVrp3uLFfeuMl6A==","signatures":[{"sig":"MEYCIQDmjOfvmVn4gSVyz8t24ow71CsdebYHu9caB7xv9IqKkgIhAIm570UWHfNGTNisZspEiy25UkwDxEy+hTbDCpsRA9do","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":321277},"gitHead":"f04112907cc98102a244db96f6c9089943f474ab","scripts":{"postinstall":"node postinstall.js"},"_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"_npmVersion":"11.3.0","description":"AI workflow skills, agents, and doc templates","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/workflow_1.0.1_1779034050300_0.02058870265909607","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aldoawp/workflow","version":"1.0.2","license":"MIT","_id":"@aldoawp/workflow@1.0.2","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"dist":{"shasum":"aa788a51e4fc11bf9baf38d63b78d14bfeefa85c","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.2.tgz","fileCount":57,"integrity":"sha512-38Ww2QBz1SQw2BMe56zE+smTIRygi8eqDS4qmI4W8TeA1q3SLa6viJAl0gNh2t9qbUgDyTuknpgln1Wfi43Asw==","signatures":[{"sig":"MEUCIHeI+94SF9mmGHP0qlmjHz9oQQTYETzqBVoROIWbktppAiEAkPDVRkyeVpdVA5cmGzRTmgyg9B/y9imd4m1o5G4aT4U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":321277},"gitHead":"0212b556e674f681a9871a89f3389c5aeafe893a","scripts":{"postinstall":"node postinstall.js"},"_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"_npmVersion":"11.3.0","description":"AI workflow skills, agents, and doc templates","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/workflow_1.0.2_1779034500022_0.3588806005581422","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@aldoawp/workflow","version":"1.0.3","license":"MIT","_id":"@aldoawp/workflow@1.0.3","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"dist":{"shasum":"d83a63cea7a6d45bd96b9a94639b8ab8f97b58cf","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.3.tgz","fileCount":57,"integrity":"sha512-0qLhluOztu1RKu9WMZi5rF2qgK7Tlaw8oAJ3jzuwI22XMoixFPsBzNTJYj7zGPz0boB7+8g89BYpuGOr86TMqw==","signatures":[{"sig":"MEQCIH5XAIYiOEBxcORQpg9KI932sQybB23023kk6/JLyOJJAiA6JWXWtScP6bRvQpbc8vlI1q2Nt8xz0TzIidQ7ygoEOQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":327401},"gitHead":"e395471debd01cc80a57d847ffda1549a419fc1c","scripts":{"postinstall":"node postinstall.js"},"_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"_npmVersion":"11.3.0","description":"AI workflow skills, agents, and doc templates","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/workflow_1.0.3_1779035452764_0.6866233060717191","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@aldoawp/workflow","version":"1.0.4","license":"MIT","_id":"@aldoawp/workflow@1.0.4","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"dist":{"shasum":"3b8aab961f4cf84e05269ea87cf416d629f5d3b1","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.4.tgz","fileCount":58,"integrity":"sha512-wvEVJWoI1LUhbPlD3nE0F/bJ30dcEuDYuCZ0yk0SI8L46mIfgLuvwjloDZNPr7gFjt5baXQS2SBRV0GAaayKgA==","signatures":[{"sig":"MEUCIA0XisRMw9u/Z79PfhrnKQJV1QUi3zv0AjWeGSLfQZ6XAiEAyaLmuoKqhqAg9KkKHEfniiS3kg6f8oPVh+VBcUzXpTk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":331215},"gitHead":"49e95e6bdc24401f207f8248cebed3ae6ce3a76c","scripts":{"postinstall":"node postinstall.js"},"_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"_npmVersion":"11.3.0","description":"AI workflow skills, agents, and doc templates","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/workflow_1.0.4_1779292369896_0.13584947802966196","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@aldoawp/workflow","version":"1.0.5","description":"AI workflow skills, agents, and doc templates","scripts":{"postinstall":"node postinstall.js"},"license":"MIT","_id":"@aldoawp/workflow@1.0.5","gitHead":"b6e85d632875ab65e79770a0e6377c8600533580","_nodeVersion":"22.15.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-p1TETSWIAdCs6IyxAlzyiM0v+uN8mXmTO+F8YuLVy9GzWHNQA5WTa00OFyEWz9WLCXHyvxE4J34NVg6P1kTL2g==","shasum":"622f131793176194321444658d4acb67bd5aa70b","tarball":"https://registry.npmjs.org/@aldoawp/workflow/-/workflow-1.0.5.tgz","fileCount":58,"unpackedSize":331850,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC969MEfwNbCf3Jkr6ouyKryHvq8FYjMjlKFsy4KwZj+QIgZfXJdZNSVaJI0zPaj8cWkoUNyr+2sDaeIR1ya+GGqBA="}]},"_npmUser":{"name":"aldoawp","email":"aristaaldo2@gmail.com"},"directories":{},"maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/workflow_1.0.5_1779338072385_0.8864215400136188"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-17T15:41:42.135Z","modified":"2026-05-21T04:34:32.644Z","1.0.0":"2026-05-17T15:41:42.387Z","1.0.1":"2026-05-17T16:07:30.451Z","1.0.2":"2026-05-17T16:15:00.163Z","1.0.3":"2026-05-17T16:30:52.929Z","1.0.4":"2026-05-20T15:52:50.067Z","1.0.5":"2026-05-21T04:34:32.533Z"},"license":"MIT","description":"AI workflow skills, agents, and doc templates","maintainers":[{"name":"aldoawp","email":"aristaaldo2@gmail.com"}],"readme":"# @aldoawp/workflow\n\n**Spec-Driven Development (SDD)** — a structured, phase-based agentic AI development workflow for VS Code / GitHub Copilot. Ships skills, workflows, and doc templates that guide AI agents from product requirements through design, specification, incremental implementation, review, and integration.\n\n## Installation\n\n```bash\nnpm install @aldoawp/workflow\n```\n\nThe postinstall script copies two directories into your project root and then removes itself from `package.json`:\n\n| Source (package) | Destination (your repo) | Purpose |\n|---|---|---|\n| `.agents/` | `.agents/` | Skills & workflow definitions for Copilot |\n| `templates/docs/` | `docs/` | Versioned doc scaffolds (PRD, design, specs) |\n\n> After install the package self-uninstalls — only the copied files remain.\n\n## Workflow Overview\n\nThe workflow follows six phases. Each phase has dedicated skills that can be invoked directly or composed by the bundled workflows.\n\n### Phase 1 — PRD\n\nWrite high-level and module-level Product Requirements Documents.\n\n```\ndocs/prd/main-v1.md\ndocs/prd/[module]-v1.md\n```\n\nSkill: **prd**\n\n### Phase 2 — Design Docs\n\nCreate separate design documents covering architecture, security, conventions, data model, and (for UI apps) sitemap.\n\n```\ndocs/design/architecture_v1.md\ndocs/design/security_v1.md\ndocs/design/conventions_v1.md\ndocs/design/data-model_v1.md\n```\n\nSkills: **software-architect**, **design-system** (UI projects)\n\n### Phase 3 — Specification\n\nWrite implementation specs referencing PRD and design docs, then break each spec into discrete tasks.\n\n```\ndocs/specs//spec.md\ndocs/specs//checklist.md\ndocs/specs//tasks/task-[n]-[task-name].md\n```\n\nSkills: **spec**, **plan**, **compress**\n\n### Phase 4 — Implementation & Review Loop\n\nExecute one task at a time through an implement → review cycle. Optionally use TDD (red → green → refine).\n\nSkills: **implement**, **tdd**, **review**, **branch**\n\n### Phase 5 — Session Management\n\nAfter completing a task, close it out: mark the checklist, write a rolling summary, and commit.\n\n```\ndocs/specs//summaries/task-[n]-summary.md\n```\n\nSkills: **checklist**, **summarize**, **commit**\n\n### Phase 6 — Integration Review\n\nPeriodically review completed specs holistically for cross-feature consistency.\n\nSkill: **integration-review** *(planned)*\n\n## The `docs/` Folder\n\n`docs/` is the living knowledge base for your project, seeded by the install and populated as you progress through the workflow:\n\n| Path | Created during | Contents |\n|---|---|---|\n| `docs/prd/` | Phase 1 | Versioned PRDs (`main-v1.md`, module PRDs) |\n| `docs/design/` | Phase 2 | Architecture, security, conventions, data model, UI/UX design system, sitemap |\n| `docs/specs//spec.md` | Phase 3 | Implementation spec with decisions, invariants, contracts |\n| `docs/specs//checklist.md` | Phase 3 | Task checklist tracking progress |\n| `docs/specs//tasks/` | Phase 3 | Individual task files with acceptance criteria |\n| `docs/specs//summaries/` | Phase 5 | Rolling session summaries carrying context between AI sessions |\n\nAll documents follow a `_vN.md` versioning convention — never overwrite, always increment.\n\n## Skills\n\n20 skills ship in `.agents/skills/`. Each is a standalone `SKILL.md` that Copilot loads on demand.\n\n| Skill | Purpose |\n|---|---|\n| **brainstorm** | Critical thinking partner — challenge assumptions, refine ideas |\n| **branch** | Create or switch to a traceable Git branch for a task |\n| **checklist** | Mark a task complete on a spec checklist |\n| **commit** | Stage changes and create a conventional commit |\n| **compress** | Shrink agent-facing instructions without changing behavior |\n| **design-system** | Generate a token-level UI design system (`docs/design/uiux-design.md`) |\n| **enhance-note** | Clean up a messy note into a structured working document |\n| **implement** | Execute one scoped change: understand → plan → implement → test → verify |\n| **integration-review** | *(planned)* Holistic cross-feature consistency check |\n| **merge-notes** | Merge overlapping notes into a single comprehensive document |\n| **page-detail** | Produce implementation-ready page breakdowns for UI pages |\n| **plan** | Break a spec or request into discrete, agent-sized tasks |\n| **prd** | Write a Product Requirements Document |\n| **review** | Code review for correctness, security, simplicity, and robustness |\n| **skill-creator** | Create, iterate, and benchmark new skills |\n| **software-architect** | Write system-level design docs (architecture, security, conventions, data model) |\n| **spec** | Write an implementation spec and pause for human review |\n| **summarize** | Produce a rolling task summary for session continuity |\n| **tdd** | Test-first implementation: red → green → refine |\n| **update-note** | Integrate new information into an existing note |\n\n## Workflows\n\n3 workflow files in `.agents/workflows/` compose skills into end-to-end sequences:\n\n| Workflow | Description |\n|---|---|\n| **start-task** | Locate task → branch → implement → review loop (up to 3 passes) |\n| **start-task-tdd** | Same as start-task but uses TDD (failing test first, then implement) |\n| **end-task** | Verify completion → update checklist → write summary → commit |\n\n### Typical session\n\n```\n> start-task user-auth # picks first unchecked task, branches, implements, reviews\n> end-task user-auth task 1 # marks checklist, writes summary, commits\n> start-task user-auth # picks next unchecked task automatically\n```\n\n## Key Principles\n\n- **Document everything with versioning** — PRDs, design docs, specs, and reviews all use `_vN.md`.\n- **Specs are the bridge** — they reference PRDs and design docs, giving the AI rich context for accurate implementation.\n- **Review every task** — never batch AI output without checking for bugs, security issues, and performance.\n- **Track progress explicitly** — per-spec checklists and per-session rolling summaries.\n- **Integrate periodically** — catch cross-feature issues before they compound.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}