{"_id":"@arsxxi/iterative-dev-workflow","_rev":"4-2d024f14365967426e7ac2ed3b5fc0a2","name":"@arsxxi/iterative-dev-workflow","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@arsxxi/iterative-dev-workflow","version":"1.0.0","keywords":["opencode-plugin","opencode","workflow","methodology"],"author":{"url":"https://github.com/Arsxxi","name":"Clio"},"license":"MIT","_id":"@arsxxi/iterative-dev-workflow@1.0.0","maintainers":[{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"}],"homepage":"https://github.com/Arsxxi/Iterative-dev-workflow","bugs":{"url":"https://github.com/Arsxxi/Iterative-dev-workflow/issues"},"dist":{"shasum":"e811f205bbe02c71c6f00b9fbe4f6cf635831736","tarball":"https://registry.npmjs.org/@arsxxi/iterative-dev-workflow/-/iterative-dev-workflow-1.0.0.tgz","fileCount":26,"integrity":"sha512-yiU5dXRhieMTA6sJaOmfHsK3jqa4SJQurz0s11AZpr77uv2jUjknrfgPbR+9UEmsKkKVWYa+2BCn63GHNldJbg==","signatures":[{"sig":"MEUCIQCKLkB5gPCRocjXVpmO+NTxSKXlBL4cXrqjBF0ADpCDGwIgFQ1PxrVBqY0e8paEdXh/qmpgVBJFiDe9/iSPDjYNVR4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68057},"main":"./.opencode/plugins/iterative-dev-workflow.mjs","exports":{".":"./.opencode/plugins/iterative-dev-workflow.mjs"},"gitHead":"288aa2a5422ec7d96777471bf79490fd1d9af085","_npmUser":{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"},"repository":{"url":"git+https://github.com/Arsxxi/Iterative-dev-workflow.git","type":"git"},"_npmVersion":"10.9.2","description":"A structured 4-phase iterative development workflow for AI coding agents.","directories":{},"_nodeVersion":"22.13.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/iterative-dev-workflow_1.0.0_1784692880931_0.9594940105487293","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@arsxxi/iterative-dev-workflow","version":"1.0.1","keywords":["opencode-plugin","opencode","workflow","methodology"],"author":{"url":"https://github.com/arsxxi/iterative-dev-workflow","name":"Clio"},"license":"MIT","_id":"@arsxxi/iterative-dev-workflow@1.0.1","maintainers":[{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"}],"homepage":"https://github.com/arsxxi/iterative-dev-workflow","bugs":{"url":"https://github.com/arsxxi/iterative-dev-workflow/issues"},"dist":{"shasum":"5c827ae964239f861ab284a43056166fddb65b66","tarball":"https://registry.npmjs.org/@arsxxi/iterative-dev-workflow/-/iterative-dev-workflow-1.0.1.tgz","fileCount":36,"integrity":"sha512-jZzDRViHemfDMdZwF8PxY8kt3VP6I1u3anPCWG7I2V3ZNQEDGupDqdc6iBxB/wDiy4TpZO7V4GeogCaTxKVXQQ==","signatures":[{"sig":"MEYCIQC5NDFjaNMr1i8CFlQaymTLtUJ0tNGN2aDN/FvSBlXRXQIhAP17NEfODEa4+c66KhIXiWga/dpw/Kcec+1UpSiN57qb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89709},"main":"./.opencode/plugins/iterative-dev-workflow.mjs","exports":{".":"./.opencode/plugins/iterative-dev-workflow.mjs"},"gitHead":"c7ee67e09dde1bbdd4ad1b94278d7e55b95b4c1f","_npmUser":{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"},"repository":{"url":"git+https://github.com/arsxxi/iterative-dev-workflow.git","type":"git"},"_npmVersion":"10.9.2","description":"A structured 4-phase iterative development workflow for AI coding agents.","directories":{},"_nodeVersion":"22.13.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/iterative-dev-workflow_1.0.1_1784705001101_0.2874260348686688","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@arsxxi/iterative-dev-workflow","version":"1.0.2","keywords":["opencode-plugin","opencode","workflow","methodology"],"author":{"url":"https://github.com/arsxxi/iterative-dev-workflow","name":"Clio"},"license":"MIT","_id":"@arsxxi/iterative-dev-workflow@1.0.2","maintainers":[{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"}],"homepage":"https://github.com/arsxxi/iterative-dev-workflow","bugs":{"url":"https://github.com/arsxxi/iterative-dev-workflow/issues"},"bin":{"iterative-dev-workflow-install":"bin/install-opencode-commands.mjs"},"dist":{"shasum":"11b0b7fe9a44cafad4c8eab46b8d6d758ad6152f","tarball":"https://registry.npmjs.org/@arsxxi/iterative-dev-workflow/-/iterative-dev-workflow-1.0.2.tgz","fileCount":37,"integrity":"sha512-sjhlg0z8NLwenXRNpkOuudZaM5Mo9L1ca7aHoWFwYER7Ab4uOczVy8qeeizdd5YZIv9yeMwV5emkBFGOZQ84SQ==","signatures":[{"sig":"MEQCIByoyiZeb6pcM/wI7MNEchMPis6Y9mmR+sU5PDRG4KXDAiBGlk3uAhUtRKv8DWGaRe6cyzfmB7+3c6axJX6nfPHNRg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96835},"main":"./.opencode/plugins/iterative-dev-workflow.mjs","exports":{".":"./.opencode/plugins/iterative-dev-workflow.mjs"},"gitHead":"cbf8b6d37bc0a9a24e12d3a75489ec904a1dab48","scripts":{"postinstall":"node ./bin/install-opencode-commands.mjs || true"},"_npmUser":{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"},"repository":{"url":"git+https://github.com/arsxxi/iterative-dev-workflow.git","type":"git"},"_npmVersion":"10.9.2","description":"A structured 4-phase iterative development workflow for AI coding agents.","directories":{},"_nodeVersion":"22.13.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/iterative-dev-workflow_1.0.2_1784736513604_0.15345913058667682","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@arsxxi/iterative-dev-workflow","version":"1.0.3","description":"A structured 4-phase iterative development workflow for AI coding agents.","keywords":["opencode-plugin","opencode","kilocode","kilo","workflow","methodology"],"license":"MIT","author":{"name":"Clio","url":"https://github.com/arsxxi/iterative-dev-workflow"},"homepage":"https://github.com/arsxxi/iterative-dev-workflow","repository":{"type":"git","url":"git+https://github.com/arsxxi/iterative-dev-workflow.git"},"bugs":{"url":"https://github.com/arsxxi/iterative-dev-workflow/issues"},"main":"./.opencode/plugins/iterative-dev-workflow.mjs","exports":{".":"./.opencode/plugins/iterative-dev-workflow.mjs"},"bin":{"iterative-dev-workflow-install":"bin/install-opencode-commands.mjs","iterative-dev-workflow-install-kilo":"bin/install-kilo-commands.mjs"},"scripts":{"postinstall":"node ./bin/install-opencode-commands.mjs || true"},"publishConfig":{"access":"public"},"_id":"@arsxxi/iterative-dev-workflow@1.0.3","gitHead":"734d00abd0a5c0a986b382bbe40efb8e83307a75","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-XjGBAD4YPXLkWbV8syu8JQPlFxCz+mTNZk6RXXYx4Tpm88WTiw3xE7TEf7n/Sz+0SciX7PiGesCzgVPmQjz4Pg==","shasum":"3f778bf02e2d8470af126d0f6bc32653b1a4afe8","tarball":"https://registry.npmjs.org/@arsxxi/iterative-dev-workflow/-/iterative-dev-workflow-1.0.3.tgz","fileCount":49,"unpackedSize":153136,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGVIh7LtCSzlCK+DJvPbrcva9E2a0jFEVGpusW0sGh5wAiEAgnfJd9tHi3GyQ5i5Ns7rBS9EGrEVOmRCZ82YGbTfJYk="}]},"_npmUser":{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"},"directories":{},"maintainers":[{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/iterative-dev-workflow_1.0.3_1784801678149_0.3531255138681231"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-22T04:01:20.681Z","modified":"2026-07-23T10:14:38.431Z","1.0.0":"2026-07-22T04:01:21.117Z","1.0.1":"2026-07-22T07:23:21.233Z","1.0.2":"2026-07-22T16:08:33.773Z","1.0.3":"2026-07-23T10:14:38.274Z"},"bugs":{"url":"https://github.com/arsxxi/iterative-dev-workflow/issues"},"author":{"name":"Clio","url":"https://github.com/arsxxi/iterative-dev-workflow"},"license":"MIT","homepage":"https://github.com/arsxxi/iterative-dev-workflow","keywords":["opencode-plugin","opencode","kilocode","kilo","workflow","methodology"],"repository":{"type":"git","url":"git+https://github.com/arsxxi/iterative-dev-workflow.git"},"description":"A structured 4-phase iterative development workflow for AI coding agents.","maintainers":[{"name":"arsxxi","email":"s22310712@student.unklab.ac.id"}],"readme":"<p align=\"center\">\r\n  <picture>\r\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"assets/yamadaaa.png\">\r\n    <img src=\"assets/yamadaaa.png\" width=\"350\" alt=\"Iterative Dev Workflow\">\r\n  </picture>\r\n</p>\r\n\r\n<h1 align=\"center\">Iterative Dev Workflow</h1>\r\n\r\n<p align=\"center\">\r\n  <em>Structure your AI agent's development process.</em>\r\n</p>\r\n\r\n<p align=\"center\">\r\n  <sub>METHODOLOGY &amp; PROMPT DESIGN</sub>\r\n</p>\r\n\r\n<p align=\"center\">\r\n  <a href=\"https://github.com/haniladjamba\">\r\n    <img src=\"https://github.com/haniladjamba.png\" width=\"64\" height=\"64\" style=\"border-radius:50%\" alt=\"Hani Ladjamba\"/>\r\n  </a>\r\n  &nbsp;&nbsp;&nbsp;\r\n  <a href=\"https://github.com/tiwowtimothy\">\r\n    <img src=\"https://github.com/tiwowtimothy.png\" width=\"64\" height=\"64\" style=\"border-radius:50%\" alt=\"Timothy Tiwow\"/>\r\n  </a>\r\n</p>\r\n<p align=\"center\">\r\n  <a href=\"https://github.com/haniladjamba\"><b>Hani Ladjamba</b></a>\r\n  &nbsp;&nbsp;&nbsp;&nbsp;\r\n  <a href=\"https://github.com/tiwowtimothy\"><b>Timothy Tiwow</b></a>\r\n</p>\r\n\r\n---\r\n\r\nStop shipping features that break production. Stop rewriting the same architecture three times. Stop wondering why your AI agent keeps over-engineering simple tasks.\r\n\r\nIterative Dev Workflow gives your AI agent a structured development process — from understanding the task to reflecting on what went wrong.\r\n\r\n## Before / after\r\n\r\nYou give your AI agent a vague task like \"build user authentication.\" Without a structure, it writes code, asks no questions, and delivers something that doesn't match what you needed.\r\n\r\nWith Iterative Dev Workflow:\r\n\r\n```\r\n/kickoff\r\n  → Agent asks: what platform? what stack? what's the project name?\r\n  → You answer\r\n  → Agent confirms understanding, sets up .workflow/<slug>/00-context.md\r\n\r\n/phase-1\r\n  → Agent explores codebase, identifies gaps, asks the right questions\r\n\r\n/phase-2-step-1\r\n  → Agent proposes 5 different approaches (Architecture, UI/UX, Data Model, etc.)\r\n\r\n/phase-2-step-2\r\n  → Agent analyzes trade-offs and sensitivity points for each approach\r\n\r\n/phase-2-step-3\r\n  → You define Quality Attributes (e.g. Performance, Maintainability)\r\n  → Agent scores each design against your criteria\r\n\r\n/phase-2-step-4\r\n  → You choose the best design\r\n  → Agent creates System Context Diagram (Mermaid.js)\r\n\r\n/phase-2-step-5\r\n  → Agent creates User Journey Diagram (Mermaid.js)\r\n\r\n/phase-3\r\n  → Agent writes implementation plan — avoiding overengineering\r\n\r\n/phase-4\r\n  → Agent reflects: what went well, what could be better\r\n```\r\n\r\nYou stay in control. The agent never skips ahead.\r\n\r\n## Install\r\n\r\n### Claude Code\r\n\r\n```\r\n/plugin marketplace add arsxxi/iterative-dev-workflow\r\n/plugin install iterative-dev-workflow@arsxxi-iterative-dev-workflow\r\n```\r\n\r\n### Codex\r\n\r\n```bash\r\ncodex plugin marketplace add arsxxi/iterative-dev-workflow\r\ncodex plugin add iterative-dev-workflow@arsxxi-iterative-dev-workflow\r\n```\r\n\r\n### OpenCode\r\n\r\n```bash\r\nnpm install -g @arsxxi/iterative-dev-workflow\r\n```\r\n\r\nOn install, a `postinstall` script copies the commands into `~/.config/opencode/commands/`\r\nautomatically. Restart OpenCode and type `/` to see them.\r\n\r\nIf commands still don't show up (some package managers or environments skip lifecycle scripts,\r\nor your OpenCode version doesn't pick them up automatically), run the installer manually:\r\n\r\n```bash\r\nnpx --package=@arsxxi/iterative-dev-workflow iterative-dev-workflow-install\r\n```\r\n\r\nOr, as a guaranteed last resort, copy the `commands/` folder from this repo directly into\r\n`~/.config/opencode/commands/` (global) or `.opencode/commands/` inside your project yourself -\r\nthese are plain markdown files, no build step required.\r\n\r\nThen add to your `opencode.json` (this enables the AGENTS.md system-prompt injection feature,\r\nseparate from command registration):\r\n\r\n```json\r\n{ \"plugin\": [\"@arsxxi/iterative-dev-workflow\"] }\r\n```\r\n\r\n### Kilo Code\r\n\r\nKilo Code is a VS Code extension, so there is no plugin marketplace command — the commands are\r\ninstalled as files. Easiest path, available in every project:\r\n\r\n```bash\r\nnpm install -g @arsxxi/iterative-dev-workflow\r\nnpx --package=@arsxxi/iterative-dev-workflow iterative-dev-workflow-install-kilo\r\n```\r\n\r\nThis copies the 10 commands into `~/.config/kilo/commands/` and the methodology into\r\n`~/.config/kilo/rules/`. Reload the Kilo Code extension, then type `/` to see them.\r\n\r\nTo load the methodology into the system prompt, add the rules glob to\r\n`~/.config/kilo/kilo.jsonc`:\r\n\r\n```json\r\n{ \"instructions\": [\"~/.config/kilo/rules/*.md\"] }\r\n```\r\n\r\nFor a single project instead of globally, copy `.kilo/commands/` and `.kilo/rules/` from this\r\nrepo into your project root and point `kilo.jsonc` at the rules:\r\n\r\n```json\r\n{ \"instructions\": [\".kilo/rules/*.md\"] }\r\n```\r\n\r\nOlder Kilo Code builds read `.kilocode/workflows/` and `.kilocode/rules/` instead. Both paths are\r\nshipped in this repo, so either version works — newer builds migrate the legacy path on startup.\r\n\r\n### Antigravity CLI\r\n\r\n```bash\r\nagy plugin install https://github.com/arsxxi/iterative-dev-workflow\r\n```\r\n\r\n## Commands\r\n\r\n| # | Command | Description |\r\n|---|---------|-------------|\r\n| 0 | `/kickoff` | Start a new project — asks what to build, platform/stack, project name |\r\n| 1 | `/phase-1` | Analyze: understand task, explore codebase, identify gaps |\r\n| 2.1 | `/phase-2-step-1` | Solution Proposal: create minimum 5 designs |\r\n| 2.2 | `/phase-2-step-2` | ATAM: assess trade-offs and sensitivity points |\r\n| 2.3 | `/phase-2-step-3` | Quality Attribute: weighted scoring assessment |\r\n| 2.4 | `/phase-2-step-4` | High-Fidelity Design: System Context Diagram (Mermaid.js) |\r\n| 2.5 | `/phase-2-step-5` | User Journey: User Journey Diagram (Mermaid.js) |\r\n| 3 | `/phase-3` | Implementation Plan: write comprehensive plan |\r\n| 4 | `/phase-4` | Postmortem: reflect and improve |\r\n| — | `/session-transcript` | Record verbatim conversation to project root as `aichat-<slug>.md` |\r\n\r\n## Output Location\r\n\r\nAll phase outputs are written to `.workflow/<slug>/`:\r\n\r\n```\r\n.workflow/<slug>/\r\n├── 00-context.md      # platform, description, existing services\r\n├── 01-analyze.md     # Phase 1\r\n├── 02-propose.md     # Phase 2 Step 1\r\n├── 02-atam.md        # Phase 2 Step 2\r\n├── 02-qa.md          # Phase 2 Step 3\r\n├── 02-hifi.md        # Phase 2 Step 4 (System Context Diagram)\r\n├── 02-journey.md     # Phase 2 Step 5 (User Journey Diagram)\r\n├── 03-implement.md    # Phase 3\r\n└── 04-postmortem.md   # Phase 4\r\n```\r\n\r\nSession transcripts are saved directly to the **project root** as `aichat-<slug>.md` (or `aichat.md` if no project name was provided).\r\n\r\n## Hard Constraints\r\n\r\n- **AVOID overengineering.** PREFER simple, low-complexity implementations.\r\n- **AVOID jargon.** Use plain language that states actual intent.\r\n- **Never skip phases.** Design must be approved before implementation begins.\r\n- **Iterative, not waterfall.** If a problem surfaces in a later phase, circle back to fix it there.\r\n\r\n## Workflow Flow\r\n\r\n```\r\n/kickoff\r\n  └── /phase-1\r\n        └── /phase-2-step-1\r\n              └── /phase-2-step-2\r\n                    └── /phase-2-step-3  (may loop back to /phase-2-step-1)\r\n                          └── /phase-2-step-4\r\n                                └── /phase-2-step-5\r\n                                      └── /phase-3\r\n                                            └── /phase-4\r\n```\r\n\r\n## Development\r\n\r\nThe source of truth is `commands/*.md` (10 files) and `skills/workflow-methodology/SKILL.md`. After editing these, run:\r\n\r\n```bash\r\nbash scripts/sync-platforms.sh\r\n```\r\n\r\nThis syncs to:\r\n- `.opencode/commands/` — OpenCode command definitions\r\n- `.agents/skills/` — Antigravity/Codex skill definitions\r\n- `.kilo/commands/` + `.kilo/rules/` — Kilo Code commands and methodology rule\r\n- `.kilocode/workflows/` + `.kilocode/rules/` — same payload on Kilo Code's legacy paths\r\n- `AGENTS.md` — cross-platform instruction file\r\n\r\nThe Kilo Code targets are the only ones that aren't a verbatim copy: Kilo has no `argument-hint`\r\nfrontmatter key and doesn't substitute `$ARGUMENTS`, so `scripts/build-kilo.mjs` rewrites the\r\nfrontmatter and prepends a short note explaining where the argument comes from. The command body\r\nitself is copied unchanged.\r\n\r\n## FAQ\r\n\r\n**Does every project need all phases?**\r\n\r\nNo. The workflow is modular. Use only what the task needs — but don't skip backward. Each phase has a clear prerequisite chain.\r\n\r\n**What if the design doesn't support implementation?**\r\n\r\nStop. Tell the user clearly. Circle back to Phase 2. Do not silently work around a design flaw in the plan.\r\n\r\n**How do I choose a project name?**\r\n\r\nUse a short, lowercase identifier with hyphens (e.g. `user-auth`, `article-quality-widget`, `payment-flow`). It's used as the project folder name under `.workflow/<slug>/`, so it stays filesystem-safe.\r\n\r\n**What's the difference between Phase 2 Step 4 and Step 5?**\r\n\r\nStep 4 creates a System Context Diagram — shows how the solution fits within the whole app. Step 5 creates a User Journey Diagram — shows how the user interacts with the system.\r\n\r\n## License\r\n\r\n[MIT](LICENSE)\r\n","readmeFilename":"README.md"}