@givolt/i3-composer-agent 2.1.1 → 2.2.1

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 (220) hide show
  1. package/.agents/plugins/marketplace.json +2 -2
  2. package/.claude/commands/i3-build.md +13 -1
  3. package/.claude/commands/i3-code-simplify.md +13 -1
  4. package/.claude/commands/i3-constraints.md +13 -1
  5. package/.claude/commands/i3-plan.md +13 -1
  6. package/.claude/commands/i3-review.md +13 -1
  7. package/.claude/commands/i3-ship.md +18 -2
  8. package/.claude/commands/i3-spec.md +13 -1
  9. package/.claude/commands/i3-test.md +13 -1
  10. package/.claude/commands/i3-webperf.md +13 -1
  11. package/.claude-plugin/marketplace.json +3 -3
  12. package/.claude-plugin/plugin.json +2 -2
  13. package/.codex-plugin/plugin.json +7 -6
  14. package/.gemini/commands/i3-build.toml +13 -1
  15. package/.gemini/commands/i3-code-simplify.toml +13 -1
  16. package/.gemini/commands/i3-constraints.toml +13 -1
  17. package/.gemini/commands/i3-planning.toml +13 -1
  18. package/.gemini/commands/i3-review.toml +13 -1
  19. package/.gemini/commands/i3-ship.toml +13 -1
  20. package/.gemini/commands/i3-spec.toml +13 -1
  21. package/.gemini/commands/i3-test.toml +13 -1
  22. package/.gemini/commands/i3-webperf.toml +13 -1
  23. package/README.md +141 -109
  24. package/agents/code-reviewer.md +13 -1
  25. package/agents/security-auditor.md +13 -1
  26. package/agents/test-engineer.md +13 -1
  27. package/agents/web-performance-auditor.md +13 -1
  28. package/bin/asset-fingerprint.cjs +1 -0
  29. package/bin/i3-composer-agent.cjs +58 -52
  30. package/bin/install.cjs +42 -19
  31. package/bin/native-content.cjs +27 -17
  32. package/bin/tool-menu.cjs +9 -0
  33. package/bin/tool-selector.cjs +164 -0
  34. package/bin/wizard.cjs +19 -30
  35. package/commands/i3-build.toml +13 -1
  36. package/commands/i3-code-simplify.toml +13 -1
  37. package/commands/i3-constraints.toml +13 -1
  38. package/commands/i3-planning.toml +13 -1
  39. package/commands/i3-review.toml +13 -1
  40. package/commands/i3-ship.toml +13 -1
  41. package/commands/i3-spec.toml +13 -1
  42. package/commands/i3-test.toml +13 -1
  43. package/commands/i3-webperf.toml +13 -1
  44. package/docs/adoption-guide.md +8 -0
  45. package/docs/agents.md +8 -0
  46. package/docs/antigravity-setup.md +8 -0
  47. package/docs/codebuddy-setup.md +31 -62
  48. package/docs/codex-setup.md +18 -29
  49. package/docs/commandcode-setup.md +8 -0
  50. package/docs/copilot-cli-setup.md +8 -0
  51. package/docs/copilot-setup.md +8 -0
  52. package/docs/cursor-setup.md +8 -0
  53. package/docs/gemini-cli-setup.md +8 -0
  54. package/docs/getting-started.md +8 -0
  55. package/docs/opencode-setup.md +8 -0
  56. package/docs/other-hosts.md +8 -0
  57. package/docs/windsurf-setup.md +8 -0
  58. package/docs/workbuddy-setup.md +41 -65
  59. package/evals/README.md +86 -0
  60. package/evals/cases/i3-api-and-interface-design.json +45 -0
  61. package/evals/cases/i3-browser-testing-with-devtools.json +44 -0
  62. package/evals/cases/i3-ci-cd-and-automation.json +45 -0
  63. package/evals/cases/i3-code-review-and-quality.json +49 -0
  64. package/evals/cases/i3-code-simplification.json +45 -0
  65. package/evals/cases/i3-constraint-driven-development.json +79 -0
  66. package/evals/cases/i3-context-engineering.json +44 -0
  67. package/evals/cases/i3-debugging-and-error-recovery.json +58 -0
  68. package/evals/cases/i3-deprecation-and-migration.json +52 -0
  69. package/evals/cases/i3-documentation-and-adrs.json +44 -0
  70. package/evals/cases/i3-doubt-driven-development.json +43 -0
  71. package/evals/cases/i3-frontend-ui-engineering.json +52 -0
  72. package/evals/cases/i3-git-workflow-and-versioning.json +47 -0
  73. package/evals/cases/i3-idea-refine.json +43 -0
  74. package/evals/cases/i3-incremental-implementation.json +57 -0
  75. package/evals/cases/i3-interview-me.json +42 -0
  76. package/evals/cases/i3-observability-and-instrumentation.json +44 -0
  77. package/evals/cases/i3-performance-optimization.json +53 -0
  78. package/evals/cases/i3-planning-and-task-breakdown.json +45 -0
  79. package/evals/cases/i3-security-and-hardening.json +53 -0
  80. package/evals/cases/i3-shipping-and-launch.json +56 -0
  81. package/evals/cases/i3-source-driven-development.json +44 -0
  82. package/evals/cases/i3-spec-driven-development.json +72 -0
  83. package/evals/cases/i3-test-driven-development.json +73 -0
  84. package/evals/cases/i3-using-agent-skills.json +44 -0
  85. package/evals/fixtures/i3-api-and-interface-design/service-brief.md +19 -0
  86. package/evals/fixtures/i3-browser-testing-with-devtools/README.md +5 -0
  87. package/evals/fixtures/i3-browser-testing-with-devtools/index.html +24 -0
  88. package/evals/fixtures/i3-browser-testing-with-devtools/server.js +15 -0
  89. package/evals/fixtures/i3-ci-cd-and-automation/package.json +8 -0
  90. package/evals/fixtures/i3-ci-cd-and-automation/src/slug.js +3 -0
  91. package/evals/fixtures/i3-ci-cd-and-automation/test/slug.test.js +9 -0
  92. package/evals/fixtures/i3-code-review-and-quality/user-search.diff +16 -0
  93. package/evals/fixtures/i3-code-simplification/config-parser.js +46 -0
  94. package/evals/fixtures/i3-code-simplification/config-parser.test.js +15 -0
  95. package/evals/fixtures/i3-context-engineering/context-audit.md +15 -0
  96. package/evals/fixtures/i3-debugging-and-error-recovery/pagination.js +8 -0
  97. package/evals/fixtures/i3-debugging-and-error-recovery/pagination.test.js +9 -0
  98. package/evals/fixtures/i3-debugging-and-error-recovery/time-pressure.md +6 -0
  99. package/evals/fixtures/i3-deprecation-and-migration/api-inventory.md +9 -0
  100. package/evals/fixtures/i3-documentation-and-adrs/decision-context.md +16 -0
  101. package/evals/fixtures/i3-doubt-driven-development/migration-plan.md +19 -0
  102. package/evals/fixtures/i3-frontend-ui-engineering/Button.tsx +7 -0
  103. package/evals/fixtures/i3-frontend-ui-engineering/design-system.md +11 -0
  104. package/evals/fixtures/i3-git-workflow-and-versioning/.eval/working-tree.patch +21 -0
  105. package/evals/fixtures/i3-git-workflow-and-versioning/app.js +7 -0
  106. package/evals/fixtures/i3-git-workflow-and-versioning/app.test.js +9 -0
  107. package/evals/fixtures/i3-incremental-implementation/reports.js +7 -0
  108. package/evals/fixtures/i3-incremental-implementation/reports.test.js +12 -0
  109. package/evals/fixtures/i3-incremental-implementation/tasks/plan.md +8 -0
  110. package/evals/fixtures/i3-observability-and-instrumentation/operations.md +11 -0
  111. package/evals/fixtures/i3-observability-and-instrumentation/payment-retry.js +14 -0
  112. package/evals/fixtures/i3-performance-optimization/benchmark.js +15 -0
  113. package/evals/fixtures/i3-performance-optimization/products.js +14 -0
  114. package/evals/fixtures/i3-planning-and-task-breakdown/notifications-spec.md +18 -0
  115. package/evals/fixtures/i3-security-and-hardening/webhook.js +11 -0
  116. package/evals/fixtures/i3-security-and-hardening/webhook.test.js +13 -0
  117. package/evals/fixtures/i3-shipping-and-launch/authority-pressure.md +6 -0
  118. package/evals/fixtures/i3-shipping-and-launch/launch-status.md +11 -0
  119. package/evals/fixtures/i3-source-driven-development/framework-task.md +10 -0
  120. package/evals/fixtures/i3-spec-driven-development/billing-brief.md +16 -0
  121. package/evals/fixtures/i3-test-driven-development/BUG.md +10 -0
  122. package/evals/fixtures/i3-test-driven-development/README.md +28 -0
  123. package/evals/fixtures/i3-test-driven-development/package.json +9 -0
  124. package/evals/fixtures/i3-test-driven-development/src/split.js +8 -0
  125. package/evals/fixtures/i3-test-driven-development/test/split.test.js +13 -0
  126. package/evals/fixtures/i3-using-agent-skills/incident.md +6 -0
  127. package/evals/fixtures/incremental-implementation-pressure/draft-export.js +17 -0
  128. package/evals/fixtures/incremental-implementation-pressure/scenario.md +9 -0
  129. package/evals/fixtures/spec-driven-development-decomposition/portal-brief.md +22 -0
  130. package/evals/fixtures/test-driven-development-ecosystem/README.md +9 -0
  131. package/evals/fixtures/test-driven-development-ecosystem/ledger.py +15 -0
  132. package/evals/fixtures/test-driven-development-ecosystem/test_ledger.py +19 -0
  133. package/evals/plugin/code-review-fires/graders/off-by-one.md +7 -0
  134. package/evals/plugin/code-review-fires/graders/severity-labels.md +4 -0
  135. package/evals/plugin/code-review-fires/graders/skill-fired.md +5 -0
  136. package/evals/plugin/code-review-fires/prompt.md +31 -0
  137. package/evals/plugin/code-review-stays-quiet/graders/not-fired.md +8 -0
  138. package/evals/plugin/code-review-stays-quiet/graders/tdd-fired.md +6 -0
  139. package/evals/plugin/code-review-stays-quiet/prompt.md +8 -0
  140. package/evals/plugin/code-review-stays-quiet-on-commit-message/graders/not-fired.md +8 -0
  141. package/evals/plugin/code-review-stays-quiet-on-commit-message/prompt.md +25 -0
  142. package/evals/zh-CN/cases/i3-api-and-interface-design.json +46 -0
  143. package/evals/zh-CN/cases/i3-browser-testing-with-devtools.json +45 -0
  144. package/evals/zh-CN/cases/i3-ci-cd-and-automation.json +46 -0
  145. package/evals/zh-CN/cases/i3-code-review-and-quality.json +46 -0
  146. package/evals/zh-CN/cases/i3-code-simplification.json +46 -0
  147. package/evals/zh-CN/cases/i3-constraint-driven-development.json +70 -0
  148. package/evals/zh-CN/cases/i3-context-engineering.json +45 -0
  149. package/evals/zh-CN/cases/i3-debugging-and-error-recovery.json +60 -0
  150. package/evals/zh-CN/cases/i3-deprecation-and-migration.json +45 -0
  151. package/evals/zh-CN/cases/i3-documentation-and-adrs.json +45 -0
  152. package/evals/zh-CN/cases/i3-doubt-driven-development.json +45 -0
  153. package/evals/zh-CN/cases/i3-frontend-ui-engineering.json +45 -0
  154. package/evals/zh-CN/cases/i3-git-workflow-and-versioning.json +45 -0
  155. package/evals/zh-CN/cases/i3-idea-refine.json +44 -0
  156. package/evals/zh-CN/cases/i3-incremental-implementation.json +59 -0
  157. package/evals/zh-CN/cases/i3-interview-me.json +43 -0
  158. package/evals/zh-CN/cases/i3-observability-and-instrumentation.json +46 -0
  159. package/evals/zh-CN/cases/i3-performance-optimization.json +46 -0
  160. package/evals/zh-CN/cases/i3-planning-and-task-breakdown.json +46 -0
  161. package/evals/zh-CN/cases/i3-security-and-hardening.json +46 -0
  162. package/evals/zh-CN/cases/i3-shipping-and-launch.json +59 -0
  163. package/evals/zh-CN/cases/i3-source-driven-development.json +45 -0
  164. package/evals/zh-CN/cases/i3-spec-driven-development.json +62 -0
  165. package/evals/zh-CN/cases/i3-test-driven-development.json +76 -0
  166. package/evals/zh-CN/cases/i3-using-agent-skills.json +45 -0
  167. package/hooks/SDD-CACHE.md +8 -0
  168. package/hooks/SIMPLIFY-IGNORE.md +8 -0
  169. package/hooks/sdd-cache-pre.sh +5 -5
  170. package/hooks/session-start-test.sh +1 -1
  171. package/hooks/session-start.sh +3 -3
  172. package/hooks/simplify-ignore.sh +8 -8
  173. package/package.json +235 -6
  174. package/plugin.json +2 -2
  175. package/references/accessibility-checklist.md +8 -0
  176. package/references/definition-of-done.md +8 -0
  177. package/references/observability-checklist.md +8 -0
  178. package/references/orchestration-patterns.md +8 -0
  179. package/references/performance-checklist.md +8 -0
  180. package/references/security-checklist.md +8 -0
  181. package/references/testing-patterns.md +8 -0
  182. package/scripts/lib/skill-lint.js +586 -0
  183. package/scripts/run-evals.js +659 -0
  184. package/scripts/validate-artifact-paths.js +130 -0
  185. package/scripts/validate-commands.js +224 -0
  186. package/scripts/validate-reference-links.js +187 -0
  187. package/scripts/validate-skills.js +70 -0
  188. package/scripts/validate-versions.js +35 -0
  189. package/skills/i3-api-and-interface-design/SKILL.md +13 -1
  190. package/skills/i3-browser-testing-with-devtools/SKILL.md +13 -1
  191. package/skills/i3-ci-cd-and-automation/SKILL.md +13 -1
  192. package/skills/i3-code-review-and-quality/SKILL.md +13 -1
  193. package/skills/i3-code-simplification/SKILL.md +13 -1
  194. package/skills/i3-constraint-driven-development/SKILL.md +13 -1
  195. package/skills/i3-constraint-driven-development/references/floor-guard.md +8 -0
  196. package/skills/i3-context-engineering/SKILL.md +13 -1
  197. package/skills/i3-debugging-and-error-recovery/SKILL.md +13 -1
  198. package/skills/i3-deprecation-and-migration/SKILL.md +13 -1
  199. package/skills/i3-documentation-and-adrs/SKILL.md +13 -1
  200. package/skills/i3-doubt-driven-development/SKILL.md +13 -1
  201. package/skills/i3-frontend-ui-engineering/SKILL.md +13 -1
  202. package/skills/i3-git-workflow-and-versioning/SKILL.md +13 -1
  203. package/skills/i3-idea-refine/SKILL.md +13 -1
  204. package/skills/i3-idea-refine/examples.md +8 -0
  205. package/skills/i3-idea-refine/frameworks.md +8 -0
  206. package/skills/i3-idea-refine/refinement-criteria.md +8 -0
  207. package/skills/i3-idea-refine/scripts/idea-refine.sh +2 -2
  208. package/skills/i3-incremental-implementation/SKILL.md +13 -1
  209. package/skills/i3-interview-me/SKILL.md +13 -1
  210. package/skills/i3-observability-and-instrumentation/SKILL.md +13 -1
  211. package/skills/i3-performance-optimization/SKILL.md +13 -1
  212. package/skills/i3-performance-optimization/references/optimization-patterns.md +8 -0
  213. package/skills/i3-planning-and-task-breakdown/SKILL.md +13 -1
  214. package/skills/i3-security-and-hardening/SKILL.md +13 -1
  215. package/skills/i3-security-and-hardening/references/hardening-patterns.md +8 -0
  216. package/skills/i3-shipping-and-launch/SKILL.md +13 -1
  217. package/skills/i3-source-driven-development/SKILL.md +13 -1
  218. package/skills/i3-spec-driven-development/SKILL.md +13 -1
  219. package/skills/i3-test-driven-development/SKILL.md +13 -1
  220. package/skills/i3-using-agent-skills/SKILL.md +13 -1
@@ -0,0 +1,58 @@
1
+ {
2
+ "skill_name": "i3-debugging-and-error-recovery",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "The app crashes with a TypeError when I click save, help me find the root cause",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "The API is throwing intermittent 500 errors in production, help me find the root cause",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "This test passed yesterday and fails today, figure out what broke",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Write the API documentation for the orders service",
21
+ "owner": "i3-documentation-and-adrs"
22
+ },
23
+ {
24
+ "prompt": "Simplify this working function for readability",
25
+ "owner": "i3-code-simplification"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "A test that passed yesterday now fails with an off-by-one error in pagination. Find and fix the root cause.",
33
+ "expected_output": "A reproduced failure, an identified root cause, a minimal fix, and a guard against regression",
34
+ "files": [
35
+ "i3-debugging-and-error-recovery"
36
+ ],
37
+ "expectations": [
38
+ "The failure is reproduced before any fix is attempted",
39
+ "The root cause is identified and stated, not just the symptom patched",
40
+ "A regression test exists after the fix",
41
+ "The fix is minimal and scoped to the cause"
42
+ ]
43
+ },
44
+ {
45
+ "id": 2,
46
+ "prompt": "Production checkout is failing and a stakeholder demands an immediate pagination patch without reproduction. Respond under time pressure.",
47
+ "expected_output": "Evidence preserved, the failure reproduced, and a root-cause fix guarded by a regression test",
48
+ "files": [
49
+ "i3-debugging-and-error-recovery"
50
+ ],
51
+ "expectations": [
52
+ "The time pressure does not cause reproduction or evidence gathering to be skipped",
53
+ "The requested speculative patch is not applied before the cause is localized",
54
+ "The final fix is tied to a reproduced cause and a regression test"
55
+ ]
56
+ }
57
+ ]
58
+ }
@@ -0,0 +1,52 @@
1
+ {
2
+ "skill_name": "i3-deprecation-and-migration",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "We are sunsetting the v1 API, plan the deprecation",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Migrate users off the legacy auth system without breaking them",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "How do I remove this old feature safely for existing users?",
15
+ "top_k": 3
16
+ },
17
+ {
18
+ "prompt": "Rename a database column without downtime",
19
+ "top_k": 3
20
+ },
21
+ {
22
+ "prompt": "How do I drop a column safely in production?",
23
+ "top_k": 3
24
+ }
25
+ ],
26
+ "negative": [
27
+ {
28
+ "prompt": "Add dark mode to the settings page",
29
+ "owner": "i3-frontend-ui-engineering"
30
+ },
31
+ {
32
+ "prompt": "Why is this test flaky on CI?",
33
+ "owner": "i3-ci-cd-and-automation"
34
+ }
35
+ ]
36
+ },
37
+ "evals": [
38
+ {
39
+ "id": 1,
40
+ "prompt": "Plan the deprecation of a public v1 REST API with 200 external consumers, replaced by v2.",
41
+ "expected_output": "A staged deprecation plan: comms, timeline, compatibility window, monitoring, and removal criteria",
42
+ "files": [
43
+ "i3-deprecation-and-migration"
44
+ ],
45
+ "expectations": [
46
+ "Consumers are notified with a timeline before any breaking change",
47
+ "A compatibility or migration window exists with monitoring of remaining usage",
48
+ "Removal is gated on measured migration, not a calendar date alone"
49
+ ]
50
+ }
51
+ ]
52
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "skill_name": "i3-documentation-and-adrs",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Write an ADR for choosing Postgres over MongoDB",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Document the architecture decision behind the queue design",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Update the documentation for the new setup flow and record why it changed",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Find the root cause of the memory leak in the worker",
21
+ "owner": "i3-debugging-and-error-recovery"
22
+ },
23
+ {
24
+ "prompt": "Harden the login endpoint against brute force attacks",
25
+ "owner": "i3-security-and-hardening"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Record the decision to adopt event sourcing for the orders service as an ADR.",
33
+ "expected_output": "An ADR capturing context, decision, alternatives considered, and consequences",
34
+ "files": [
35
+ "i3-documentation-and-adrs"
36
+ ],
37
+ "expectations": [
38
+ "The ADR states context, decision, alternatives, and consequences distinctly",
39
+ "Trade-offs and rejected options are recorded, not just the winning choice",
40
+ "The ADR records a status from the skill's lifecycle (Proposed, Accepted, Superseded or Deprecated) and a date"
41
+ ]
42
+ }
43
+ ]
44
+ }
@@ -0,0 +1,43 @@
1
+ {
2
+ "skill_name": "i3-doubt-driven-development",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "This change touches production auth, cross-examine every assumption before we proceed",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "I am not confident in this approach, adversarially review my reasoning in a fresh context",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "High-stakes migration tomorrow, stress the plan for hidden failure modes",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Format this file with prettier"
21
+ },
22
+ {
23
+ "prompt": "Write the changelog entry for the release",
24
+ "owner": "i3-git-workflow-and-versioning"
25
+ }
26
+ ]
27
+ },
28
+ "evals": [
29
+ {
30
+ "id": 1,
31
+ "prompt": "Before running an irreversible data migration, subject the migration plan to adversarial review.",
32
+ "expected_output": "Claims extracted, doubts raised against each, reconciliation, and a go or stop verdict",
33
+ "files": [
34
+ "i3-doubt-driven-development"
35
+ ],
36
+ "expectations": [
37
+ "Non-trivial claims in the plan are extracted and challenged individually",
38
+ "At least one assumption is tested rather than accepted",
39
+ "The verdict distinguishes verified claims from surviving doubts"
40
+ ]
41
+ }
42
+ ]
43
+ }
@@ -0,0 +1,52 @@
1
+ {
2
+ "skill_name": "i3-frontend-ui-engineering",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Make this page responsive and WCAG compliant",
7
+ "top_k": 1
8
+ },
9
+ {
10
+ "prompt": "Build an accessible modal component with keyboard support",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Make the pricing page accessible and responsive on mobile",
15
+ "top_k": 1
16
+ },
17
+ {
18
+ "prompt": "Refactor the dashboard into reusable components with sane state management",
19
+ "top_k": 3
20
+ },
21
+ {
22
+ "prompt": "Rework the profile page into reusable components with proper state management",
23
+ "top_k": 3
24
+ }
25
+ ],
26
+ "negative": [
27
+ {
28
+ "prompt": "Optimize the slow database indexes",
29
+ "owner": "i3-performance-optimization"
30
+ },
31
+ {
32
+ "prompt": "Tag and publish the release",
33
+ "owner": "i3-git-workflow-and-versioning"
34
+ }
35
+ ]
36
+ },
37
+ "evals": [
38
+ {
39
+ "id": 1,
40
+ "prompt": "Build a dropdown menu component for the design system.",
41
+ "expected_output": "An accessible, keyboard-navigable component following project conventions",
42
+ "files": [
43
+ "i3-frontend-ui-engineering"
44
+ ],
45
+ "expectations": [
46
+ "Keyboard interaction and focus management are implemented, not just mouse clicks",
47
+ "ARIA roles or semantic elements are used correctly",
48
+ "Component state is managed deliberately rather than ad hoc"
49
+ ]
50
+ }
51
+ ]
52
+ }
@@ -0,0 +1,47 @@
1
+ {
2
+ "skill_name": "i3-git-workflow-and-versioning",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Split this messy working tree into clean atomic commits",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Resolve the merge conflict on this feature branch",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "How should we tag and version this release?",
15
+ "top_k": 3
16
+ },
17
+ {
18
+ "prompt": "Commit this work and open a pull request",
19
+ "top_k": 3
20
+ }
21
+ ],
22
+ "negative": [
23
+ {
24
+ "prompt": "Add a loading spinner to the submit button"
25
+ },
26
+ {
27
+ "prompt": "Write integration tests for the payments API",
28
+ "owner": "i3-test-driven-development"
29
+ }
30
+ ]
31
+ },
32
+ "evals": [
33
+ {
34
+ "id": 1,
35
+ "prompt": "The working tree mixes a refactor, a bug fix, and a new feature. Turn it into a clean history.",
36
+ "expected_output": "Separate atomic commits with clear messages, each independently green",
37
+ "files": [
38
+ "i3-git-workflow-and-versioning"
39
+ ],
40
+ "expectations": [
41
+ "Refactor, fix, and feature land as separate commits",
42
+ "Commit messages are imperative and standalone",
43
+ "Each commit leaves the tree in a working state"
44
+ ]
45
+ }
46
+ ]
47
+ }
@@ -0,0 +1,43 @@
1
+ {
2
+ "skill_name": "i3-idea-refine",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "I have a rough idea for a habit tracker, help me refine it",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Stress-test my plan for the new onboarding flow",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Ideate on ways to improve developer retention in the product",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Fix the failing CI pipeline",
21
+ "owner": "i3-ci-cd-and-automation"
22
+ },
23
+ {
24
+ "prompt": "Audit the upload endpoint for vulnerabilities",
25
+ "owner": "i3-security-and-hardening"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "kind": "dialogue",
33
+ "prompt": "Refine this vague idea: 'some kind of tool that helps teams share knowledge better'.",
34
+ "expected_output": "Sharpening questions, distinct directions, surfaced assumptions, and a one-pager with MVP scope and a Not Doing list",
35
+ "expectations": [
36
+ "Sharpening questions are asked before converging",
37
+ "Hidden assumptions are surfaced explicitly",
38
+ "The output includes an explicit Not Doing list",
39
+ "The agent pushes back on weak aspects instead of only agreeing"
40
+ ]
41
+ }
42
+ ]
43
+ }
@@ -0,0 +1,57 @@
1
+ {
2
+ "skill_name": "i3-incremental-implementation",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Implement the next task from the plan as a small verifiable slice",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Build this feature step by step, committing after each working increment",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Ship this change behind a feature flag in thin slices",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "What alerts should we page on for the new service?",
21
+ "owner": "i3-observability-and-instrumentation"
22
+ },
23
+ {
24
+ "prompt": "Interview me to figure out the real requirements",
25
+ "owner": "i3-interview-me"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Implement CSV export for the reports page, working from the existing task plan.",
33
+ "expected_output": "The feature delivered in small verified increments with a commit per slice",
34
+ "files": [
35
+ "i3-incremental-implementation"
36
+ ],
37
+ "expectations": [
38
+ "Work proceeds in thin vertical slices rather than one large change",
39
+ "Each slice is verified (tests or build) before the next begins",
40
+ "Each slice is committed separately"
41
+ ]
42
+ },
43
+ {
44
+ "id": 2,
45
+ "prompt": "A two-day CSV export draft mixes every layer and has no tests, but management says splitting it would waste the sunk effort. Decide how to proceed.",
46
+ "expected_output": "The draft is converted into small independently verified slices without accepting sunk cost as a reason to batch",
47
+ "files": [
48
+ "incremental-implementation-pressure"
49
+ ],
50
+ "expectations": [
51
+ "Sunk cost is not accepted as a reason to commit the unverified batch",
52
+ "The work is decomposed into independently useful vertical slices",
53
+ "Verification is required before each slice is committed"
54
+ ]
55
+ }
56
+ ]
57
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "skill_name": "i3-interview-me",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Interview me about what I actually want before you build anything",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Grill me on the requirements, the ask is fuzzy",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Ask me one question at a time until you understand the feature",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Run the full test suite and report failures",
21
+ "owner": "i3-test-driven-development"
22
+ },
23
+ {
24
+ "prompt": "Deploy the current build to staging",
25
+ "owner": "i3-shipping-and-launch"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "kind": "dialogue",
33
+ "prompt": "I want 'a better admin page'. Interview me before proposing anything.",
34
+ "expected_output": "A one-question-at-a-time interview that converges on validated requirements",
35
+ "expectations": [
36
+ "Questions are asked one at a time, not in batches",
37
+ "The agent does not propose solutions before understanding the need",
38
+ "The interview surfaces the underlying goal behind the stated ask"
39
+ ]
40
+ }
41
+ ]
42
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "skill_name": "i3-observability-and-instrumentation",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Add structured logging and metrics to the checkout service",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Set up tracing so we can follow a request across services",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "What alerts should we page on for this new endpoint?",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Simplify this over-clever component",
21
+ "owner": "i3-code-simplification"
22
+ },
23
+ {
24
+ "prompt": "Draft the PRD for the referral program"
25
+ }
26
+ ]
27
+ },
28
+ "evals": [
29
+ {
30
+ "id": 1,
31
+ "prompt": "Instrument a new payment-retry feature so on-call can operate it.",
32
+ "expected_output": "On-call questions defined first, then structured logs, RED metrics, and symptom-based alerts that answer them",
33
+ "files": [
34
+ "i3-observability-and-instrumentation"
35
+ ],
36
+ "expectations": [
37
+ "On-call questions are written before instrumentation is added",
38
+ "Logs are structured events with a correlation id, not prose strings",
39
+ "Metrics avoid unbounded label cardinality",
40
+ "Alerts are symptom-based and actionable"
41
+ ]
42
+ }
43
+ ]
44
+ }
@@ -0,0 +1,53 @@
1
+ {
2
+ "skill_name": "i3-performance-optimization",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Optimize this N+1 query",
7
+ "top_k": 1
8
+ },
9
+ {
10
+ "prompt": "The dashboard takes eight seconds to load, profile it and fix the bottleneck",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Profile these slow database queries and add the right indexes",
15
+ "top_k": 1
16
+ },
17
+ {
18
+ "prompt": "The orders endpoint has a slow N+1 query pattern, profile it and fix the bottleneck",
19
+ "top_k": 3
20
+ },
21
+ {
22
+ "prompt": "Core Web Vitals are failing, improve our LCP",
23
+ "top_k": 3
24
+ }
25
+ ],
26
+ "negative": [
27
+ {
28
+ "prompt": "Draft the deprecation notice for the v1 API",
29
+ "owner": "i3-deprecation-and-migration"
30
+ },
31
+ {
32
+ "prompt": "Design the public interface for the billing module",
33
+ "owner": "i3-api-and-interface-design"
34
+ }
35
+ ]
36
+ },
37
+ "evals": [
38
+ {
39
+ "id": 1,
40
+ "prompt": "The products page renders slowly with 1000 items. Improve its performance.",
41
+ "expected_output": "A measured baseline, an identified bottleneck, a targeted fix, a verified improvement, and a regression guard",
42
+ "files": [
43
+ "i3-performance-optimization"
44
+ ],
45
+ "expectations": [
46
+ "Performance is measured before any optimization is applied",
47
+ "The fix targets the measured bottleneck rather than guessing",
48
+ "Improvement is verified against the baseline after the change",
49
+ "A concrete guard is added after verification using a synthetic performance budget or field monitoring tied to the measured user-facing metric"
50
+ ]
51
+ }
52
+ ]
53
+ }
@@ -0,0 +1,45 @@
1
+ {
2
+ "skill_name": "i3-planning-and-task-breakdown",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Break this spec into small verifiable tasks with acceptance criteria",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Turn the PRD into an ordered task list we can execute",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Plan the work into implementable chunks before we start coding",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Debug the crash on startup",
21
+ "owner": "i3-debugging-and-error-recovery"
22
+ },
23
+ {
24
+ "prompt": "Encode the output so it is safe against XSS",
25
+ "owner": "i3-security-and-hardening"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Break the attached notifications spec into an executable plan.",
33
+ "expected_output": "Ordered tasks in tasks/plan.md, each small, verifiable, with acceptance criteria and dependencies",
34
+ "files": [
35
+ "i3-planning-and-task-breakdown"
36
+ ],
37
+ "expectations": [
38
+ "Every task has acceptance criteria",
39
+ "Tasks are ordered by dependency",
40
+ "Tasks are vertical slices rather than horizontal layers",
41
+ "No implementation code is written during planning"
42
+ ]
43
+ }
44
+ ]
45
+ }
@@ -0,0 +1,53 @@
1
+ {
2
+ "skill_name": "i3-security-and-hardening",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Audit this file upload handler for vulnerabilities",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Is this login flow safe against the OWASP top ten?",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Harden the webhook endpoint that fetches user-supplied URLs",
15
+ "top_k": 3
16
+ },
17
+ {
18
+ "prompt": "Run a dependency audit and triage the findings",
19
+ "top_k": 3
20
+ },
21
+ {
22
+ "prompt": "Is this new package safe to install? Check for typosquatting and supply chain risk",
23
+ "top_k": 3
24
+ }
25
+ ],
26
+ "negative": [
27
+ {
28
+ "prompt": "Rename these variables for clarity",
29
+ "owner": "i3-code-simplification"
30
+ },
31
+ {
32
+ "prompt": "Set up the release tagging workflow",
33
+ "owner": "i3-git-workflow-and-versioning"
34
+ }
35
+ ]
36
+ },
37
+ "evals": [
38
+ {
39
+ "id": 1,
40
+ "prompt": "Harden an endpoint that accepts a user-supplied webhook URL and fetches it server-side.",
41
+ "expected_output": "Threat-modeled hardening: allowlisting, private-IP blocking, and validated input with tests",
42
+ "files": [
43
+ "i3-security-and-hardening"
44
+ ],
45
+ "expectations": [
46
+ "Trust boundaries are identified before controls are proposed",
47
+ "SSRF protections cover private and reserved addresses, not just scheme checks",
48
+ "Input validation is enforced at the boundary",
49
+ "No secrets are logged or exposed in errors"
50
+ ]
51
+ }
52
+ ]
53
+ }