@givolt/i3-composer-agent 1.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude/commands/{build.md → i3-build.md} +10 -10
  3. package/.claude/commands/{code-simplify.md → i3-code-simplify.md} +2 -2
  4. package/.claude/commands/{constraints.md → i3-constraints.md} +4 -4
  5. package/.claude/commands/{plan.md → i3-plan.md} +1 -1
  6. package/.claude/commands/{review.md → i3-review.md} +3 -3
  7. package/.claude/commands/{ship.md → i3-ship.md} +4 -4
  8. package/.claude/commands/{spec.md → i3-spec.md} +1 -1
  9. package/.claude/commands/{test.md → i3-test.md} +2 -2
  10. package/.claude/commands/{webperf.md → i3-webperf.md} +1 -1
  11. package/.claude-plugin/marketplace.json +1 -1
  12. package/.claude-plugin/plugin.json +1 -1
  13. package/.codex-plugin/plugin.json +1 -1
  14. package/.gemini/commands/{build.toml → i3-build.toml} +10 -10
  15. package/.gemini/commands/{code-simplify.toml → i3-code-simplify.toml} +2 -2
  16. package/.gemini/commands/{constraints.toml → i3-constraints.toml} +4 -4
  17. package/.gemini/commands/{planning.toml → i3-planning.toml} +1 -1
  18. package/{commands/review.toml → .gemini/commands/i3-review.toml} +3 -3
  19. package/.gemini/commands/{ship.toml → i3-ship.toml} +4 -4
  20. package/.gemini/commands/{spec.toml → i3-spec.toml} +1 -1
  21. package/{commands/test.toml → .gemini/commands/i3-test.toml} +2 -2
  22. package/.gemini/commands/{webperf.toml → i3-webperf.toml} +1 -1
  23. package/README.md +72 -69
  24. package/agents/code-reviewer.md +2 -2
  25. package/agents/security-auditor.md +1 -1
  26. package/agents/test-engineer.md +1 -1
  27. package/agents/web-performance-auditor.md +3 -3
  28. package/bin/agent-targets.json +11 -0
  29. package/bin/asset-fingerprint.cjs +38 -0
  30. package/bin/cleanup-backups.cjs +16 -0
  31. package/bin/i3-composer-agent.cjs +29 -14
  32. package/bin/install.cjs +81 -19
  33. package/bin/native-content.cjs +29 -0
  34. package/bin/wizard.cjs +2 -1
  35. package/commands/{build.toml → i3-build.toml} +10 -10
  36. package/commands/{code-simplify.toml → i3-code-simplify.toml} +2 -2
  37. package/commands/{constraints.toml → i3-constraints.toml} +4 -4
  38. package/commands/{planning.toml → i3-planning.toml} +1 -1
  39. package/{.gemini/commands/review.toml → commands/i3-review.toml} +3 -3
  40. package/commands/{ship.toml → i3-ship.toml} +4 -4
  41. package/commands/{spec.toml → i3-spec.toml} +1 -1
  42. package/{.gemini/commands/test.toml → commands/i3-test.toml} +2 -2
  43. package/commands/{webperf.toml → i3-webperf.toml} +1 -1
  44. package/docs/adoption-guide.md +35 -35
  45. package/docs/agents.md +12 -12
  46. package/docs/antigravity-setup.md +14 -14
  47. package/docs/codebuddy-setup.md +27 -18
  48. package/docs/codex-setup.md +6 -6
  49. package/docs/commandcode-setup.md +5 -5
  50. package/docs/copilot-cli-setup.md +5 -5
  51. package/docs/copilot-setup.md +22 -22
  52. package/docs/cursor-setup.md +22 -22
  53. package/docs/gemini-cli-setup.md +26 -26
  54. package/docs/getting-started.md +36 -38
  55. package/docs/opencode-setup.md +31 -31
  56. package/docs/windsurf-setup.md +7 -7
  57. package/docs/workbuddy-setup.md +92 -0
  58. package/hooks/SDD-CACHE.md +3 -3
  59. package/hooks/SIMPLIFY-IGNORE.md +2 -2
  60. package/hooks/session-start-test.sh +1 -1
  61. package/hooks/session-start.sh +3 -3
  62. package/package.json +36 -20
  63. package/plugin.json +1 -1
  64. package/references/accessibility-checklist.md +1 -1
  65. package/references/definition-of-done.md +7 -7
  66. package/references/observability-checklist.md +3 -3
  67. package/references/orchestration-patterns.md +17 -17
  68. package/references/performance-checklist.md +2 -2
  69. package/references/security-checklist.md +1 -1
  70. package/references/testing-patterns.md +1 -1
  71. package/skills/{api-and-interface-design → i3-api-and-interface-design}/SKILL.md +2 -2
  72. package/skills/{browser-testing-with-devtools → i3-browser-testing-with-devtools}/SKILL.md +1 -1
  73. package/skills/{ci-cd-and-automation → i3-ci-cd-and-automation}/SKILL.md +2 -2
  74. package/skills/{code-review-and-quality → i3-code-review-and-quality}/SKILL.md +5 -5
  75. package/skills/{code-simplification → i3-code-simplification}/SKILL.md +1 -1
  76. package/skills/{constraint-driven-development → i3-constraint-driven-development}/SKILL.md +15 -15
  77. package/skills/{context-engineering → i3-context-engineering}/SKILL.md +1 -1
  78. package/skills/{debugging-and-error-recovery → i3-debugging-and-error-recovery}/SKILL.md +2 -2
  79. package/skills/{deprecation-and-migration → i3-deprecation-and-migration}/SKILL.md +2 -2
  80. package/skills/{documentation-and-adrs → i3-documentation-and-adrs}/SKILL.md +1 -1
  81. package/skills/{doubt-driven-development → i3-doubt-driven-development}/SKILL.md +8 -8
  82. package/skills/{frontend-ui-engineering → i3-frontend-ui-engineering}/SKILL.md +1 -1
  83. package/skills/{git-workflow-and-versioning → i3-git-workflow-and-versioning}/SKILL.md +4 -4
  84. package/skills/{idea-refine → i3-idea-refine}/SKILL.md +2 -2
  85. package/skills/{idea-refine → i3-idea-refine}/scripts/idea-refine.sh +1 -1
  86. package/skills/{incremental-implementation → i3-incremental-implementation}/SKILL.md +3 -3
  87. package/skills/{interview-me → i3-interview-me}/SKILL.md +12 -12
  88. package/skills/{observability-and-instrumentation → i3-observability-and-instrumentation}/SKILL.md +5 -5
  89. package/skills/{performance-optimization → i3-performance-optimization}/SKILL.md +1 -1
  90. package/skills/{performance-optimization → i3-performance-optimization}/references/optimization-patterns.md +1 -1
  91. package/skills/{planning-and-task-breakdown → i3-planning-and-task-breakdown}/SKILL.md +2 -2
  92. package/skills/{security-and-hardening → i3-security-and-hardening}/SKILL.md +3 -3
  93. package/skills/{security-and-hardening → i3-security-and-hardening}/references/hardening-patterns.md +1 -1
  94. package/skills/{shipping-and-launch → i3-shipping-and-launch}/SKILL.md +2 -2
  95. package/skills/{source-driven-development → i3-source-driven-development}/SKILL.md +2 -2
  96. package/skills/{spec-driven-development → i3-spec-driven-development}/SKILL.md +7 -7
  97. package/skills/{test-driven-development → i3-test-driven-development}/SKILL.md +2 -2
  98. package/skills/{using-agent-skills → i3-using-agent-skills}/SKILL.md +67 -67
  99. package/CHANGELOG.md +0 -34
  100. package/NOTICE.md +0 -14
  101. package/docs/advanced-per-agent-configuration.md +0 -70
  102. package/docs/comparison.md +0 -131
  103. package/docs/developer-onboarding.md +0 -116
  104. package/docs/skill-anatomy.md +0 -203
  105. package/evals/README.md +0 -101
  106. package/evals/cases/api-and-interface-design.json +0 -45
  107. package/evals/cases/browser-testing-with-devtools.json +0 -44
  108. package/evals/cases/ci-cd-and-automation.json +0 -45
  109. package/evals/cases/code-review-and-quality.json +0 -49
  110. package/evals/cases/code-simplification.json +0 -45
  111. package/evals/cases/constraint-driven-development.json +0 -79
  112. package/evals/cases/context-engineering.json +0 -44
  113. package/evals/cases/debugging-and-error-recovery.json +0 -58
  114. package/evals/cases/deprecation-and-migration.json +0 -52
  115. package/evals/cases/documentation-and-adrs.json +0 -44
  116. package/evals/cases/doubt-driven-development.json +0 -43
  117. package/evals/cases/frontend-ui-engineering.json +0 -52
  118. package/evals/cases/git-workflow-and-versioning.json +0 -47
  119. package/evals/cases/idea-refine.json +0 -43
  120. package/evals/cases/incremental-implementation.json +0 -57
  121. package/evals/cases/interview-me.json +0 -42
  122. package/evals/cases/observability-and-instrumentation.json +0 -44
  123. package/evals/cases/performance-optimization.json +0 -53
  124. package/evals/cases/planning-and-task-breakdown.json +0 -45
  125. package/evals/cases/security-and-hardening.json +0 -53
  126. package/evals/cases/shipping-and-launch.json +0 -56
  127. package/evals/cases/source-driven-development.json +0 -44
  128. package/evals/cases/spec-driven-development.json +0 -72
  129. package/evals/cases/test-driven-development.json +0 -73
  130. package/evals/cases/using-agent-skills.json +0 -44
  131. package/evals/fixtures/api-and-interface-design/service-brief.md +0 -19
  132. package/evals/fixtures/browser-testing-with-devtools/README.md +0 -5
  133. package/evals/fixtures/browser-testing-with-devtools/index.html +0 -24
  134. package/evals/fixtures/browser-testing-with-devtools/server.js +0 -15
  135. package/evals/fixtures/ci-cd-and-automation/package.json +0 -8
  136. package/evals/fixtures/ci-cd-and-automation/src/slug.js +0 -3
  137. package/evals/fixtures/ci-cd-and-automation/test/slug.test.js +0 -9
  138. package/evals/fixtures/code-review-and-quality/user-search.diff +0 -16
  139. package/evals/fixtures/code-simplification/config-parser.js +0 -46
  140. package/evals/fixtures/code-simplification/config-parser.test.js +0 -15
  141. package/evals/fixtures/context-engineering/context-audit.md +0 -15
  142. package/evals/fixtures/debugging-and-error-recovery/pagination.js +0 -8
  143. package/evals/fixtures/debugging-and-error-recovery/pagination.test.js +0 -9
  144. package/evals/fixtures/debugging-and-error-recovery/time-pressure.md +0 -6
  145. package/evals/fixtures/deprecation-and-migration/api-inventory.md +0 -9
  146. package/evals/fixtures/documentation-and-adrs/decision-context.md +0 -16
  147. package/evals/fixtures/doubt-driven-development/migration-plan.md +0 -19
  148. package/evals/fixtures/frontend-ui-engineering/Button.tsx +0 -7
  149. package/evals/fixtures/frontend-ui-engineering/design-system.md +0 -11
  150. package/evals/fixtures/git-workflow-and-versioning/.eval/working-tree.patch +0 -21
  151. package/evals/fixtures/git-workflow-and-versioning/app.js +0 -7
  152. package/evals/fixtures/git-workflow-and-versioning/app.test.js +0 -9
  153. package/evals/fixtures/incremental-implementation/reports.js +0 -7
  154. package/evals/fixtures/incremental-implementation/reports.test.js +0 -12
  155. package/evals/fixtures/incremental-implementation/tasks/plan.md +0 -8
  156. package/evals/fixtures/incremental-implementation-pressure/draft-export.js +0 -17
  157. package/evals/fixtures/incremental-implementation-pressure/scenario.md +0 -9
  158. package/evals/fixtures/observability-and-instrumentation/operations.md +0 -11
  159. package/evals/fixtures/observability-and-instrumentation/payment-retry.js +0 -14
  160. package/evals/fixtures/performance-optimization/benchmark.js +0 -15
  161. package/evals/fixtures/performance-optimization/products.js +0 -14
  162. package/evals/fixtures/planning-and-task-breakdown/notifications-spec.md +0 -18
  163. package/evals/fixtures/security-and-hardening/webhook.js +0 -11
  164. package/evals/fixtures/security-and-hardening/webhook.test.js +0 -13
  165. package/evals/fixtures/shipping-and-launch/authority-pressure.md +0 -6
  166. package/evals/fixtures/shipping-and-launch/launch-status.md +0 -11
  167. package/evals/fixtures/source-driven-development/framework-task.md +0 -10
  168. package/evals/fixtures/spec-driven-development/billing-brief.md +0 -16
  169. package/evals/fixtures/spec-driven-development-decomposition/portal-brief.md +0 -22
  170. package/evals/fixtures/test-driven-development/BUG.md +0 -10
  171. package/evals/fixtures/test-driven-development/README.md +0 -28
  172. package/evals/fixtures/test-driven-development/package.json +0 -9
  173. package/evals/fixtures/test-driven-development/src/split.js +0 -8
  174. package/evals/fixtures/test-driven-development/test/split.test.js +0 -13
  175. package/evals/fixtures/test-driven-development-ecosystem/README.md +0 -9
  176. package/evals/fixtures/test-driven-development-ecosystem/ledger.py +0 -15
  177. package/evals/fixtures/test-driven-development-ecosystem/test_ledger.py +0 -19
  178. package/evals/fixtures/using-agent-skills/incident.md +0 -6
  179. package/evals/plugin/code-review-fires/graders/off-by-one.md +0 -7
  180. package/evals/plugin/code-review-fires/graders/severity-labels.md +0 -4
  181. package/evals/plugin/code-review-fires/graders/skill-fired.md +0 -5
  182. package/evals/plugin/code-review-fires/prompt.md +0 -31
  183. package/evals/plugin/code-review-stays-quiet/graders/not-fired.md +0 -8
  184. package/evals/plugin/code-review-stays-quiet/graders/tdd-fired.md +0 -6
  185. package/evals/plugin/code-review-stays-quiet/prompt.md +0 -8
  186. package/evals/plugin/code-review-stays-quiet-on-commit-message/graders/not-fired.md +0 -8
  187. package/evals/plugin/code-review-stays-quiet-on-commit-message/prompt.md +0 -25
  188. package/evals/skill-impact.md +0 -6
  189. package/rebrand/INSTALLATION-SPEC.md +0 -46
  190. package/rebrand/MAINTENANCE.md +0 -113
  191. package/rebrand/NOTICE.md +0 -14
  192. package/rebrand/PR-WORKFLOW.md +0 -34
  193. package/rebrand/UNIFICATION-SPEC.md +0 -33
  194. package/rebrand/VALIDATION.md +0 -32
  195. package/rebrand/VERSIONING.md +0 -33
  196. package/rebrand/apply.cjs +0 -194
  197. package/rebrand/brand.json +0 -13
  198. package/rebrand/catalog.cjs +0 -56
  199. package/rebrand/fork-patches.json +0 -12
  200. package/rebrand/overlay/.github/workflows/test-plugin-install.yml +0 -177
  201. package/rebrand/overlay/CHANGELOG.md +0 -34
  202. package/rebrand/overlay/bin/agent-targets.json +0 -726
  203. package/rebrand/overlay/bin/i3-composer-agent.cjs +0 -190
  204. package/rebrand/overlay/bin/install.cjs +0 -164
  205. package/rebrand/overlay/bin/skills-registry.LICENSE +0 -21
  206. package/rebrand/overlay/bin/wizard.cjs +0 -66
  207. package/rebrand/overlay/scripts/validate-brand.cjs +0 -44
  208. package/rebrand/overlay/tests/bundle.test.cjs +0 -85
  209. package/rebrand/overlay/tests/installer.test.cjs +0 -193
  210. package/rebrand/package.template.json +0 -82
  211. package/rebrand/rebrand.sh +0 -4
  212. package/rebrand/record-upstream.cjs +0 -37
  213. package/rebrand/templates/README.md +0 -124
  214. package/rebrand/templates/codebuddy-setup.md +0 -88
  215. package/rebrand/templates/codex-setup.md +0 -45
  216. package/rebrand/tests/pipeline.test.cjs +0 -185
  217. package/rebrand/upstream.json +0 -171
  218. package/scripts/floor-guard-reference-test.js +0 -291
  219. package/scripts/lib/skill-lint-test.js +0 -650
  220. package/scripts/lib/skill-lint.js +0 -584
  221. package/scripts/run-evals-test.js +0 -623
  222. package/scripts/run-evals.js +0 -638
  223. package/scripts/validate-artifact-paths-test.js +0 -179
  224. package/scripts/validate-artifact-paths.js +0 -128
  225. package/scripts/validate-brand.cjs +0 -44
  226. package/scripts/validate-commands-test.js +0 -216
  227. package/scripts/validate-commands.js +0 -222
  228. package/scripts/validate-reference-links-test.js +0 -495
  229. package/scripts/validate-reference-links.js +0 -187
  230. package/scripts/validate-skills.js +0 -69
  231. package/scripts/validate-versions-test.js +0 -32
  232. package/scripts/validate-versions.js +0 -35
  233. package/tests/bundle.test.cjs +0 -85
  234. package/tests/installer.test.cjs +0 -193
  235. /package/skills/{constraint-driven-development → i3-constraint-driven-development}/references/floor-guard.md +0 -0
  236. /package/skills/{idea-refine → i3-idea-refine}/examples.md +0 -0
  237. /package/skills/{idea-refine → i3-idea-refine}/frameworks.md +0 -0
  238. /package/skills/{idea-refine → i3-idea-refine}/refinement-criteria.md +0 -0
@@ -6,7 +6,7 @@
6
6
  "plugins": [
7
7
  {
8
8
  "name": "i3-composer-agent",
9
- "version": "1.0.1",
9
+ "version": "2.1.0",
10
10
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
11
11
  "source": {
12
12
  "source": "local",
@@ -2,12 +2,12 @@
2
2
  description: Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:incremental-implementation skill alongside i3-composer-agent:test-driven-development.
5
+ Invoke the i3-composer-agent:i3-incremental-implementation skill alongside i3-composer-agent:i3-test-driven-development.
6
6
 
7
7
  ## Modes
8
8
 
9
- - **`/build`** — implement the *next* pending task, then stop (careful, one slice at a time).
10
- - **`/build auto`** — generate the plan if needed, get a single approval, then implement *every* task without stopping between them.
9
+ - **`/i3-build`** — implement the *next* pending task, then stop (careful, one slice at a time).
10
+ - **`/i3-build auto`** — generate the plan if needed, get a single approval, then implement *every* task without stopping between them.
11
11
 
12
12
  `$ARGUMENTS` selects the mode. Treat `auto` (canonical) or `all` as autonomous mode; anything else (or empty) is the default single-task mode. Note: autonomous mode is not faster *per task* — it runs the same test-driven loop — it only removes the human stepping *between* tasks.
13
13
 
@@ -24,21 +24,21 @@ Pick the next pending task from the plan. Then:
24
24
  7. Commit with a descriptive message
25
25
  8. Mark the task complete and stop
26
26
 
27
- ## Autonomous: the whole plan (`/build auto`)
27
+ ## Autonomous: the whole plan (`/i3-build auto`)
28
28
 
29
29
  Use this once a spec exists and you want to collapse plan + build into one run. It removes the manual stepping between tasks — **not** the verification. Every task still earns a passing test and its own commit.
30
30
 
31
- 1. **Require a spec.** Look only for a spec at a known path: `SPEC.md` at the repo root, `docs/SPEC.md`, or a file under `spec/`. A README or arbitrary doc does **not** count. If none exists, stop and tell the user to run `/spec` first — do not invent requirements.
31
+ 1. **Require a spec.** Look only for a spec at a known path: `SPEC.md` at the repo root, `docs/SPEC.md`, or a file under `spec/`. A README or arbitrary doc does **not** count. If none exists, stop and tell the user to run `/i3-spec` first — do not invent requirements.
32
32
  2. **Establish a clean baseline.** Run `git status --porcelain`. If there are uncommitted changes outside the expected planning artifacts (`SPEC.md`, `docs/SPEC.md`, `spec/*`, `tasks/plan.md`, `tasks/todo.md`), stop and ask the user to commit, stash, or confirm how to handle them. Autonomous per-task commits must not absorb unrelated local work, or the clean-rollback guarantee breaks.
33
- 3. **Plan if needed.** If there is no `tasks/plan.md`, invoke i3-composer-agent:planning-and-task-breakdown to generate one.
33
+ 3. **Plan if needed.** If there is no `tasks/plan.md`, invoke i3-composer-agent:i3-planning-and-task-breakdown to generate one.
34
34
  4. **Single checkpoint.** Present the full plan and wait for an unambiguous affirmative (e.g. "approve", "go", "yes"). Treat hedged responses ("looks reasonable", "I guess") as **not** approved. This is the only human gate — after approval, run autonomously. If you generated `tasks/plan.md`, commit it as a single preparatory commit now so it doesn't bleed into the first task's commit.
35
35
  5. **Execute every task in dependency order.** Use each task's declared dependencies; if they aren't explicit, execute in the order the plan lists them. For each task, run the full default loop above (RED → GREEN → regression → build → commit → mark complete). Stage only the files that task touched plus its task-status update — never `git add -A` blindly — and make one commit per task so any point is a clean rollback.
36
36
  6. **Stop and ask the user** (do not push through) when:
37
- - a test can't be made to pass or the build breaks without an obvious fix → follow i3-composer-agent:debugging-and-error-recovery
37
+ - a test can't be made to pass or the build breaks without an obvious fix → follow i3-composer-agent:i3-debugging-and-error-recovery
38
38
  - the spec is ambiguous, or a task needs a decision the spec doesn't cover
39
- - a task is high-risk or irreversible — auth/permission changes, destructive data migrations, payments, deletions, deploys, anything touching secrets, **or anything you can't undo with `git revert`** → follow i3-composer-agent:doubt-driven-development and get explicit sign-off before continuing
39
+ - a task is high-risk or irreversible — auth/permission changes, destructive data migrations, payments, deletions, deploys, anything touching secrets, **or anything you can't undo with `git revert`** → follow i3-composer-agent:i3-doubt-driven-development and get explicit sign-off before continuing
40
40
 
41
- After the user resolves a blocker, they re-invoke `/build auto` — it resumes from the next pending task.
41
+ After the user resolves a blocker, they re-invoke `/i3-build auto` — it resumes from the next pending task.
42
42
  7. **Summarize at the end:** tasks completed, tests added, commits made, and anything skipped, flagged, or left for the user.
43
43
 
44
- If any step fails, follow the i3-composer-agent:debugging-and-error-recovery skill.
44
+ If any step fails, follow the i3-composer-agent:i3-debugging-and-error-recovery skill.
@@ -2,7 +2,7 @@
2
2
  description: Simplify code for clarity and maintainability — reduce complexity without changing behavior
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:code-simplification skill.
5
+ Invoke the i3-composer-agent:i3-code-simplification skill.
6
6
 
7
7
  Simplify recently changed code (or the specified scope) while preserving exact behavior:
8
8
 
@@ -19,4 +19,4 @@ Simplify recently changed code (or the specified scope) while preserving exact b
19
19
  5. Apply each simplification incrementally — run tests after each change
20
20
  6. Verify all tests pass, the build succeeds, and the diff is clean
21
21
 
22
- If tests fail after a simplification, revert that change and reconsider. Use `code-review-and-quality` to review the result.
22
+ If tests fail after a simplification, revert that change and reconsider. Use `i3-code-review-and-quality` to review the result.
@@ -2,7 +2,7 @@
2
2
  description: Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:constraint-driven-development skill.
5
+ Invoke the i3-composer-agent:i3-constraint-driven-development skill.
6
6
 
7
7
  $ARGUMENTS
8
8
 
@@ -27,6 +27,6 @@ Default behaviour with no arguments: set up constraints for this repository.
27
27
  7. **Verify.** Run the constraints against the current branch. If anything fails that the user disagrees with, fix the constraint now rather than leaving a gate people will learn to ignore.
28
28
 
29
29
  Sub-commands:
30
- - `/constraints check` — run the current constraints against this branch and report
31
- - `/constraints guard` — inspect the diff for a weakened bar: lowered thresholds, skipped or deleted tests, new suppression comments, unfinished stubs, new exceptions
32
- - `/constraints ratchet` — record today's measured values as the floor that must not fall
30
+ - `/i3-constraints check` — run the current constraints against this branch and report
31
+ - `/i3-constraints guard` — inspect the diff for a weakened bar: lowered thresholds, skipped or deleted tests, new suppression comments, unfinished stubs, new exceptions
32
+ - `/i3-constraints ratchet` — record today's measured values as the floor that must not fall
@@ -2,7 +2,7 @@
2
2
  description: Break work into small verifiable tasks with acceptance criteria and dependency ordering
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:planning-and-task-breakdown skill.
5
+ Invoke the i3-composer-agent:i3-planning-and-task-breakdown skill.
6
6
 
7
7
  Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:
8
8
 
@@ -2,15 +2,15 @@
2
2
  description: Conduct a five-axis code review — correctness, readability, architecture, security, performance
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:code-review-and-quality skill.
5
+ Invoke the i3-composer-agent:i3-code-review-and-quality skill.
6
6
 
7
7
  Review the current changes (staged or recent commits) across all five axes:
8
8
 
9
9
  1. **Correctness** — Does it match the spec? Edge cases handled? Tests adequate?
10
10
  2. **Readability** — Clear names? Straightforward logic? Well-organized?
11
11
  3. **Architecture** — Follows existing patterns? Clean boundaries? Right abstraction level?
12
- 4. **Security** — Input validated? Secrets safe? Auth checked? (Use security-and-hardening skill)
13
- 5. **Performance** — No N+1 queries? No unbounded ops? (Use performance-optimization skill)
12
+ 4. **Security** — Input validated? Secrets safe? Auth checked? (Use i3-security-and-hardening skill)
13
+ 5. **Performance** — No N+1 queries? No unbounded ops? (Use i3-performance-optimization skill)
14
14
 
15
15
  Categorize findings as Critical, Important, or Suggestion.
16
16
  Output a structured review with specific file:line references and fix recommendations.
@@ -2,9 +2,9 @@
2
2
  description: Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:shipping-and-launch skill.
5
+ Invoke the i3-composer-agent:i3-shipping-and-launch skill.
6
6
 
7
- `/ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
7
+ `/i3-ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
8
8
 
9
9
  ## Phase A — Parallel fan-out
10
10
 
@@ -23,7 +23,7 @@ Constraints (from Claude Code's subagent model):
23
23
  - Each subagent gets its own context window and returns only its report to this main session.
24
24
  - If you need teammates that talk to each other instead of just reporting back, use Claude Code Agent Teams and reference these personas as teammate types (see `references/orchestration-patterns.md`).
25
25
 
26
- **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `.claude/agents/` or `~/.claude/agents/`, those take precedence over this plugin's versions — `/ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Claude Code's scope priority table, so user-level definitions win by design.
26
+ **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `.claude/agents/` or `~/.claude/agents/`, those take precedence over this plugin's versions — `/i3-ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Claude Code's scope priority table, so user-level definitions win by design.
27
27
 
28
28
  ## Phase B — Merge in main context
29
29
 
@@ -69,4 +69,4 @@ Produce a single output:
69
69
  2. Personas do not call each other. The main agent merges in Phase B.
70
70
  3. The rollback plan is mandatory before any GO decision.
71
71
  4. If any persona returns a Critical finding, the default verdict is NO-GO unless the user explicitly accepts the risk.
72
- 5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under 50 lines, and it does not touch auth, payments, data access, or config/env. Otherwise, default to fan-out. `/ship` is designed for production-bound changes — when the blast radius is non-trivial, run the parallel review even if the diff looks small.
72
+ 5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under 50 lines, and it does not touch auth, payments, data access, or config/env. Otherwise, default to fan-out. `/i3-ship` is designed for production-bound changes — when the blast radius is non-trivial, run the parallel review even if the diff looks small.
@@ -2,7 +2,7 @@
2
2
  description: Start spec-driven development — write a structured specification before writing code
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:spec-driven-development skill.
5
+ Invoke the i3-composer-agent:i3-spec-driven-development skill.
6
6
 
7
7
  Begin by understanding what the user wants to build. Ask clarifying questions about:
8
8
  1. The objective and target users
@@ -2,7 +2,7 @@
2
2
  description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern.
3
3
  ---
4
4
 
5
- Invoke the i3-composer-agent:test-driven-development skill.
5
+ Invoke the i3-composer-agent:i3-test-driven-development skill.
6
6
 
7
7
  For new features:
8
8
  1. Write tests that describe the expected behavior (they should FAIL)
@@ -16,4 +16,4 @@ For bug fixes (Prove-It pattern):
16
16
  4. Confirm the test passes
17
17
  5. Run the full test suite for regressions
18
18
 
19
- For browser-related issues, also invoke i3-composer-agent:browser-testing-with-devtools to verify with Chrome DevTools MCP.
19
+ For browser-related issues, also invoke i3-composer-agent:i3-browser-testing-with-devtools to verify with Chrome DevTools MCP.
@@ -2,7 +2,7 @@
2
2
  description: Run a web performance audit via the web-performance-auditor persona
3
3
  ---
4
4
 
5
- `/webperf` targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
5
+ `/i3-webperf` targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
6
6
 
7
7
  ## Determine the mode
8
8
 
@@ -8,7 +8,7 @@
8
8
  "plugins": [
9
9
  {
10
10
  "name": "i3-composer-agent",
11
- "version": "1.0.1",
11
+ "version": "2.1.0",
12
12
  "source": "./",
13
13
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
14
14
  "homepage": "https://github.com/49780522/i3-composer-agent",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "i3-composer-agent",
3
- "version": "1.0.1",
3
+ "version": "2.1.0",
4
4
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
5
5
  "author": {
6
6
  "name": "Givolt"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "i3-composer-agent",
3
- "version": "1.0.1",
3
+ "version": "2.1.0",
4
4
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
5
5
  "author": {
6
6
  "name": "Givolt"
@@ -1,12 +1,12 @@
1
1
  description = "Implement tasks incrementally — build, test, verify, commit. Add \"auto\" to run the whole plan in one approved pass."
2
2
 
3
3
  prompt = """
4
- Invoke the incremental-implementation skill alongside test-driven-development.
4
+ Invoke the i3-incremental-implementation skill alongside i3-test-driven-development.
5
5
 
6
6
  ## Modes
7
7
 
8
- - `/build` — implement the next pending task, then stop (careful, one slice at a time).
9
- - `/build auto` — generate the plan if needed, get a single approval, then implement every task without stopping between them.
8
+ - `/i3-build` — implement the next pending task, then stop (careful, one slice at a time).
9
+ - `/i3-build auto` — generate the plan if needed, get a single approval, then implement every task without stopping between them.
10
10
 
11
11
  The arguments select the mode. Treat `auto` (canonical) or `all` as autonomous mode; anything else (or empty) is the default single-task mode. Note: autonomous mode is not faster per task — it runs the same test-driven loop — it only removes the human stepping between tasks.
12
12
 
@@ -23,21 +23,21 @@ Pick the next pending task from the plan. Then:
23
23
  7. Commit with a descriptive message
24
24
  8. Mark the task complete and stop
25
25
 
26
- ## Autonomous: the whole plan (`/build auto`)
26
+ ## Autonomous: the whole plan (`/i3-build auto`)
27
27
 
28
28
  Use this once a spec exists and you want to collapse plan + build into one run. It removes the manual stepping between tasks — not the verification. Every task still earns a passing test and its own commit.
29
29
 
30
- 1. Require a spec. Look only for a spec at a known path: SPEC.md at the repo root, docs/SPEC.md, or a file under spec/. A README or arbitrary doc does NOT count. If none exists, stop and tell the user to run /spec first — do not invent requirements.
30
+ 1. Require a spec. Look only for a spec at a known path: SPEC.md at the repo root, docs/SPEC.md, or a file under spec/. A README or arbitrary doc does NOT count. If none exists, stop and tell the user to run /i3-spec first — do not invent requirements.
31
31
  2. Establish a clean baseline. Run `git status --porcelain`. If there are uncommitted changes outside the expected planning artifacts (SPEC.md, docs/SPEC.md, spec/*, tasks/plan.md, tasks/todo.md), stop and ask the user to commit, stash, or confirm how to handle them. Autonomous per-task commits must not absorb unrelated local work, or the clean-rollback guarantee breaks.
32
- 3. Plan if needed. If there is no tasks/plan.md, invoke the planning-and-task-breakdown skill to generate one.
32
+ 3. Plan if needed. If there is no tasks/plan.md, invoke the i3-planning-and-task-breakdown skill to generate one.
33
33
  4. Single checkpoint. Present the full plan and wait for an unambiguous affirmative (e.g. "approve", "go", "yes"). Treat hedged responses ("looks reasonable", "I guess") as NOT approved. This is the only human gate — after approval, run autonomously. If you generated tasks/plan.md, commit it as a single preparatory commit now so it doesn't bleed into the first task's commit.
34
34
  5. Execute every task in dependency order. Use each task's declared dependencies; if they aren't explicit, execute in the order the plan lists them. For each task, run the full default loop above (RED → GREEN → regression → build → commit → mark complete). Stage only the files that task touched plus its task-status update — never `git add -A` blindly — and make one commit per task so any point is a clean rollback.
35
35
  6. Stop and ask the user (do not push through) when:
36
- - a test can't be made to pass or the build breaks without an obvious fix → follow the debugging-and-error-recovery skill
36
+ - a test can't be made to pass or the build breaks without an obvious fix → follow the i3-debugging-and-error-recovery skill
37
37
  - the spec is ambiguous, or a task needs a decision the spec doesn't cover
38
- - a task is high-risk or irreversible — auth/permission changes, destructive data migrations, payments, deletions, deploys, anything touching secrets, or anything you can't undo with `git revert` → follow the doubt-driven-development skill and get explicit sign-off before continuing
39
- After the user resolves a blocker, they re-invoke /build auto — it resumes from the next pending task.
38
+ - a task is high-risk or irreversible — auth/permission changes, destructive data migrations, payments, deletions, deploys, anything touching secrets, or anything you can't undo with `git revert` → follow the i3-doubt-driven-development skill and get explicit sign-off before continuing
39
+ After the user resolves a blocker, they re-invoke /i3-build auto — it resumes from the next pending task.
40
40
  7. Summarize at the end: tasks completed, tests added, commits made, and anything skipped, flagged, or left for the user.
41
41
 
42
- If any step fails, follow the debugging-and-error-recovery skill.
42
+ If any step fails, follow the i3-debugging-and-error-recovery skill.
43
43
  """
@@ -1,7 +1,7 @@
1
1
  description = "Simplify code for clarity and maintainability — reduce complexity without changing behavior"
2
2
 
3
3
  prompt = """
4
- Invoke the code-simplification skill.
4
+ Invoke the i3-code-simplification skill.
5
5
 
6
6
  Simplify recently changed code (or the specified scope) while preserving exact behavior:
7
7
 
@@ -18,5 +18,5 @@ Simplify recently changed code (or the specified scope) while preserving exact b
18
18
  5. Apply each simplification incrementally — run tests after each change
19
19
  6. Verify all tests pass, the build succeeds, and the diff is clean
20
20
 
21
- If tests fail after a simplification, revert that change and reconsider. Use `code-review-and-quality` to review the result.
21
+ If tests fail after a simplification, revert that change and reconsider. Use `i3-code-review-and-quality` to review the result.
22
22
  """
@@ -1,7 +1,7 @@
1
1
  description = "Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md"
2
2
 
3
3
  prompt = """
4
- Invoke the constraint-driven-development skill.
4
+ Invoke the i3-constraint-driven-development skill.
5
5
 
6
6
  $ARGUMENTS
7
7
 
@@ -26,7 +26,7 @@ Default behaviour with no arguments: set up constraints for this repository.
26
26
  7. **Verify.** Run the constraints against the current branch. If anything fails that the user disagrees with, fix the constraint now rather than leaving a gate people will learn to ignore.
27
27
 
28
28
  Sub-commands:
29
- - `/constraints check` — run the current constraints against this branch and report
30
- - `/constraints guard` — inspect the diff for a weakened bar: lowered thresholds, skipped or deleted tests, new suppression comments, unfinished stubs, new exceptions
31
- - `/constraints ratchet` — record today's measured values as the floor that must not fall
29
+ - `/i3-constraints check` — run the current constraints against this branch and report
30
+ - `/i3-constraints guard` — inspect the diff for a weakened bar: lowered thresholds, skipped or deleted tests, new suppression comments, unfinished stubs, new exceptions
31
+ - `/i3-constraints ratchet` — record today's measured values as the floor that must not fall
32
32
  """
@@ -1,7 +1,7 @@
1
1
  description = "Break work into small verifiable tasks with acceptance criteria and dependency ordering"
2
2
 
3
3
  prompt = """
4
- Invoke the planning-and-task-breakdown skill.
4
+ Invoke the i3-planning-and-task-breakdown skill.
5
5
 
6
6
  Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:
7
7
 
@@ -1,15 +1,15 @@
1
1
  description = "Conduct a five-axis code review — correctness, readability, architecture, security, performance"
2
2
 
3
3
  prompt = """
4
- Invoke the code-review-and-quality skill.
4
+ Invoke the i3-code-review-and-quality skill.
5
5
 
6
6
  Review the current changes (staged or recent commits) across all five axes:
7
7
 
8
8
  1. **Correctness** — Does it match the spec? Edge cases handled? Tests adequate?
9
9
  2. **Readability** — Clear names? Straightforward logic? Well-organized?
10
10
  3. **Architecture** — Follows existing patterns? Clean boundaries? Right abstraction level?
11
- 4. **Security** — Input validated? Secrets safe? Auth checked? (Use security-and-hardening skill)
12
- 5. **Performance** — No N+1 queries? No unbounded ops? (Use performance-optimization skill)
11
+ 4. **Security** — Input validated? Secrets safe? Auth checked? (Use i3-security-and-hardening skill)
12
+ 5. **Performance** — No N+1 queries? No unbounded ops? (Use i3-performance-optimization skill)
13
13
 
14
14
  Categorize findings as Critical, Important, or Suggestion.
15
15
  Output a structured review with specific file:line references and fix recommendations.
@@ -1,9 +1,9 @@
1
1
  description = "Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision"
2
2
 
3
3
  prompt = """
4
- Invoke the shipping-and-launch skill.
4
+ Invoke the i3-shipping-and-launch skill.
5
5
 
6
- `/ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
6
+ `/i3-ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
7
7
 
8
8
  ## Phase A — Parallel fan-out
9
9
 
@@ -22,7 +22,7 @@ Constraints (from Gemini CLI's subagent model):
22
22
  - Do not let one persona delegate to another — keep the fan-out flat.
23
23
  - For richer multi-agent collaboration where teammates talk to each other instead of just reporting back, see `references/orchestration-patterns.md`.
24
24
 
25
- **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `agents/` (this plugin's agents, at the repo root) or `~/.gemini/agents/` (user-level), those take precedence over this plugin's versions — `/ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Gemini CLI's scope priority table, so user-level definitions win by design.
25
+ **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `agents/` (this plugin's agents, at the repo root) or `~/.gemini/agents/` (user-level), those take precedence over this plugin's versions — `/i3-ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Gemini CLI's scope priority table, so user-level definitions win by design.
26
26
 
27
27
  ## Phase B — Merge in main context
28
28
 
@@ -68,5 +68,5 @@ Produce a single output:
68
68
  2. Personas do not call each other. The main agent merges in Phase B.
69
69
  3. The rollback plan is mandatory before any GO decision.
70
70
  4. If any persona returns a Critical finding, the default verdict is NO-GO unless the user explicitly accepts the risk.
71
- 5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under 50 lines, and it does not touch auth, payments, data access, or config/env. Otherwise, default to fan-out. `/ship` is designed for production-bound changes — when the blast radius is non-trivial, run the parallel review even if the diff looks small.
71
+ 5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under 50 lines, and it does not touch auth, payments, data access, or config/env. Otherwise, default to fan-out. `/i3-ship` is designed for production-bound changes — when the blast radius is non-trivial, run the parallel review even if the diff looks small.
72
72
  """
@@ -1,7 +1,7 @@
1
1
  description = "Start spec-driven development — write a structured specification before writing code"
2
2
 
3
3
  prompt = """
4
- Invoke the spec-driven-development skill.
4
+ Invoke the i3-spec-driven-development skill.
5
5
 
6
6
  Begin by understanding what the user wants to build. Ask clarifying questions about:
7
7
  1. The objective and target users
@@ -1,7 +1,7 @@
1
1
  description = "Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern."
2
2
 
3
3
  prompt = """
4
- Invoke the test-driven-development skill.
4
+ Invoke the i3-test-driven-development skill.
5
5
 
6
6
  For new features:
7
7
  1. Write tests that describe the expected behavior (they should FAIL)
@@ -15,5 +15,5 @@ For bug fixes (Prove-It pattern):
15
15
  4. Confirm the test passes
16
16
  5. Run the full test suite for regressions
17
17
 
18
- For browser-related issues, also invoke browser-testing-with-devtools to verify with Chrome DevTools MCP.
18
+ For browser-related issues, also invoke i3-browser-testing-with-devtools to verify with Chrome DevTools MCP.
19
19
  """
@@ -1,7 +1,7 @@
1
1
  description = "Run a web performance audit via the web-performance-auditor persona"
2
2
 
3
3
  prompt = """
4
- /webperf targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
4
+ /i3-webperf targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
5
5
 
6
6
  ## Determine the mode
7
7