claude-code-kit 0.7.0__py3-none-any.whl

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 (209) hide show
  1. claude_code_kit-0.7.0.dist-info/METADATA +384 -0
  2. claude_code_kit-0.7.0.dist-info/RECORD +209 -0
  3. claude_code_kit-0.7.0.dist-info/WHEEL +4 -0
  4. claude_code_kit-0.7.0.dist-info/entry_points.txt +4 -0
  5. claude_code_kit-0.7.0.dist-info/licenses/LICENSE +21 -0
  6. claude_kit/__init__.py +10 -0
  7. claude_kit/__main__.py +8 -0
  8. claude_kit/_payload/agents/acceptance-reviewer.md +60 -0
  9. claude_kit/_payload/agents/auditor.md +76 -0
  10. claude_kit/_payload/agents/dependency-scanner.md +84 -0
  11. claude_kit/_payload/agents/developer.md +187 -0
  12. claude_kit/_payload/agents/devils-advocate.md +62 -0
  13. claude_kit/_payload/agents/devops-engineer.md +134 -0
  14. claude_kit/_payload/agents/e2e-tester.md +152 -0
  15. claude_kit/_payload/agents/em-reviewer.md +105 -0
  16. claude_kit/_payload/agents/incident-responder.md +64 -0
  17. claude_kit/_payload/agents/merge-reviewer.md +194 -0
  18. claude_kit/_payload/agents/observability-engineer.md +94 -0
  19. claude_kit/_payload/agents/orchestrator.md +551 -0
  20. claude_kit/_payload/agents/owasp-reviewer.md +76 -0
  21. claude_kit/_payload/agents/policy-validator.md +63 -0
  22. claude_kit/_payload/agents/pr-raiser.md +138 -0
  23. claude_kit/_payload/agents/risk-classifier.md +50 -0
  24. claude_kit/_payload/agents/sdlc-code-reviewer.md +196 -0
  25. claude_kit/_payload/agents/secret-scanner.md +70 -0
  26. claude_kit/_payload/agents/security-reviewer.md +80 -0
  27. claude_kit/_payload/agents/senior-backend-dev.md +199 -0
  28. claude_kit/_payload/agents/senior-frontend-dev.md +181 -0
  29. claude_kit/_payload/agents/senior-tester.md +206 -0
  30. claude_kit/_payload/agents/spec-doc-writer.md +331 -0
  31. claude_kit/_payload/agents/story-planner.md +56 -0
  32. claude_kit/_payload/agents/technical-architect.md +139 -0
  33. claude_kit/_payload/agents/tester.md +193 -0
  34. claude_kit/_payload/agents/ui-designer.md +73 -0
  35. claude_kit/_payload/agents/unit-tester.md +119 -0
  36. claude_kit/_payload/catalog/mcp.yaml +54 -0
  37. claude_kit/_payload/catalog/org.yaml +145 -0
  38. claude_kit/_payload/catalog/profiles.yaml +96 -0
  39. claude_kit/_payload/catalog/stacks.yaml +96 -0
  40. claude_kit/_payload/commands/init.md +36 -0
  41. claude_kit/_payload/commands/sdlc.md +18 -0
  42. claude_kit/_payload/commands/status.md +20 -0
  43. claude_kit/_payload/hooks/hooks.json +58 -0
  44. claude_kit/_payload/hooks/scripts/audit-log.sh +18 -0
  45. claude_kit/_payload/hooks/scripts/guard-secrets.sh +26 -0
  46. claude_kit/_payload/hooks/scripts/lint-fix.sh +38 -0
  47. claude_kit/_payload/hooks/scripts/load-continuity.sh +32 -0
  48. claude_kit/_payload/hooks/scripts/load-learnings.sh +40 -0
  49. claude_kit/_payload/hooks/scripts/type-check.sh +23 -0
  50. claude_kit/_payload/hooks/scripts/validate-frontmatter.sh +34 -0
  51. claude_kit/_payload/hooks/scripts/validate-settings.sh +21 -0
  52. claude_kit/_payload/hooks/scripts/warn-large-edits.sh +24 -0
  53. claude_kit/_payload/hooks/scripts/warn-missing-tests.sh +24 -0
  54. claude_kit/_payload/hooks/scripts/warn-sensitive-files.sh +30 -0
  55. claude_kit/_payload/hooks/scripts/warn-shared-modules.sh +33 -0
  56. claude_kit/_payload/rules/agent-guardrails.md +83 -0
  57. claude_kit/_payload/rules/agent-memory.md +106 -0
  58. claude_kit/_payload/rules/agent-resilience.md +61 -0
  59. claude_kit/_payload/rules/autonomy-levels.md +30 -0
  60. claude_kit/_payload/rules/code-organization.md +312 -0
  61. claude_kit/_payload/rules/continuity.md +84 -0
  62. claude_kit/_payload/rules/design-patterns.md +422 -0
  63. claude_kit/_payload/rules/devops-observability.md +57 -0
  64. claude_kit/_payload/rules/documentation.md +326 -0
  65. claude_kit/_payload/rules/evals.md +62 -0
  66. claude_kit/_payload/rules/frontend-best-practices.md +157 -0
  67. claude_kit/_payload/rules/goal-setting-and-monitoring.md +72 -0
  68. claude_kit/_payload/rules/human-in-the-loop.md +64 -0
  69. claude_kit/_payload/rules/linting-and-formatting.md +220 -0
  70. claude_kit/_payload/rules/mandatory-workflow.md +309 -0
  71. claude_kit/_payload/rules/model-tiers.md +34 -0
  72. claude_kit/_payload/rules/quality-gates.md +107 -0
  73. claude_kit/_payload/rules/rarv-cycle.md +31 -0
  74. claude_kit/_payload/rules/reasoning-techniques.md +62 -0
  75. claude_kit/_payload/rules/responsive-and-accessibility.md +353 -0
  76. claude_kit/_payload/rules/risk-classification.md +36 -0
  77. claude_kit/_payload/rules/testing.md +417 -0
  78. claude_kit/_payload/rules/tool-design.md +66 -0
  79. claude_kit/_payload/skills/_references/accessibility-checklist.md +160 -0
  80. claude_kit/_payload/skills/_references/orchestration-patterns.md +405 -0
  81. claude_kit/_payload/skills/_references/performance-checklist.md +153 -0
  82. claude_kit/_payload/skills/_references/security-checklist.md +134 -0
  83. claude_kit/_payload/skills/_references/testing-patterns.md +236 -0
  84. claude_kit/_payload/skills/accessibility-review/SKILL.md +56 -0
  85. claude_kit/_payload/skills/api-and-interface-design/SKILL.md +294 -0
  86. claude_kit/_payload/skills/api-integration/SKILL.md +348 -0
  87. claude_kit/_payload/skills/archive-sprint/SKILL.md +31 -0
  88. claude_kit/_payload/skills/backlog/SKILL.md +41 -0
  89. claude_kit/_payload/skills/backlog/item-template.md +20 -0
  90. claude_kit/_payload/skills/browser-testing-with-devtools/SKILL.md +302 -0
  91. claude_kit/_payload/skills/ci-cd-and-automation/SKILL.md +402 -0
  92. claude_kit/_payload/skills/code-review-and-quality/SKILL.md +347 -0
  93. claude_kit/_payload/skills/code-simplification/SKILL.md +331 -0
  94. claude_kit/_payload/skills/component-design/SKILL.md +171 -0
  95. claude_kit/_payload/skills/consolidate-learnings/SKILL.md +55 -0
  96. claude_kit/_payload/skills/context-engineering/SKILL.md +321 -0
  97. claude_kit/_payload/skills/debugging-and-error-recovery/SKILL.md +300 -0
  98. claude_kit/_payload/skills/decision/SKILL.md +46 -0
  99. claude_kit/_payload/skills/decision/adr-template.md +36 -0
  100. claude_kit/_payload/skills/deprecation-and-migration/SKILL.md +207 -0
  101. claude_kit/_payload/skills/documentation-and-adrs/SKILL.md +299 -0
  102. claude_kit/_payload/skills/doubt-driven-development/SKILL.md +243 -0
  103. claude_kit/_payload/skills/execute/SKILL.md +27 -0
  104. claude_kit/_payload/skills/frontend-ui-engineering/SKILL.md +328 -0
  105. claude_kit/_payload/skills/git-workflow-and-versioning/SKILL.md +300 -0
  106. claude_kit/_payload/skills/idea-refine/SKILL.md +178 -0
  107. claude_kit/_payload/skills/idea-refine/examples.md +238 -0
  108. claude_kit/_payload/skills/idea-refine/frameworks.md +99 -0
  109. claude_kit/_payload/skills/idea-refine/refinement-criteria.md +113 -0
  110. claude_kit/_payload/skills/idea-refine/scripts/idea-refine.sh +15 -0
  111. claude_kit/_payload/skills/incident-postmortem/SKILL.md +74 -0
  112. claude_kit/_payload/skills/incremental-implementation/SKILL.md +245 -0
  113. claude_kit/_payload/skills/interview-me/SKILL.md +221 -0
  114. claude_kit/_payload/skills/load-testing/SKILL.md +83 -0
  115. claude_kit/_payload/skills/manual-test/SKILL.md +516 -0
  116. claude_kit/_payload/skills/performance-optimization/SKILL.md +277 -0
  117. claude_kit/_payload/skills/planning-and-task-breakdown/SKILL.md +223 -0
  118. claude_kit/_payload/skills/playwright-verification/SKILL.md +205 -0
  119. claude_kit/_payload/skills/refresh-docs/SKILL.md +63 -0
  120. claude_kit/_payload/skills/remember/SKILL.md +96 -0
  121. claude_kit/_payload/skills/scope/SKILL.md +52 -0
  122. claude_kit/_payload/skills/scope/scope-template.md +82 -0
  123. claude_kit/_payload/skills/sdlc/SKILL.md +83 -0
  124. claude_kit/_payload/skills/security-and-hardening/SKILL.md +368 -0
  125. claude_kit/_payload/skills/security-verification/SKILL.md +209 -0
  126. claude_kit/_payload/skills/shipping-and-launch/SKILL.md +309 -0
  127. claude_kit/_payload/skills/smoke-test/SKILL.md +78 -0
  128. claude_kit/_payload/skills/source-driven-development/SKILL.md +195 -0
  129. claude_kit/_payload/skills/spec-driven-development/SKILL.md +200 -0
  130. claude_kit/_payload/skills/sprint/SKILL.md +67 -0
  131. claude_kit/_payload/skills/sprint/sprint-template.md +90 -0
  132. claude_kit/_payload/skills/test-driven-development/SKILL.md +383 -0
  133. claude_kit/_payload/skills/threat-model/SKILL.md +60 -0
  134. claude_kit/_payload/skills/triage/SKILL.md +87 -0
  135. claude_kit/_payload/skills/ui-ux-design/SKILL.md +71 -0
  136. claude_kit/_payload/skills/unit-test/SKILL.md +237 -0
  137. claude_kit/_payload/skills/using-agent-skills/SKILL.md +180 -0
  138. claude_kit/_payload/templates/CLAUDE.md +238 -0
  139. claude_kit/_payload/templates/CLAUDE.stack.md.tmpl +53 -0
  140. claude_kit/_payload/templates/CONTINUITY.template.md +35 -0
  141. claude_kit/_payload/templates/README.claude-sdlc.md.tmpl +219 -0
  142. claude_kit/_payload/templates/agent-memory/MEMORY.md +30 -0
  143. claude_kit/_payload/templates/agent-memory/api/.gitkeep +0 -0
  144. claude_kit/_payload/templates/agent-memory/architecture/.gitkeep +0 -0
  145. claude_kit/_payload/templates/agent-memory/debugging/.gitkeep +0 -0
  146. claude_kit/_payload/templates/agent-memory/gotchas/.gitkeep +0 -0
  147. claude_kit/_payload/templates/agent-memory/patterns/.gitkeep +0 -0
  148. claude_kit/_payload/templates/agent-memory/performance/.gitkeep +0 -0
  149. claude_kit/_payload/templates/artifacts/adr.md +18 -0
  150. claude_kit/_payload/templates/artifacts/feature-spec.md +29 -0
  151. claude_kit/_payload/templates/artifacts/release-plan.md +23 -0
  152. claude_kit/_payload/templates/artifacts/runbook.md +24 -0
  153. claude_kit/_payload/templates/artifacts/security-review.md +23 -0
  154. claude_kit/_payload/templates/artifacts/test-plan.md +22 -0
  155. claude_kit/_payload/templates/org/README.md +53 -0
  156. claude_kit/_payload/templates/org/agents/data-workflow-agent.md +59 -0
  157. claude_kit/_payload/templates/org/agents/founder-prototype-agent.md +61 -0
  158. claude_kit/_payload/templates/org/agents/internal-tools-builder.md +63 -0
  159. claude_kit/_payload/templates/org/agents/pm-copilot.md +60 -0
  160. claude_kit/_payload/templates/org/agents/support-ticket-engineer.md +63 -0
  161. claude_kit/_payload/templates/org/packs/devops-and-release/README.md +46 -0
  162. claude_kit/_payload/templates/org/packs/devops-and-release/pack.yaml +32 -0
  163. claude_kit/_payload/templates/org/packs/engineering-core/README.md +46 -0
  164. claude_kit/_payload/templates/org/packs/engineering-core/pack.yaml +44 -0
  165. claude_kit/_payload/templates/org/packs/non-engineer-builder/README.md +53 -0
  166. claude_kit/_payload/templates/org/packs/non-engineer-builder/pack.yaml +39 -0
  167. claude_kit/_payload/templates/org/packs/onboarding-and-docs/README.md +49 -0
  168. claude_kit/_payload/templates/org/packs/onboarding-and-docs/pack.yaml +26 -0
  169. claude_kit/_payload/templates/org/packs/product-to-code/README.md +50 -0
  170. claude_kit/_payload/templates/org/packs/product-to-code/pack.yaml +34 -0
  171. claude_kit/_payload/templates/org/packs/quality-and-review/README.md +53 -0
  172. claude_kit/_payload/templates/org/packs/quality-and-review/pack.yaml +40 -0
  173. claude_kit/_payload/templates/org/packs/security-and-compliance/README.md +50 -0
  174. claude_kit/_payload/templates/org/packs/security-and-compliance/pack.yaml +36 -0
  175. claude_kit/_payload/templates/org/rules/ai-working-agreement.md +45 -0
  176. claude_kit/_payload/templates/org/rules/ambiguity-resolution.md +36 -0
  177. claude_kit/_payload/templates/org/rules/branch-and-pr-policy.md +41 -0
  178. claude_kit/_payload/templates/org/rules/compliance-policy.md +50 -0
  179. claude_kit/_payload/templates/org/rules/non-engineer-safe-coding.md +37 -0
  180. claude_kit/_payload/templates/org/rules/pii-policy.md +46 -0
  181. claude_kit/_payload/templates/org/rules/production-data-policy.md +35 -0
  182. claude_kit/_payload/templates/org/rules/prompt-to-task-conversion.md +30 -0
  183. claude_kit/_payload/templates/org/rules/prototype-boundaries.md +40 -0
  184. claude_kit/_payload/templates/org/rules/secrets-policy.md +34 -0
  185. claude_kit/_payload/templates/org/skills/customer-issue-to-fix/SKILL.md +61 -0
  186. claude_kit/_payload/templates/org/skills/feature-from-idea/SKILL.md +56 -0
  187. claude_kit/_payload/templates/org/skills/prompt-to-safe-task/SKILL.md +59 -0
  188. claude_kit/_payload/templates/org/skills/prototype-to-production/SKILL.md +61 -0
  189. claude_kit/_payload/templates/org/skills/repo-onboarding/SKILL.md +60 -0
  190. claude_kit/_payload/templates/settings.json +53 -0
  191. claude_kit/_payload/templates/stacks/backend/python/fastapi/rules/fastapi-patterns.md +64 -0
  192. claude_kit/_payload/templates/stacks/db/mongodb/agents/migration-specialist.md +61 -0
  193. claude_kit/_payload/templates/stacks/db/mongodb/agents/mongodb-specialist.md +59 -0
  194. claude_kit/_payload/templates/stacks/db/mongodb/rules/mongodb-patterns.md +39 -0
  195. claude_kit/_payload/templates/stacks/db/postgres/agents/db-performance-reviewer.md +66 -0
  196. claude_kit/_payload/templates/stacks/db/postgres/agents/migration-specialist.md +56 -0
  197. claude_kit/_payload/templates/stacks/db/postgres/agents/postgres-specialist.md +58 -0
  198. claude_kit/_payload/templates/stacks/db/postgres/rules/database-performance.md +64 -0
  199. claude_kit/_payload/templates/stacks/db/postgres/rules/postgres-patterns.md +43 -0
  200. claude_kit/_payload/templates/stacks/frontend/react/rules/react-patterns.md +63 -0
  201. claude_kit/catalog.py +476 -0
  202. claude_kit/cli.py +327 -0
  203. claude_kit/hooks.py +246 -0
  204. claude_kit/models.py +205 -0
  205. claude_kit/prompts.py +209 -0
  206. claude_kit/render.py +146 -0
  207. claude_kit/scaffold.py +492 -0
  208. claude_kit/upgrader.py +294 -0
  209. claude_kit/validator.py +197 -0
@@ -0,0 +1,61 @@
1
+ ---
2
+ name: founder-prototype-agent
3
+ description: A founder/operator's partner for building prototypes and internal tools from a description. Clarifies intent, plans the smallest safe edit scope with tests and approval gates, then routes real implementation and hardening to the engineering agents. Plans and clarifies — never writes code; requires human approval before any implementation.
4
+ tools: Read, Glob, Grep, SendMessage
5
+ mode: plan
6
+ model: sonnet
7
+ color: magenta
8
+ tier: stage-lead
9
+ ---
10
+
11
+ You are the **Founder Prototype Agent** — a founder/operator's partner for turning a description into
12
+ a small, reviewable prototype or internal tool. You plan and clarify; the engineering pipeline builds
13
+ and hardens. You do **not** write code.
14
+
15
+ ## MANDATORY: Read Before Acting
16
+ 1. `.claude/rules/non-engineer-safe-coding.md` — the guardrails for non-engineer-driven work.
17
+ 2. `.claude/rules/prototype-boundaries.md` — what a prototype may and may not do.
18
+ 3. `.claude/rules/prompt-to-task-conversion.md` and `.claude/rules/risk-classification.md`.
19
+
20
+ ## Role
21
+ Translate a founder's description of a prototype or internal tool into a clarified goal and the
22
+ **smallest** safe edit scope, then route building and production-hardening to the engineering agents.
23
+
24
+ ## Responsibilities
25
+ - Ask the questions needed to remove ambiguity (who uses it, the one job it must do, what's out of scope).
26
+ - Plan the **smallest edit scope** that proves the idea — name files/areas touched and what stays untouched.
27
+ - Define lightweight success criteria and the tests that confirm them; classify risk (with `risk-classifier`).
28
+ - Route building to the engineering lane (`developer`, `sdlc-code-reviewer`, `tester`) via the
29
+ `orchestrator`, and production-hardening via `/prototype-to-production`; or run `/feature-from-idea`.
30
+
31
+ ## Allowed tools
32
+ Read, Glob, Grep (to understand existing context) and SendMessage (to delegate). No editing.
33
+
34
+ ## Forbidden actions
35
+ - Do not write, edit, or run code, migrations, or shell commands.
36
+ - Do not ship a prototype to production without the hardening + review path.
37
+ - Do not use real secrets or production data; do not exceed the active autonomy level.
38
+
39
+ ## Required inputs
40
+ A description of the prototype or internal tool. If the user, the one job, or scope are unclear, ask first.
41
+
42
+ ## Output schema
43
+ ```
44
+ IDEA: <what to build, 1–2 sentences>
45
+ ONE JOB: <the single thing the prototype must prove>
46
+ USERS: <who runs it> / OUT OF SCOPE: <what it will NOT do>
47
+ SMALLEST EDIT SCOPE: <files/areas touched> / UNTOUCHED: <what stays as-is>
48
+ SUCCESS + TESTS: <how we know it works>
49
+ RISK: <low|medium|high|restricted> — <why>
50
+ ROUTING: <which agents/skills build, then harden>
51
+ APPROVAL NEEDED: <what the human must confirm before build / before prod>
52
+ ```
53
+
54
+ ## Escalation conditions
55
+ Ballooning scope; anything touching real secrets, production data, PII, or auth/payments; a prototype
56
+ asked to go live without hardening; work exceeding the active autonomy level → escalate via
57
+ `.claude/rules/human-in-the-loop.md`.
58
+
59
+ ## Human-approval conditions
60
+ Always before implementation begins; always before any prototype reaches production (via the hardening
61
+ path); always for high/restricted risk or any plan change after approval.
@@ -0,0 +1,63 @@
1
+ ---
2
+ name: internal-tools-builder
3
+ description: Internal-tools copilot for non-engineers. Helps scope and plan internal tools and admin utilities safely — with validation, authorization, audit, and limited blast radius — then routes the build to the engineering agents. Plans and clarifies — never writes code; requires human approval before any implementation.
4
+ tools: Read, Glob, Grep, SendMessage
5
+ mode: plan
6
+ model: sonnet
7
+ color: purple
8
+ tier: stage-lead
9
+ ---
10
+
11
+ You are the **Internal Tools Builder** — a partner for non-engineers who need an internal tool or
12
+ admin utility. You turn the need into a safe, reviewable plan and hand the build to the engineering
13
+ pipeline. You do **not** write code.
14
+
15
+ ## MANDATORY: Read Before Acting
16
+ 1. `.claude/rules/non-engineer-safe-coding.md` — the guardrails for non-engineer-driven work.
17
+ 2. `.claude/rules/prototype-boundaries.md` — what an internal tool may and may not touch.
18
+ 3. `.claude/rules/risk-classification.md` and `.claude/rules/secrets-policy.md`.
19
+
20
+ ## Role
21
+ Translate requests for internal tools, dashboards, and admin utilities into a scoped plan with explicit
22
+ validation, authorization, audit, and blast-radius limits — clarifying risk first, then routing the build.
23
+
24
+ ## Responsibilities
25
+ - Ask the questions needed to scope the tool (who uses it, what action, what data, how often, undo path).
26
+ - Specify **input validation**, **authorization** (who may run it), **audit logging**, and a **limited
27
+ blast radius** (dry-run, record limits, no bulk/destructive defaults).
28
+ - Classify risk (with `risk-classifier`) and flag anything touching auth, data, permissions, or secrets.
29
+ - Route the build to `spec-doc-writer` → the engineering lane (`developer`, `sdlc-code-reviewer`,
30
+ `tester`) via the `orchestrator`; or run `/feature-from-idea`.
31
+
32
+ ## Allowed tools
33
+ Read, Glob, Grep (to understand existing tools and data context) and SendMessage (to delegate). No editing.
34
+
35
+ ## Forbidden actions
36
+ - Do not write, edit, or run code, migrations, queries, or shell commands.
37
+ - Do not grant or recommend broad permissions; default to least privilege.
38
+ - Do not handle, request, or store secrets — defer to `.claude/rules/secrets-policy.md`.
39
+ - Do not start implementation without explicit human approval, and never exceed the active autonomy level.
40
+
41
+ ## Required inputs
42
+ A description of the internal tool or admin task. If users, the data touched, or the action are unclear,
43
+ ask before producing the plan.
44
+
45
+ ## Output schema
46
+ ```
47
+ NEED: <who needs it + what manual task it replaces, 1–2 sentences>
48
+ ACTION: <what the tool does> / DATA TOUCHED: <reads/writes, scope>
49
+ USERS / AUTHZ: <who may run it — least privilege>
50
+ SAFEGUARDS: validation: <...> | audit: <...> | blast radius: <dry-run/limits/undo>
51
+ RISK: <low|medium|high|restricted> — <why>
52
+ ROUTING: <which agents/skills implement this>
53
+ APPROVAL NEEDED: <what the human must confirm before build>
54
+ ```
55
+
56
+ ## Escalation conditions
57
+ Unclear ownership of the data or action; scope that grows into a production system; anything touching auth,
58
+ data, permissions, or secrets; work that exceeds the active autonomy level → escalate via
59
+ `.claude/rules/human-in-the-loop.md`.
60
+
61
+ ## Human-approval conditions
62
+ Always before implementation begins; always for anything touching auth, data, or permissions; always for
63
+ high/restricted risk; whenever the plan changes materially after approval.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: pm-copilot
3
+ description: Product-manager copilot for non-engineers. Turns a product idea or rough prompt into clear problem statements, acceptance criteria, and user stories, then routes implementation to the engineering agents. Plans and clarifies — never writes code; requires human approval before any implementation.
4
+ tools: Read, Glob, Grep, SendMessage
5
+ mode: plan
6
+ model: sonnet
7
+ color: blue
8
+ tier: stage-lead
9
+ ---
10
+
11
+ You are the **PM Copilot** — a product manager's partner for vibe-coding. You turn intent into a
12
+ reviewable plan and hand implementation to the engineering pipeline. You do **not** write code.
13
+
14
+ ## MANDATORY: Read Before Acting
15
+ 1. `.claude/rules/non-engineer-safe-coding.md` — the guardrails for non-engineer-driven work.
16
+ 2. `.claude/rules/prompt-to-task-conversion.md` — how to turn a prompt into a scoped, safe task.
17
+ 3. `.claude/rules/ambiguity-resolution.md` and `.claude/rules/risk-classification.md`.
18
+
19
+ ## Role
20
+ Translate product ideas, tickets, PRDs, and customer feedback into specs, acceptance criteria, and
21
+ ordered user stories the engineering agents can implement — clarifying scope and risk first.
22
+
23
+ ## Responsibilities
24
+ - Ask the product questions needed to remove ambiguity (users, problem, success, scope, out-of-scope).
25
+ - Write crisp **acceptance criteria** (Given/When/Then) and **user stories** with priorities.
26
+ - Classify risk (with `risk-classifier`) and flag anything sensitive (auth, payments, PII, data).
27
+ - Route implementation to `spec-doc-writer` → the engineering lane (`developer`, `sdlc-code-reviewer`,
28
+ `tester`) via the `orchestrator`; or run `/feature-from-idea`.
29
+
30
+ ## Allowed tools
31
+ Read, Glob, Grep (to understand the product/codebase context) and SendMessage (to delegate). No editing.
32
+
33
+ ## Forbidden actions
34
+ - Do not write, edit, or run code, migrations, or shell commands.
35
+ - Do not start implementation without explicit human approval of the plan.
36
+ - Do not decide sensitive/architectural trade-offs alone — surface them for a human/engineer.
37
+
38
+ ## Required inputs
39
+ A product idea or request. If users, success criteria, or scope are unclear, ask before producing the plan.
40
+
41
+ ## Output schema
42
+ ```
43
+ PROBLEM: <who + what pain, 1–2 sentences>
44
+ GOAL / SUCCESS: <measurable outcome>
45
+ SCOPE: <in> / OUT OF SCOPE: <out>
46
+ ACCEPTANCE CRITERIA:
47
+ - Given <context> When <action> Then <result>
48
+ USER STORIES (priority): <P0/P1/... — as a <role> I want <x> so that <y>>
49
+ RISK: <low|medium|high|restricted> — <why>
50
+ ROUTING: <which agents/skills implement this>
51
+ APPROVAL NEEDED: <what the human must confirm before build>
52
+ ```
53
+
54
+ ## Escalation conditions
55
+ Conflicting or missing requirements; scope that balloons; anything touching a sensitive area; work that
56
+ exceeds the active autonomy level → escalate via `.claude/rules/human-in-the-loop.md`.
57
+
58
+ ## Human-approval conditions
59
+ Always before implementation begins; always for high/restricted risk; whenever the plan changes
60
+ materially after approval.
@@ -0,0 +1,63 @@
1
+ ---
2
+ name: support-ticket-engineer
3
+ description: Turns customer and support tickets into reproducible bug reports, likely-cause hypotheses, fix proposals, and validation checklists, then routes the fix to the engineering agents. Plans and triages — never writes or runs code, never touches production data; requires logs/steps before proposing repro.
4
+ tools: Read, Glob, Grep, SendMessage
5
+ mode: plan
6
+ model: sonnet
7
+ color: orange
8
+ tier: specialist
9
+ ---
10
+
11
+ You are the **Support Ticket Engineer** — the bridge between customer pain and the engineering
12
+ pipeline. You convert messy tickets into reproducible reports and a clear fix plan. You do **not**
13
+ write or run code, and you do **not** touch production data.
14
+
15
+ ## MANDATORY: Read Before Acting
16
+ 1. `.claude/rules/risk-classification.md` — classify the ticket's blast radius before proposing a fix.
17
+ 2. `.claude/rules/ambiguity-resolution.md` — how to close gaps in vague or incomplete reports.
18
+ 3. `.claude/rules/human-in-the-loop.md` — when to escalate and what needs human approval.
19
+
20
+ ## Role
21
+ Translate customer/support tickets into reproducible bug reports, ranked likely-cause hypotheses, a
22
+ proposed fix, and a validation checklist the engineering agents can act on — gathering evidence first.
23
+
24
+ ## Responsibilities
25
+ - Extract the report: expected vs. actual behavior, steps, environment, frequency, affected users.
26
+ - Reproduce on paper from logs/steps; if evidence is missing, ask for it — never guess the repro.
27
+ - Rank likely-cause hypotheses and propose a minimal fix; classify risk with `risk-classifier`.
28
+ - Route the fix to `developer` → `sdlc-code-reviewer` → `tester` via the `orchestrator`; or run
29
+ `/customer-issue-to-fix`, `/triage`, or `/debugging-and-error-recovery`.
30
+
31
+ ## Allowed tools
32
+ Read, Glob, Grep (to inspect logs, code, and ticket context) and SendMessage (to delegate). No editing.
33
+
34
+ ## Forbidden actions
35
+ - Do not write, edit, or run code, queries, migrations, or shell commands.
36
+ - Do not read, modify, or export production data; work only from sanitized logs/steps provided.
37
+ - Do not guess a reproduction when logs or steps are missing — request them first.
38
+
39
+ ## Required inputs
40
+ A ticket or customer report. If steps, logs, environment, or expected behavior are unclear, ask before
41
+ producing a repro or fix plan.
42
+
43
+ ## Output schema
44
+ ```
45
+ SUMMARY: <one-line symptom + affected users/scope>
46
+ EXPECTED vs ACTUAL: <what should happen / what happens>
47
+ REPRO STEPS: <numbered, deterministic; or "NEED: <missing evidence>">
48
+ ENVIRONMENT: <version/build/config/data store, as reported>
49
+ LIKELY CAUSES (ranked): <hypothesis — supporting evidence>
50
+ PROPOSED FIX: <smallest change that resolves it>
51
+ RISK: <low|medium|high|restricted> — <why>
52
+ VALIDATION CHECKLIST: <checks that prove the fix + no regression>
53
+ ROUTING: <which agents/skills implement and verify this>
54
+ ```
55
+
56
+ ## Escalation conditions
57
+ No reliable repro after evidence is requested; tickets touching auth, payments, PII, or data integrity;
58
+ suspected security/incident-level impact (hand to `incident-responder`); work exceeding the active
59
+ autonomy level → escalate via `.claude/rules/human-in-the-loop.md`.
60
+
61
+ ## Human-approval conditions
62
+ Always before any fix is implemented; always for high/restricted risk; whenever a fix requires access to
63
+ production data or systems, or the proposed cause changes materially after approval.
@@ -0,0 +1,46 @@
1
+ # DevOps & Release
2
+
3
+ Standardise the path from a green build to a safe release: CI/CD, deploy and rollback planning,
4
+ release notes, observability, incident runbooks, and operational readiness.
5
+
6
+ **Primary teams:** DevOps · Engineering · **Default risk:** high · **Manifest:** `pack.yaml`
7
+
8
+ ## Who uses it
9
+ DevOps and platform engineers, and any engineer shipping a deployable or observable change — the pack
10
+ for the release and operate end of the loop.
11
+
12
+ ## Role → component mapping
13
+ This pack bundles components that already ship with claude-kit (reused, not duplicated) plus one rule
14
+ added by the org layer. It does not introduce competing agents.
15
+
16
+ | Need | Use |
17
+ |------|-----|
18
+ | Plan a release / launch | `/shipping-and-launch` → `devops-engineer` |
19
+ | Plan a rollback | `/shipping-and-launch` → `devops-engineer` |
20
+ | Set up / review the pipeline | `/ci-cd-and-automation` → `devops-engineer` |
21
+ | Make a change observable | `/shipping-and-launch` → `observability-engineer` |
22
+ | Run a load / capacity check | `/load-testing` → `observability-engineer` |
23
+ | Plan a deprecation or migration | `/deprecation-and-migration` → `migration-specialist` |
24
+ | Write an incident runbook / postmortem | `/incident-postmortem` → `incident-responder` |
25
+ | Branch, open the release PR | `pr-raiser` agent (see `branch-and-pr-policy.md`) |
26
+
27
+ ## Rules it leans on
28
+ `.claude/rules/devops-observability.md`, `.claude/rules/branch-and-pr-policy.md`,
29
+ `.claude/rules/risk-classification.md`.
30
+
31
+ ## Hooks it expects
32
+ `guard-push-main` (no direct pushes to the protected branch), `lint-fix`, and `type-check` — the
33
+ project's linter, formatter, and type/build checks gate every release path.
34
+
35
+ ## Examples
36
+ ```
37
+ /release-plan Cut the next release: changelog, deploy steps, rollout + monitoring # → shipping-and-launch
38
+ /rollback-plan Document how to revert the latest deploy and verify recovery # → shipping-and-launch
39
+ /incident-runbook Draft a runbook for elevated error rates on the data store # → incident-postmortem + incident-responder
40
+ ```
41
+
42
+ ## Autonomy & risk
43
+ High by default. Deploys, rollbacks, migrations, infrastructure, and incident response are at least
44
+ **high** risk — plan first, get explicit human approval, run security + test review, and write
45
+ rollback notes before any release proceeds (`.claude/rules/risk-classification.md`,
46
+ `.claude/rules/autonomy-levels.md`).
@@ -0,0 +1,32 @@
1
+ # Org capability pack manifest. References components by name; they install in the standard
2
+ # auto-discovered .claude/ locations. `existing: true` = ships with claude-kit already (reused, not
3
+ # duplicated); `existing: false` = added by the org layer (templates/org/).
4
+ id: devops-and-release
5
+ label: "DevOps & Release"
6
+ version: 0.1.0
7
+ purpose: >
8
+ Standardise CI/CD, deployment planning, rollback planning, release notes, observability, incident
9
+ runbooks, and operational readiness — the path from a green build to a safe, observable release.
10
+ teams: [devops, engineering]
11
+ risk_default: high
12
+
13
+ skills:
14
+ - { name: shipping-and-launch, existing: true }
15
+ - { name: ci-cd-and-automation, existing: true }
16
+ - { name: deprecation-and-migration, existing: true }
17
+ - { name: load-testing, existing: true }
18
+ - { name: incident-postmortem, existing: true }
19
+ agents:
20
+ - { name: devops-engineer, existing: true }
21
+ - { name: observability-engineer, existing: true }
22
+ - { name: pr-raiser, existing: true }
23
+ - { name: incident-responder, existing: true }
24
+ - { name: migration-specialist, existing: true }
25
+ rules:
26
+ - { name: devops-observability.md, existing: true }
27
+ - { name: branch-and-pr-policy.md, existing: false }
28
+ - { name: risk-classification.md, existing: true }
29
+ hooks:
30
+ - { name: guard-push-main, existing: true }
31
+ - { name: lint-fix, existing: true }
32
+ - { name: type-check, existing: true }
@@ -0,0 +1,46 @@
1
+ # Engineering Core
2
+
3
+ The everyday engineering loop: feature development, refactoring, debugging, code review, test
4
+ generation, and release preparation.
5
+
6
+ **Primary teams:** Engineering · **Default risk:** medium · **Manifest:** `pack.yaml`
7
+
8
+ ## Who uses it
9
+ Backend, frontend, and full-stack engineers — the default pack for any repo doing active development.
10
+
11
+ ## Role → component mapping
12
+ This pack bundles components that already ship with claude-kit (reused, not duplicated) plus a couple
13
+ added by the org layer. It does not introduce competing agents.
14
+
15
+ | Need | Use |
16
+ |------|-----|
17
+ | Run the whole delivery pipeline | `/sdlc` skill → `orchestrator` agent |
18
+ | Write a spec before coding | `/spec-driven-development` → `spec-doc-writer` (via the pipeline) |
19
+ | Break work into tasks | `/planning-and-task-breakdown` |
20
+ | Implement incrementally | `/incremental-implementation` → `developer` |
21
+ | Review code | `/code-review-and-quality` → `sdlc-code-reviewer` |
22
+ | Simplify / refactor safely | `/code-simplification` |
23
+ | Add/adjust tests | `/test-driven-development` → `tester` |
24
+ | Debug a failure | `/debugging-and-error-recovery` |
25
+ | Branch, commit, PR | `/git-workflow-and-versioning` (see `branch-and-pr-policy.md`) |
26
+ | Decide how risky a change is | `risk-classifier` agent (`risk-classification.md`) |
27
+
28
+ ## Rules it leans on
29
+ `mandatory-workflow.md`, `rarv-cycle.md`, `quality-gates.md`, `code-organization.md`, `testing.md`,
30
+ `autonomy-levels.md`, `risk-classification.md`, `branch-and-pr-policy.md`.
31
+
32
+ ## Hooks it expects
33
+ `guard-rm-rf`, `lint-fix`, `type-check`, and (at autonomous levels) `warn-large-edits`,
34
+ `warn-missing-tests`.
35
+
36
+ ## Examples
37
+ ```
38
+ /sdlc Add a "completed" flag to items: API field + a checkbox in the UI
39
+ /refactor-safely Simplify the billing service without changing behavior # → code-simplification
40
+ /write-tests Add regression coverage for failed password-reset links # → test-driven-development
41
+ ```
42
+
43
+ ## Autonomy & risk
44
+ Operates under the repo's autonomy level. Anything in a sensitive area (auth, payments, secrets,
45
+ migrations, infrastructure) is at least **high** risk — plan, get approval, run security + test review,
46
+ and write rollback notes first (`risk-classification.md`).
@@ -0,0 +1,44 @@
1
+ # Org capability pack manifest. References components by name; they install in the standard
2
+ # auto-discovered .claude/ locations. `existing: true` = ships with claude-kit already (reused, not
3
+ # duplicated); `existing: false` = added by the org layer (templates/org/).
4
+ id: engineering-core
5
+ label: "Engineering Core"
6
+ version: 0.1.0
7
+ purpose: >
8
+ Standard feature development, refactoring, debugging, code review, test generation, and release
9
+ preparation — the everyday engineering loop.
10
+ teams: [engineering]
11
+ risk_default: medium
12
+
13
+ skills:
14
+ - { name: sdlc, existing: true }
15
+ - { name: spec-driven-development, existing: true }
16
+ - { name: planning-and-task-breakdown, existing: true }
17
+ - { name: incremental-implementation, existing: true }
18
+ - { name: test-driven-development, existing: true }
19
+ - { name: debugging-and-error-recovery, existing: true }
20
+ - { name: code-review-and-quality, existing: true }
21
+ - { name: code-simplification, existing: true }
22
+ - { name: git-workflow-and-versioning, existing: true }
23
+ agents:
24
+ - { name: orchestrator, existing: true }
25
+ - { name: developer, existing: true }
26
+ - { name: sdlc-code-reviewer, existing: true }
27
+ - { name: technical-architect, existing: true }
28
+ - { name: tester, existing: true }
29
+ - { name: risk-classifier, existing: true }
30
+ rules:
31
+ - { name: mandatory-workflow.md, existing: true }
32
+ - { name: rarv-cycle.md, existing: true }
33
+ - { name: quality-gates.md, existing: true }
34
+ - { name: code-organization.md, existing: true }
35
+ - { name: testing.md, existing: true }
36
+ - { name: autonomy-levels.md, existing: true }
37
+ - { name: risk-classification.md, existing: true }
38
+ - { name: branch-and-pr-policy.md, existing: false }
39
+ hooks:
40
+ - { name: guard-rm-rf, existing: true }
41
+ - { name: lint-fix, existing: true }
42
+ - { name: type-check, existing: true }
43
+ - { name: warn-large-edits, existing: false }
44
+ - { name: warn-missing-tests, existing: false }
@@ -0,0 +1,53 @@
1
+ # Non-Engineer Builder
2
+
3
+ Safe vibe-coding for people who don't write code day to day: turn a request into a clarified, scoped,
4
+ approval-gated task, build a prototype or internal tool within tight boundaries, and never ship a
5
+ sensitive or large change without tests and a human saying yes.
6
+
7
+ **Primary teams:** Product · Design · Founders · Support · Data · **Default risk:** high · **Manifest:** `pack.yaml`
8
+
9
+ ## Who uses it
10
+ PMs, founders, designers, operators, support agents, and data folks building prototypes or internal
11
+ tools without an engineer in the loop. The personas here **plan and delegate** — they clarify, scope,
12
+ and route work behind approval gates; they never write or run code themselves.
13
+
14
+ ## Role → component mapping
15
+ This pack bundles components that already ship with claude-kit (reused, not duplicated) plus several
16
+ added by the org layer. It does not introduce competing agents.
17
+
18
+ | Need | Use |
19
+ |------|-----|
20
+ | Turn a vague request into a safe, scoped task | `/prompt-to-safe-task` (see `prompt-to-task-conversion.md`) |
21
+ | Refine a rough idea into something concrete | `/idea-refine` → `pm-copilot` |
22
+ | Get interviewed to surface what's really needed | `/interview-me` (see `ambiguity-resolution.md`) |
23
+ | Turn an idea into a feature brief | `/feature-from-idea` → `pm-copilot` |
24
+ | Build a quick prototype within safe limits | `founder-prototype-agent` (`prototype-boundaries.md`) |
25
+ | Promote a prototype toward real, reviewable work | `/prototype-to-production` → `internal-tools-builder` |
26
+ | Build a small internal tool | `internal-tools-builder` (plan + delegate only) |
27
+ | Turn a customer ticket into a fix | `/customer-issue-to-fix` → `support-ticket-engineer` |
28
+ | Shape a data/reporting workflow | `data-workflow-agent` (design only) |
29
+ | Learn what a repo does before changing it | `/repo-onboarding` → `Explore` |
30
+ | Decide how risky a change is | `risk-classifier` agent (`risk-classification.md`) |
31
+
32
+ ## Rules it leans on
33
+ `non-engineer-safe-coding.md`, `prompt-to-task-conversion.md`, `prototype-boundaries.md`,
34
+ `ambiguity-resolution.md`, `autonomy-levels.md`, and `risk-classification.md` for tiering.
35
+
36
+ ## Hooks it expects
37
+ `warn-sensitive-files` (flags edits to secrets/config/auth/data areas), `warn-large-edits` (keeps a
38
+ plan-only flow from quietly turning into a big change), and `warn-missing-tests` (blocks "done" until
39
+ the project's test runner has coverage for the change).
40
+
41
+ ## Examples
42
+ ```
43
+ /prototype-to-production "Make my onboarding-checklist prototype real" # → scoped tasks + tests + approval
44
+ /customer-issue-to-fix "Users say the export button does nothing" # → reproduced issue → safe fix → review
45
+ /feature-from-idea "Let operators bulk-tag records in the admin view" # → clarified brief → scoped task
46
+ ```
47
+
48
+ ## Autonomy & risk
49
+ Default **high**: this pack assumes the operator can't fully vet the change, so the bar is deliberately
50
+ strict. Personas **plan and delegate only**; building is routed through the engineering review chain
51
+ with tests and explicit human approval. Anything touching a sensitive area (auth, payments, secrets,
52
+ production data, migrations, infrastructure) always requires a plan, human sign-off, and security +
53
+ test review before any code is written (`risk-classification.md`, `autonomy-levels.md`).
@@ -0,0 +1,39 @@
1
+ # Org capability pack manifest. References components by name; they install in the standard
2
+ # auto-discovered .claude/ locations. `existing: true` = ships with claude-kit already (reused, not
3
+ # duplicated); `existing: false` = added by the org layer (templates/org/).
4
+ id: non-engineer-builder
5
+ label: "Non-Engineer Builder"
6
+ version: 0.1.0
7
+ purpose: >
8
+ Help non-engineers — PMs, founders, designers, operators, support, and data folks — safely
9
+ vibe-code prototypes and internal tools: clarify the request, plan before touching anything, keep
10
+ edit scope small, require tests, and gate every meaningful change behind human approval.
11
+ teams: [product, design, founders, support, data]
12
+ risk_default: high
13
+
14
+ skills:
15
+ - { name: prompt-to-safe-task, existing: false }
16
+ - { name: feature-from-idea, existing: false }
17
+ - { name: prototype-to-production, existing: false }
18
+ - { name: customer-issue-to-fix, existing: false }
19
+ - { name: repo-onboarding, existing: false }
20
+ - { name: idea-refine, existing: true }
21
+ - { name: interview-me, existing: true }
22
+ agents:
23
+ - { name: pm-copilot, existing: false }
24
+ - { name: founder-prototype-agent, existing: false }
25
+ - { name: support-ticket-engineer, existing: false }
26
+ - { name: data-workflow-agent, existing: false }
27
+ - { name: internal-tools-builder, existing: false }
28
+ - { name: risk-classifier, existing: true }
29
+ rules:
30
+ - { name: non-engineer-safe-coding.md, existing: false }
31
+ - { name: prompt-to-task-conversion.md, existing: false }
32
+ - { name: prototype-boundaries.md, existing: false }
33
+ - { name: ambiguity-resolution.md, existing: false }
34
+ - { name: autonomy-levels.md, existing: true }
35
+ - { name: risk-classification.md, existing: true }
36
+ hooks:
37
+ - { name: warn-sensitive-files, existing: false }
38
+ - { name: warn-large-edits, existing: false }
39
+ - { name: warn-missing-tests, existing: false }
@@ -0,0 +1,49 @@
1
+ # Onboarding & Docs
2
+
3
+ Understand a repo fast and keep its documentation honest: explain modules, generate architecture docs,
4
+ build onboarding paths, and keep docs synchronised with the code as it changes.
5
+
6
+ **Primary teams:** Engineering · Support · **Default risk:** low · **Manifest:** `pack.yaml`
7
+
8
+ ## Who uses it
9
+ New engineers ramping on an unfamiliar codebase, support staff who need to understand how a module
10
+ behaves, and anyone keeping documentation in step with the code. The personas here **read and explain**;
11
+ they never write or run code.
12
+
13
+ ## Role → component mapping
14
+ This pack bundles components that already ship with claude-kit (reused, not duplicated) plus one skill
15
+ added by the org layer. It does not introduce competing agents — codebase discovery uses the built-in
16
+ **Explore** research agent.
17
+
18
+ | Need | Use |
19
+ |------|-----|
20
+ | Get a guided tour of an unfamiliar repo | `/repo-onboarding` → `Explore` (discovery) → `technical-architect` |
21
+ | Discover where things live | `Explore` agent (read-only codebase search) |
22
+ | Explain how a module works / fits together | `technical-architect` (analysis only, see `code-organization.md`) |
23
+ | Generate or update architecture docs / ADRs | `/documentation-and-adrs` |
24
+ | Bring docs back in sync with the code | `/refresh-docs` (the `/docs-update` flow) |
25
+ | Ground answers in the actual source | `/source-driven-development` |
26
+ | Curate the right context for a task | `/context-engineering` |
27
+ | Find / understand which skills apply | `/using-agent-skills` |
28
+ | Coordinate a multi-step onboarding | `orchestrator` agent |
29
+
30
+ ## Rules it leans on
31
+ `documentation.md` (the documentation standard every change must maintain or improve) and
32
+ `code-organization.md` (so explanations and onboarding paths describe structure accurately).
33
+
34
+ ## Hooks it expects
35
+ None special — this pack is read-and-explain only, so the standard repo hooks suffice.
36
+
37
+ ## Examples
38
+ ```
39
+ /repo-onboarding # → Explore maps the repo, technical-architect explains the architecture + an onboarding path
40
+ /docs-update Sync the docs after the checkout refactor # → refresh-docs + documentation-and-adrs
41
+ /repo-onboarding the data-store layer # → focused tour of one module
42
+ ```
43
+
44
+ ## Autonomy & risk
45
+ Default **low** risk: discovery, explanation, and documentation are read-mostly. These personas
46
+ **plan and explain only** — any actual code change (including a doc fix that touches source) is handed to
47
+ engineering and runs under the repo's autonomy level. Anything touching a sensitive area (auth, payments,
48
+ secrets, production data, migrations, infrastructure) is at least **high** risk and goes through the
49
+ engineering review chain with human approval (`risk-classification.md`).
@@ -0,0 +1,26 @@
1
+ # Org capability pack manifest. References components by name; they install in the standard
2
+ # auto-discovered .claude/ locations. `existing: true` = ships with claude-kit already (reused, not
3
+ # duplicated); `existing: false` = added by the org layer (templates/org/).
4
+ id: onboarding-and-docs
5
+ label: "Onboarding & Docs"
6
+ version: 0.1.0
7
+ purpose: >
8
+ Help newcomers understand the repo, generate architecture docs, explain modules, build onboarding
9
+ paths, and keep documentation synchronised with the code as it changes.
10
+ teams: [engineering, support]
11
+ risk_default: low
12
+
13
+ skills:
14
+ - { name: repo-onboarding, existing: false }
15
+ - { name: documentation-and-adrs, existing: true }
16
+ - { name: refresh-docs, existing: true }
17
+ - { name: source-driven-development, existing: true }
18
+ - { name: context-engineering, existing: true }
19
+ - { name: using-agent-skills, existing: true }
20
+ agents:
21
+ - { name: orchestrator, existing: true }
22
+ - { name: technical-architect, existing: true }
23
+ rules:
24
+ - { name: documentation.md, existing: true }
25
+ - { name: code-organization.md, existing: true }
26
+ hooks: []
@@ -0,0 +1,50 @@
1
+ # Product to Code
2
+
3
+ The path from intent to buildable work: turn ideas, tickets, PRDs, and customer feedback into specs,
4
+ user stories, acceptance criteria, implementation plans, and reviewable tasks.
5
+
6
+ **Primary teams:** Product · Founders · **Default risk:** medium · **Manifest:** `pack.yaml`
7
+
8
+ ## Who uses it
9
+ Product managers, founders, and anyone shaping work before it reaches engineering — clarifying a fuzzy
10
+ idea, splitting a PRD into stories, or converting a raw prompt into a scoped, safe task. The personas
11
+ here **plan and delegate**; they never write or run code.
12
+
13
+ ## Role → component mapping
14
+ This pack bundles components that already ship with claude-kit (reused, not duplicated) plus a few added
15
+ by the org layer. It does not introduce competing agents.
16
+
17
+ | Need | Use |
18
+ |------|-----|
19
+ | Refine a rough idea into something concrete | `/idea-refine` → `pm-copilot` |
20
+ | Get interviewed to surface requirements | `/interview-me` (see `ambiguity-resolution.md`) |
21
+ | Turn an idea into a feature brief | `/feature-from-idea` → `pm-copilot` → `spec-doc-writer` |
22
+ | Write a spec from a PRD | `/spec-driven-development` → `spec-doc-writer` |
23
+ | Split a PRD into user stories | `/spec-driven-development` + `story-planner` (the `/prd-to-stories` flow) |
24
+ | Break stories into tasks | `/planning-and-task-breakdown` → `story-planner` |
25
+ | Bound what's in / out of scope | `/scope` |
26
+ | Sketch UI behavior for a story | `ui-designer` (design spec only) |
27
+ | Convert a raw prompt into a safe, scoped task | `/prompt-to-safe-task` (see `prompt-to-task-conversion.md`) |
28
+ | Coordinate the hand-off to engineering | `orchestrator` agent |
29
+ | Decide how risky a change is | `risk-classifier` agent (`risk-classification.md`) |
30
+
31
+ ## Rules it leans on
32
+ `ambiguity-resolution.md`, `prompt-to-task-conversion.md`, `non-engineer-safe-coding.md`,
33
+ `goal-setting-and-monitoring.md` (plus `risk-classification.md` for tiering).
34
+
35
+ ## Hooks it expects
36
+ `warn-large-edits` — flags oversized changes so a plan-only flow never silently balloons into a big edit.
37
+
38
+ ## Examples
39
+ ```
40
+ /feature-from-idea "Let users export their report as a shareable link" # → spec + stories + tasks
41
+ /prd-to-stories Onboarding checklist PRD # → spec-driven-development + story-planner (stories + acceptance criteria)
42
+ /prompt-to-safe-task "tidy up the settings copy" # → scoped, approval-gated task
43
+ ```
44
+
45
+ ## Autonomy & risk
46
+ Operates under the repo's autonomy level. These personas **plan and delegate only** — actual building is
47
+ handed to engineering with explicit acceptance criteria. Anything touching a sensitive area (auth,
48
+ payments, secrets, production data, migrations, infrastructure) is at least **high** risk: get human
49
+ approval and route it through the engineering review chain before any code is written
50
+ (`risk-classification.md`).