@givolt/i3-composer-agent 0.0.0-stage → 0.6.12

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 (213) hide show
  1. package/.agents/plugins/marketplace.json +22 -0
  2. package/.claude/commands/build.md +44 -0
  3. package/.claude/commands/code-simplify.md +22 -0
  4. package/.claude/commands/constraints.md +32 -0
  5. package/.claude/commands/plan.md +18 -0
  6. package/.claude/commands/review.md +16 -0
  7. package/.claude/commands/ship.md +72 -0
  8. package/.claude/commands/spec.md +17 -0
  9. package/.claude/commands/test.md +19 -0
  10. package/.claude/commands/webperf.md +32 -0
  11. package/.claude-plugin/marketplace.json +26 -0
  12. package/.claude-plugin/plugin.json +17 -0
  13. package/.codex-plugin/plugin.json +26 -0
  14. package/.gemini/commands/build.toml +43 -0
  15. package/.gemini/commands/code-simplify.toml +22 -0
  16. package/.gemini/commands/constraints.toml +32 -0
  17. package/.gemini/commands/planning.toml +18 -0
  18. package/.gemini/commands/review.toml +16 -0
  19. package/.gemini/commands/ship.toml +72 -0
  20. package/.gemini/commands/spec.toml +17 -0
  21. package/.gemini/commands/test.toml +19 -0
  22. package/.gemini/commands/webperf.toml +32 -0
  23. package/LICENSE +21 -0
  24. package/NOTICE.md +9 -0
  25. package/README.md +177 -2
  26. package/agents/code-reviewer.md +102 -0
  27. package/agents/security-auditor.md +112 -0
  28. package/agents/test-engineer.md +95 -0
  29. package/agents/web-performance-auditor.md +184 -0
  30. package/bin/i3-composer-agent.cjs +119 -0
  31. package/commands/build.toml +43 -0
  32. package/commands/code-simplify.toml +22 -0
  33. package/commands/constraints.toml +32 -0
  34. package/commands/planning.toml +18 -0
  35. package/commands/review.toml +16 -0
  36. package/commands/ship.toml +72 -0
  37. package/commands/spec.toml +17 -0
  38. package/commands/test.toml +19 -0
  39. package/commands/webperf.toml +32 -0
  40. package/docs/adoption-guide.md +129 -0
  41. package/docs/advanced-per-agent-configuration.md +70 -0
  42. package/docs/agents.md +123 -0
  43. package/docs/antigravity-setup.md +128 -0
  44. package/docs/codebuddy-setup.md +41 -0
  45. package/docs/codex-setup.md +34 -0
  46. package/docs/commandcode-setup.md +69 -0
  47. package/docs/comparison.md +131 -0
  48. package/docs/copilot-cli-setup.md +64 -0
  49. package/docs/copilot-setup.md +162 -0
  50. package/docs/cursor-setup.md +225 -0
  51. package/docs/developer-onboarding.md +116 -0
  52. package/docs/gemini-cli-setup.md +133 -0
  53. package/docs/getting-started.md +208 -0
  54. package/docs/opencode-setup.md +259 -0
  55. package/docs/other-hosts.md +7 -0
  56. package/docs/skill-anatomy.md +203 -0
  57. package/docs/windsurf-setup.md +48 -0
  58. package/evals/README.md +101 -0
  59. package/evals/cases/api-and-interface-design.json +45 -0
  60. package/evals/cases/browser-testing-with-devtools.json +44 -0
  61. package/evals/cases/ci-cd-and-automation.json +45 -0
  62. package/evals/cases/code-review-and-quality.json +49 -0
  63. package/evals/cases/code-simplification.json +45 -0
  64. package/evals/cases/constraint-driven-development.json +79 -0
  65. package/evals/cases/context-engineering.json +44 -0
  66. package/evals/cases/debugging-and-error-recovery.json +58 -0
  67. package/evals/cases/deprecation-and-migration.json +52 -0
  68. package/evals/cases/documentation-and-adrs.json +44 -0
  69. package/evals/cases/doubt-driven-development.json +43 -0
  70. package/evals/cases/frontend-ui-engineering.json +52 -0
  71. package/evals/cases/git-workflow-and-versioning.json +47 -0
  72. package/evals/cases/idea-refine.json +43 -0
  73. package/evals/cases/incremental-implementation.json +57 -0
  74. package/evals/cases/interview-me.json +42 -0
  75. package/evals/cases/observability-and-instrumentation.json +44 -0
  76. package/evals/cases/performance-optimization.json +53 -0
  77. package/evals/cases/planning-and-task-breakdown.json +45 -0
  78. package/evals/cases/security-and-hardening.json +53 -0
  79. package/evals/cases/shipping-and-launch.json +56 -0
  80. package/evals/cases/source-driven-development.json +44 -0
  81. package/evals/cases/spec-driven-development.json +72 -0
  82. package/evals/cases/test-driven-development.json +73 -0
  83. package/evals/cases/using-agent-skills.json +44 -0
  84. package/evals/fixtures/api-and-interface-design/service-brief.md +19 -0
  85. package/evals/fixtures/browser-testing-with-devtools/README.md +5 -0
  86. package/evals/fixtures/browser-testing-with-devtools/index.html +24 -0
  87. package/evals/fixtures/browser-testing-with-devtools/server.js +15 -0
  88. package/evals/fixtures/ci-cd-and-automation/package.json +8 -0
  89. package/evals/fixtures/ci-cd-and-automation/src/slug.js +3 -0
  90. package/evals/fixtures/ci-cd-and-automation/test/slug.test.js +9 -0
  91. package/evals/fixtures/code-review-and-quality/user-search.diff +16 -0
  92. package/evals/fixtures/code-simplification/config-parser.js +46 -0
  93. package/evals/fixtures/code-simplification/config-parser.test.js +15 -0
  94. package/evals/fixtures/context-engineering/context-audit.md +15 -0
  95. package/evals/fixtures/debugging-and-error-recovery/pagination.js +8 -0
  96. package/evals/fixtures/debugging-and-error-recovery/pagination.test.js +9 -0
  97. package/evals/fixtures/debugging-and-error-recovery/time-pressure.md +6 -0
  98. package/evals/fixtures/deprecation-and-migration/api-inventory.md +9 -0
  99. package/evals/fixtures/documentation-and-adrs/decision-context.md +16 -0
  100. package/evals/fixtures/doubt-driven-development/migration-plan.md +19 -0
  101. package/evals/fixtures/frontend-ui-engineering/Button.tsx +7 -0
  102. package/evals/fixtures/frontend-ui-engineering/design-system.md +11 -0
  103. package/evals/fixtures/git-workflow-and-versioning/.eval/working-tree.patch +21 -0
  104. package/evals/fixtures/git-workflow-and-versioning/app.js +7 -0
  105. package/evals/fixtures/git-workflow-and-versioning/app.test.js +9 -0
  106. package/evals/fixtures/incremental-implementation/reports.js +7 -0
  107. package/evals/fixtures/incremental-implementation/reports.test.js +12 -0
  108. package/evals/fixtures/incremental-implementation/tasks/plan.md +8 -0
  109. package/evals/fixtures/incremental-implementation-pressure/draft-export.js +17 -0
  110. package/evals/fixtures/incremental-implementation-pressure/scenario.md +9 -0
  111. package/evals/fixtures/observability-and-instrumentation/operations.md +11 -0
  112. package/evals/fixtures/observability-and-instrumentation/payment-retry.js +14 -0
  113. package/evals/fixtures/performance-optimization/benchmark.js +15 -0
  114. package/evals/fixtures/performance-optimization/products.js +14 -0
  115. package/evals/fixtures/planning-and-task-breakdown/notifications-spec.md +18 -0
  116. package/evals/fixtures/security-and-hardening/webhook.js +11 -0
  117. package/evals/fixtures/security-and-hardening/webhook.test.js +13 -0
  118. package/evals/fixtures/shipping-and-launch/authority-pressure.md +6 -0
  119. package/evals/fixtures/shipping-and-launch/launch-status.md +11 -0
  120. package/evals/fixtures/source-driven-development/framework-task.md +10 -0
  121. package/evals/fixtures/spec-driven-development/billing-brief.md +16 -0
  122. package/evals/fixtures/spec-driven-development-decomposition/portal-brief.md +22 -0
  123. package/evals/fixtures/test-driven-development/BUG.md +10 -0
  124. package/evals/fixtures/test-driven-development/README.md +28 -0
  125. package/evals/fixtures/test-driven-development/package.json +9 -0
  126. package/evals/fixtures/test-driven-development/src/split.js +8 -0
  127. package/evals/fixtures/test-driven-development/test/split.test.js +13 -0
  128. package/evals/fixtures/test-driven-development-ecosystem/README.md +9 -0
  129. package/evals/fixtures/test-driven-development-ecosystem/ledger.py +15 -0
  130. package/evals/fixtures/test-driven-development-ecosystem/test_ledger.py +19 -0
  131. package/evals/fixtures/using-agent-skills/incident.md +6 -0
  132. package/evals/plugin/code-review-fires/graders/off-by-one.md +7 -0
  133. package/evals/plugin/code-review-fires/graders/severity-labels.md +4 -0
  134. package/evals/plugin/code-review-fires/graders/skill-fired.md +5 -0
  135. package/evals/plugin/code-review-fires/prompt.md +31 -0
  136. package/evals/plugin/code-review-stays-quiet/graders/not-fired.md +8 -0
  137. package/evals/plugin/code-review-stays-quiet/graders/tdd-fired.md +6 -0
  138. package/evals/plugin/code-review-stays-quiet/prompt.md +8 -0
  139. package/evals/plugin/code-review-stays-quiet-on-commit-message/graders/not-fired.md +8 -0
  140. package/evals/plugin/code-review-stays-quiet-on-commit-message/prompt.md +25 -0
  141. package/evals/skill-impact.md +6 -0
  142. package/hooks/SDD-CACHE.md +167 -0
  143. package/hooks/SIMPLIFY-IGNORE.md +91 -0
  144. package/hooks/sdd-cache-post.sh +135 -0
  145. package/hooks/sdd-cache-pre.sh +106 -0
  146. package/hooks/sdd-cache-test.sh +246 -0
  147. package/hooks/session-start-test.sh +47 -0
  148. package/hooks/session-start.sh +33 -0
  149. package/hooks/simplify-ignore-test.sh +476 -0
  150. package/hooks/simplify-ignore.sh +352 -0
  151. package/package.json +31 -4
  152. package/plugin.json +5 -0
  153. package/rebrand/MAINTENANCE.md +51 -0
  154. package/rebrand/apply.cjs +121 -0
  155. package/rebrand/brand.json +9 -0
  156. package/rebrand/templates/README.md +178 -0
  157. package/rebrand/templates/codebuddy-setup.md +41 -0
  158. package/rebrand/templates/codex-setup.md +34 -0
  159. package/references/accessibility-checklist.md +160 -0
  160. package/references/definition-of-done.md +67 -0
  161. package/references/observability-checklist.md +92 -0
  162. package/references/orchestration-patterns.md +370 -0
  163. package/references/performance-checklist.md +236 -0
  164. package/references/security-checklist.md +248 -0
  165. package/references/testing-patterns.md +235 -0
  166. package/scripts/floor-guard-reference-test.js +291 -0
  167. package/scripts/lib/skill-lint-test.js +650 -0
  168. package/scripts/lib/skill-lint.js +584 -0
  169. package/scripts/run-evals-test.js +623 -0
  170. package/scripts/run-evals.js +638 -0
  171. package/scripts/validate-artifact-paths-test.js +179 -0
  172. package/scripts/validate-artifact-paths.js +128 -0
  173. package/scripts/validate-brand.cjs +36 -0
  174. package/scripts/validate-commands-test.js +216 -0
  175. package/scripts/validate-commands.js +222 -0
  176. package/scripts/validate-reference-links-test.js +495 -0
  177. package/scripts/validate-reference-links.js +187 -0
  178. package/scripts/validate-skills.js +69 -0
  179. package/scripts/validate-versions-test.js +32 -0
  180. package/scripts/validate-versions.js +35 -0
  181. package/skills/api-and-interface-design/SKILL.md +367 -0
  182. package/skills/browser-testing-with-devtools/SKILL.md +317 -0
  183. package/skills/ci-cd-and-automation/SKILL.md +390 -0
  184. package/skills/code-review-and-quality/SKILL.md +398 -0
  185. package/skills/code-simplification/SKILL.md +331 -0
  186. package/skills/constraint-driven-development/SKILL.md +311 -0
  187. package/skills/constraint-driven-development/references/floor-guard.md +182 -0
  188. package/skills/context-engineering/SKILL.md +353 -0
  189. package/skills/debugging-and-error-recovery/SKILL.md +300 -0
  190. package/skills/deprecation-and-migration/SKILL.md +247 -0
  191. package/skills/documentation-and-adrs/SKILL.md +288 -0
  192. package/skills/doubt-driven-development/SKILL.md +243 -0
  193. package/skills/frontend-ui-engineering/SKILL.md +340 -0
  194. package/skills/git-workflow-and-versioning/SKILL.md +355 -0
  195. package/skills/idea-refine/SKILL.md +178 -0
  196. package/skills/idea-refine/examples.md +238 -0
  197. package/skills/idea-refine/frameworks.md +99 -0
  198. package/skills/idea-refine/refinement-criteria.md +113 -0
  199. package/skills/idea-refine/scripts/idea-refine.sh +15 -0
  200. package/skills/incremental-implementation/SKILL.md +249 -0
  201. package/skills/interview-me/SKILL.md +235 -0
  202. package/skills/observability-and-instrumentation/SKILL.md +238 -0
  203. package/skills/performance-optimization/SKILL.md +267 -0
  204. package/skills/performance-optimization/references/optimization-patterns.md +250 -0
  205. package/skills/planning-and-task-breakdown/SKILL.md +257 -0
  206. package/skills/security-and-hardening/SKILL.md +216 -0
  207. package/skills/security-and-hardening/references/hardening-patterns.md +324 -0
  208. package/skills/shipping-and-launch/SKILL.md +330 -0
  209. package/skills/source-driven-development/SKILL.md +216 -0
  210. package/skills/spec-driven-development/SKILL.md +259 -0
  211. package/skills/test-driven-development/SKILL.md +398 -0
  212. package/skills/using-agent-skills/SKILL.md +192 -0
  213. package/tests/bundle.test.cjs +79 -0
@@ -0,0 +1,45 @@
1
+ {
2
+ "skill_name": "api-and-interface-design",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Design a REST endpoint for creating invoices, including error responses and versioning",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "What should the public interface of this payments module expose to other teams?",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Help me define the contract between the frontend and the orders service",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "My unit test is failing with a null pointer exception",
21
+ "owner": "debugging-and-error-recovery"
22
+ },
23
+ {
24
+ "prompt": "Make this landing page responsive on mobile",
25
+ "owner": "frontend-ui-engineering"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Design the public API for a URL-shortening service: create, resolve, stats. Produce the endpoint contracts.",
33
+ "expected_output": "Endpoint contracts with methods, paths, request/response shapes, and explicit error semantics",
34
+ "files": [
35
+ "api-and-interface-design"
36
+ ],
37
+ "expectations": [
38
+ "Error responses are specified with status codes and a consistent error shape, not just happy paths",
39
+ "Input validation at the boundary is addressed for user-supplied URLs",
40
+ "Versioning or compatibility strategy is stated",
41
+ "The response does not silently invent unstated requirements"
42
+ ]
43
+ }
44
+ ]
45
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "skill_name": "browser-testing-with-devtools",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Use Chrome DevTools to figure out why the checkout button click does nothing",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Inspect the network requests the dashboard makes when it first loads",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Verify in a real browser that the form submits and the data persists in localStorage",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Write a spec for the new billing feature before we start",
21
+ "owner": "spec-driven-development"
22
+ },
23
+ {
24
+ "prompt": "Break this PRD into ordered implementation tasks",
25
+ "owner": "planning-and-task-breakdown"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "The signup form renders but submitting it appears to do nothing. Verify the real behavior in the browser and report findings.",
33
+ "expected_output": "Runtime evidence from the browser: console errors, network activity, DOM state, and a diagnosis",
34
+ "files": [
35
+ "browser-testing-with-devtools"
36
+ ],
37
+ "expectations": [
38
+ "Findings are grounded in observed runtime data (console, network, DOM), not static code reading alone",
39
+ "The report distinguishes what was observed from what is inferred",
40
+ "A concrete next step or fix hypothesis is provided"
41
+ ]
42
+ }
43
+ ]
44
+ }
@@ -0,0 +1,45 @@
1
+ {
2
+ "skill_name": "ci-cd-and-automation",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Set up a GitHub Actions pipeline that runs the tests on every pull request",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Add a deploy stage to the pipeline with a manual approval gate",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Automate the quality gates so nothing merges without passing checks",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Refactor this function so it is easier to read",
21
+ "owner": "code-simplification"
22
+ },
23
+ {
24
+ "prompt": "Add structured logging to the checkout service",
25
+ "owner": "observability-and-instrumentation"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Create a CI pipeline for a Node project: install, lint, test on every PR, and block merge on failure.",
33
+ "expected_output": "A working workflow definition with correct triggers, steps, and failure behavior",
34
+ "files": [
35
+ "ci-cd-and-automation"
36
+ ],
37
+ "expectations": [
38
+ "The workflow triggers on pull requests",
39
+ "Failure of any quality gate fails the pipeline run",
40
+ "Steps are ordered logically and cache or setup steps are sane",
41
+ "No secrets are hardcoded in the workflow"
42
+ ]
43
+ }
44
+ ]
45
+ }
@@ -0,0 +1,49 @@
1
+ {
2
+ "skill_name": "code-review-and-quality",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Review this pull request before I merge it",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Do a quality pass on this diff for correctness and readability",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Can you review the changes another model just wrote for me?",
15
+ "top_k": 3
16
+ },
17
+ {
18
+ "prompt": "Review this diff before I merge it. It adds paging to the orders endpoint.",
19
+ "top_k": 3
20
+ }
21
+ ],
22
+ "negative": [
23
+ {
24
+ "prompt": "Deploy this to production now",
25
+ "owner": "shipping-and-launch"
26
+ },
27
+ {
28
+ "prompt": "Write a failing test for the bug before fixing it",
29
+ "owner": "test-driven-development"
30
+ }
31
+ ]
32
+ },
33
+ "evals": [
34
+ {
35
+ "id": 1,
36
+ "prompt": "Review the provided diff that adds a user-search endpoint. Deliver a structured review.",
37
+ "expected_output": "A multi-axis review with severity-labelled findings and file:line references",
38
+ "files": [
39
+ "code-review-and-quality"
40
+ ],
41
+ "expectations": [
42
+ "Findings cover more than one axis (correctness, readability, architecture, security, performance)",
43
+ "Every finding carries a severity label from the skill's taxonomy",
44
+ "Security of user input is explicitly considered for the new endpoint",
45
+ "The review leads with high-leverage findings rather than nits"
46
+ ]
47
+ }
48
+ ]
49
+ }
@@ -0,0 +1,45 @@
1
+ {
2
+ "skill_name": "code-simplification",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "This function works but it is way too clever, simplify it without changing behavior",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "Reduce the complexity of this module so juniors can maintain it",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Clean up this working code, it has grown hard to follow",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Add a feature flag system to the app",
21
+ "owner": "incremental-implementation"
22
+ },
23
+ {
24
+ "prompt": "Diagnose why the build broke overnight",
25
+ "owner": "debugging-and-error-recovery"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "Simplify the provided 80-line function that parses config files, preserving exact behavior.",
33
+ "expected_output": "A simpler implementation with identical behavior and a summary of what was removed and why",
34
+ "files": [
35
+ "code-simplification"
36
+ ],
37
+ "expectations": [
38
+ "Behavior is preserved (tests unchanged and passing, or equivalence argued concretely)",
39
+ "Complexity is reduced rather than relocated",
40
+ "The response explains what was removed and why it was safe",
41
+ "No new features are added during the simplification"
42
+ ]
43
+ }
44
+ ]
45
+ }
@@ -0,0 +1,79 @@
1
+ {
2
+ "skill_name": "constraint-driven-development",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "Set up quality constraints for this project — I want to define our bar before the agent writes more code",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "We have no written standards. Ask me what I care about and write it down with sane defaults",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "The agent keeps adding @ts-ignore and skipping tests to get green. How do I stop that?",
15
+ "top_k": 3
16
+ },
17
+ {
18
+ "prompt": "What coverage threshold should we enforce, and where should it run so it doesn't slow us down?",
19
+ "top_k": 3
20
+ },
21
+ {
22
+ "prompt": "I care about accessibility and web performance — set those up as enforced constraints",
23
+ "top_k": 3
24
+ }
25
+ ],
26
+ "negative": [
27
+ {
28
+ "prompt": "Review this pull request across correctness and security",
29
+ "owner": "code-review-and-quality"
30
+ },
31
+ {
32
+ "prompt": "Add a deploy stage to our pipeline with a manual approval gate",
33
+ "owner": "ci-cd-and-automation"
34
+ },
35
+ {
36
+ "prompt": "Write a failing test for this bug before we fix it",
37
+ "owner": "test-driven-development"
38
+ }
39
+ ]
40
+ },
41
+ "evals": [
42
+ {
43
+ "id": 1,
44
+ "kind": "dialogue",
45
+ "prompt": "Set up constraints for this repo. I don't really know what numbers to pick.",
46
+ "expected_output": "A short interview with defaults offered, followed by a CONSTRAINTS.md the user can explain",
47
+ "expectations": [
48
+ "The agent inspects the repo for stack, test runner, and existing linters before asking anything",
49
+ "No more than four questions are asked, and each one carries a usable default",
50
+ "When the user has no target number, the agent proposes recording today's value and holding it rather than inventing a threshold",
51
+ "The resulting constraints say where each check runs, keeping fast checks in the edit loop and slow checks later",
52
+ "Every number written down is accompanied by a reason"
53
+ ]
54
+ },
55
+ {
56
+ "id": 2,
57
+ "kind": "dialogue",
58
+ "prompt": "Our coverage is 62% and I want to enforce 85% starting today.",
59
+ "expected_output": "Pushback on setting an unmeetable budget, with the ratchet alternative offered",
60
+ "expectations": [
61
+ "The agent points out that a threshold the codebase fails today produces a permanently red build",
62
+ "It offers to record 62% and require that it not fall, as an adoptable alternative",
63
+ "It does not silently accept 85% without noting the consequence"
64
+ ]
65
+ },
66
+ {
67
+ "id": 3,
68
+ "kind": "dialogue",
69
+ "prompt": "Accessibility matters to us. Add it as a constraint.",
70
+ "expected_output": "A working accessibility check, not just a threshold written down",
71
+ "expectations": [
72
+ "The agent names axe-core and gives the install and run commands rather than only stating a violation threshold",
73
+ "It notes that axe needs a running URL and asks for one, or drops the dimension if the project has no URL to hit",
74
+ "The command that produces the verdict is recorded alongside the rule in CONSTRAINTS.md",
75
+ "The check is placed at the preview-deploy stage rather than in the per-edit loop"
76
+ ]
77
+ }
78
+ ]
79
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "skill_name": "context-engineering",
3
+ "trigger": {
4
+ "positive": [
5
+ {
6
+ "prompt": "What context should I load into the agent before starting this refactor?",
7
+ "top_k": 3
8
+ },
9
+ {
10
+ "prompt": "The model's output quality dropped mid-session, how do I fix its context?",
11
+ "top_k": 3
12
+ },
13
+ {
14
+ "prompt": "Set up rules files and context packing for my repository",
15
+ "top_k": 3
16
+ }
17
+ ],
18
+ "negative": [
19
+ {
20
+ "prompt": "Write unit tests for the date parser",
21
+ "owner": "test-driven-development"
22
+ },
23
+ {
24
+ "prompt": "Harden this endpoint against SQL injection",
25
+ "owner": "security-and-hardening"
26
+ }
27
+ ]
28
+ },
29
+ "evals": [
30
+ {
31
+ "id": 1,
32
+ "prompt": "An agent session has degraded: responses are generic and it keeps forgetting project conventions. Fix the context setup.",
33
+ "expected_output": "A diagnosis of the context problem and a concrete loading strategy (rules files, packing, task-scoped context)",
34
+ "files": [
35
+ "context-engineering"
36
+ ],
37
+ "expectations": [
38
+ "The response diagnoses probable context causes rather than blaming the model generally",
39
+ "A specific context-loading plan is produced (what to load, when, and why)",
40
+ "Context is scoped to the task instead of loading everything"
41
+ ]
42
+ }
43
+ ]
44
+ }
@@ -0,0 +1,58 @@
1
+ {
2
+ "skill_name": "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": "documentation-and-adrs"
22
+ },
23
+ {
24
+ "prompt": "Simplify this working function for readability",
25
+ "owner": "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
+ "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
+ "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": "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": "frontend-ui-engineering"
30
+ },
31
+ {
32
+ "prompt": "Why is this test flaky on CI?",
33
+ "owner": "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
+ "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": "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": "debugging-and-error-recovery"
22
+ },
23
+ {
24
+ "prompt": "Harden the login endpoint against brute force attacks",
25
+ "owner": "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
+ "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": "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": "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
+ "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": "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": "performance-optimization"
30
+ },
31
+ {
32
+ "prompt": "Tag and publish the release",
33
+ "owner": "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
+ "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": "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": "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
+ "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
+ }