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.
- claude_code_kit-0.7.0.dist-info/METADATA +384 -0
- claude_code_kit-0.7.0.dist-info/RECORD +209 -0
- claude_code_kit-0.7.0.dist-info/WHEEL +4 -0
- claude_code_kit-0.7.0.dist-info/entry_points.txt +4 -0
- claude_code_kit-0.7.0.dist-info/licenses/LICENSE +21 -0
- claude_kit/__init__.py +10 -0
- claude_kit/__main__.py +8 -0
- claude_kit/_payload/agents/acceptance-reviewer.md +60 -0
- claude_kit/_payload/agents/auditor.md +76 -0
- claude_kit/_payload/agents/dependency-scanner.md +84 -0
- claude_kit/_payload/agents/developer.md +187 -0
- claude_kit/_payload/agents/devils-advocate.md +62 -0
- claude_kit/_payload/agents/devops-engineer.md +134 -0
- claude_kit/_payload/agents/e2e-tester.md +152 -0
- claude_kit/_payload/agents/em-reviewer.md +105 -0
- claude_kit/_payload/agents/incident-responder.md +64 -0
- claude_kit/_payload/agents/merge-reviewer.md +194 -0
- claude_kit/_payload/agents/observability-engineer.md +94 -0
- claude_kit/_payload/agents/orchestrator.md +551 -0
- claude_kit/_payload/agents/owasp-reviewer.md +76 -0
- claude_kit/_payload/agents/policy-validator.md +63 -0
- claude_kit/_payload/agents/pr-raiser.md +138 -0
- claude_kit/_payload/agents/risk-classifier.md +50 -0
- claude_kit/_payload/agents/sdlc-code-reviewer.md +196 -0
- claude_kit/_payload/agents/secret-scanner.md +70 -0
- claude_kit/_payload/agents/security-reviewer.md +80 -0
- claude_kit/_payload/agents/senior-backend-dev.md +199 -0
- claude_kit/_payload/agents/senior-frontend-dev.md +181 -0
- claude_kit/_payload/agents/senior-tester.md +206 -0
- claude_kit/_payload/agents/spec-doc-writer.md +331 -0
- claude_kit/_payload/agents/story-planner.md +56 -0
- claude_kit/_payload/agents/technical-architect.md +139 -0
- claude_kit/_payload/agents/tester.md +193 -0
- claude_kit/_payload/agents/ui-designer.md +73 -0
- claude_kit/_payload/agents/unit-tester.md +119 -0
- claude_kit/_payload/catalog/mcp.yaml +54 -0
- claude_kit/_payload/catalog/org.yaml +145 -0
- claude_kit/_payload/catalog/profiles.yaml +96 -0
- claude_kit/_payload/catalog/stacks.yaml +96 -0
- claude_kit/_payload/commands/init.md +36 -0
- claude_kit/_payload/commands/sdlc.md +18 -0
- claude_kit/_payload/commands/status.md +20 -0
- claude_kit/_payload/hooks/hooks.json +58 -0
- claude_kit/_payload/hooks/scripts/audit-log.sh +18 -0
- claude_kit/_payload/hooks/scripts/guard-secrets.sh +26 -0
- claude_kit/_payload/hooks/scripts/lint-fix.sh +38 -0
- claude_kit/_payload/hooks/scripts/load-continuity.sh +32 -0
- claude_kit/_payload/hooks/scripts/load-learnings.sh +40 -0
- claude_kit/_payload/hooks/scripts/type-check.sh +23 -0
- claude_kit/_payload/hooks/scripts/validate-frontmatter.sh +34 -0
- claude_kit/_payload/hooks/scripts/validate-settings.sh +21 -0
- claude_kit/_payload/hooks/scripts/warn-large-edits.sh +24 -0
- claude_kit/_payload/hooks/scripts/warn-missing-tests.sh +24 -0
- claude_kit/_payload/hooks/scripts/warn-sensitive-files.sh +30 -0
- claude_kit/_payload/hooks/scripts/warn-shared-modules.sh +33 -0
- claude_kit/_payload/rules/agent-guardrails.md +83 -0
- claude_kit/_payload/rules/agent-memory.md +106 -0
- claude_kit/_payload/rules/agent-resilience.md +61 -0
- claude_kit/_payload/rules/autonomy-levels.md +30 -0
- claude_kit/_payload/rules/code-organization.md +312 -0
- claude_kit/_payload/rules/continuity.md +84 -0
- claude_kit/_payload/rules/design-patterns.md +422 -0
- claude_kit/_payload/rules/devops-observability.md +57 -0
- claude_kit/_payload/rules/documentation.md +326 -0
- claude_kit/_payload/rules/evals.md +62 -0
- claude_kit/_payload/rules/frontend-best-practices.md +157 -0
- claude_kit/_payload/rules/goal-setting-and-monitoring.md +72 -0
- claude_kit/_payload/rules/human-in-the-loop.md +64 -0
- claude_kit/_payload/rules/linting-and-formatting.md +220 -0
- claude_kit/_payload/rules/mandatory-workflow.md +309 -0
- claude_kit/_payload/rules/model-tiers.md +34 -0
- claude_kit/_payload/rules/quality-gates.md +107 -0
- claude_kit/_payload/rules/rarv-cycle.md +31 -0
- claude_kit/_payload/rules/reasoning-techniques.md +62 -0
- claude_kit/_payload/rules/responsive-and-accessibility.md +353 -0
- claude_kit/_payload/rules/risk-classification.md +36 -0
- claude_kit/_payload/rules/testing.md +417 -0
- claude_kit/_payload/rules/tool-design.md +66 -0
- claude_kit/_payload/skills/_references/accessibility-checklist.md +160 -0
- claude_kit/_payload/skills/_references/orchestration-patterns.md +405 -0
- claude_kit/_payload/skills/_references/performance-checklist.md +153 -0
- claude_kit/_payload/skills/_references/security-checklist.md +134 -0
- claude_kit/_payload/skills/_references/testing-patterns.md +236 -0
- claude_kit/_payload/skills/accessibility-review/SKILL.md +56 -0
- claude_kit/_payload/skills/api-and-interface-design/SKILL.md +294 -0
- claude_kit/_payload/skills/api-integration/SKILL.md +348 -0
- claude_kit/_payload/skills/archive-sprint/SKILL.md +31 -0
- claude_kit/_payload/skills/backlog/SKILL.md +41 -0
- claude_kit/_payload/skills/backlog/item-template.md +20 -0
- claude_kit/_payload/skills/browser-testing-with-devtools/SKILL.md +302 -0
- claude_kit/_payload/skills/ci-cd-and-automation/SKILL.md +402 -0
- claude_kit/_payload/skills/code-review-and-quality/SKILL.md +347 -0
- claude_kit/_payload/skills/code-simplification/SKILL.md +331 -0
- claude_kit/_payload/skills/component-design/SKILL.md +171 -0
- claude_kit/_payload/skills/consolidate-learnings/SKILL.md +55 -0
- claude_kit/_payload/skills/context-engineering/SKILL.md +321 -0
- claude_kit/_payload/skills/debugging-and-error-recovery/SKILL.md +300 -0
- claude_kit/_payload/skills/decision/SKILL.md +46 -0
- claude_kit/_payload/skills/decision/adr-template.md +36 -0
- claude_kit/_payload/skills/deprecation-and-migration/SKILL.md +207 -0
- claude_kit/_payload/skills/documentation-and-adrs/SKILL.md +299 -0
- claude_kit/_payload/skills/doubt-driven-development/SKILL.md +243 -0
- claude_kit/_payload/skills/execute/SKILL.md +27 -0
- claude_kit/_payload/skills/frontend-ui-engineering/SKILL.md +328 -0
- claude_kit/_payload/skills/git-workflow-and-versioning/SKILL.md +300 -0
- claude_kit/_payload/skills/idea-refine/SKILL.md +178 -0
- claude_kit/_payload/skills/idea-refine/examples.md +238 -0
- claude_kit/_payload/skills/idea-refine/frameworks.md +99 -0
- claude_kit/_payload/skills/idea-refine/refinement-criteria.md +113 -0
- claude_kit/_payload/skills/idea-refine/scripts/idea-refine.sh +15 -0
- claude_kit/_payload/skills/incident-postmortem/SKILL.md +74 -0
- claude_kit/_payload/skills/incremental-implementation/SKILL.md +245 -0
- claude_kit/_payload/skills/interview-me/SKILL.md +221 -0
- claude_kit/_payload/skills/load-testing/SKILL.md +83 -0
- claude_kit/_payload/skills/manual-test/SKILL.md +516 -0
- claude_kit/_payload/skills/performance-optimization/SKILL.md +277 -0
- claude_kit/_payload/skills/planning-and-task-breakdown/SKILL.md +223 -0
- claude_kit/_payload/skills/playwright-verification/SKILL.md +205 -0
- claude_kit/_payload/skills/refresh-docs/SKILL.md +63 -0
- claude_kit/_payload/skills/remember/SKILL.md +96 -0
- claude_kit/_payload/skills/scope/SKILL.md +52 -0
- claude_kit/_payload/skills/scope/scope-template.md +82 -0
- claude_kit/_payload/skills/sdlc/SKILL.md +83 -0
- claude_kit/_payload/skills/security-and-hardening/SKILL.md +368 -0
- claude_kit/_payload/skills/security-verification/SKILL.md +209 -0
- claude_kit/_payload/skills/shipping-and-launch/SKILL.md +309 -0
- claude_kit/_payload/skills/smoke-test/SKILL.md +78 -0
- claude_kit/_payload/skills/source-driven-development/SKILL.md +195 -0
- claude_kit/_payload/skills/spec-driven-development/SKILL.md +200 -0
- claude_kit/_payload/skills/sprint/SKILL.md +67 -0
- claude_kit/_payload/skills/sprint/sprint-template.md +90 -0
- claude_kit/_payload/skills/test-driven-development/SKILL.md +383 -0
- claude_kit/_payload/skills/threat-model/SKILL.md +60 -0
- claude_kit/_payload/skills/triage/SKILL.md +87 -0
- claude_kit/_payload/skills/ui-ux-design/SKILL.md +71 -0
- claude_kit/_payload/skills/unit-test/SKILL.md +237 -0
- claude_kit/_payload/skills/using-agent-skills/SKILL.md +180 -0
- claude_kit/_payload/templates/CLAUDE.md +238 -0
- claude_kit/_payload/templates/CLAUDE.stack.md.tmpl +53 -0
- claude_kit/_payload/templates/CONTINUITY.template.md +35 -0
- claude_kit/_payload/templates/README.claude-sdlc.md.tmpl +219 -0
- claude_kit/_payload/templates/agent-memory/MEMORY.md +30 -0
- claude_kit/_payload/templates/agent-memory/api/.gitkeep +0 -0
- claude_kit/_payload/templates/agent-memory/architecture/.gitkeep +0 -0
- claude_kit/_payload/templates/agent-memory/debugging/.gitkeep +0 -0
- claude_kit/_payload/templates/agent-memory/gotchas/.gitkeep +0 -0
- claude_kit/_payload/templates/agent-memory/patterns/.gitkeep +0 -0
- claude_kit/_payload/templates/agent-memory/performance/.gitkeep +0 -0
- claude_kit/_payload/templates/artifacts/adr.md +18 -0
- claude_kit/_payload/templates/artifacts/feature-spec.md +29 -0
- claude_kit/_payload/templates/artifacts/release-plan.md +23 -0
- claude_kit/_payload/templates/artifacts/runbook.md +24 -0
- claude_kit/_payload/templates/artifacts/security-review.md +23 -0
- claude_kit/_payload/templates/artifacts/test-plan.md +22 -0
- claude_kit/_payload/templates/org/README.md +53 -0
- claude_kit/_payload/templates/org/agents/data-workflow-agent.md +59 -0
- claude_kit/_payload/templates/org/agents/founder-prototype-agent.md +61 -0
- claude_kit/_payload/templates/org/agents/internal-tools-builder.md +63 -0
- claude_kit/_payload/templates/org/agents/pm-copilot.md +60 -0
- claude_kit/_payload/templates/org/agents/support-ticket-engineer.md +63 -0
- claude_kit/_payload/templates/org/packs/devops-and-release/README.md +46 -0
- claude_kit/_payload/templates/org/packs/devops-and-release/pack.yaml +32 -0
- claude_kit/_payload/templates/org/packs/engineering-core/README.md +46 -0
- claude_kit/_payload/templates/org/packs/engineering-core/pack.yaml +44 -0
- claude_kit/_payload/templates/org/packs/non-engineer-builder/README.md +53 -0
- claude_kit/_payload/templates/org/packs/non-engineer-builder/pack.yaml +39 -0
- claude_kit/_payload/templates/org/packs/onboarding-and-docs/README.md +49 -0
- claude_kit/_payload/templates/org/packs/onboarding-and-docs/pack.yaml +26 -0
- claude_kit/_payload/templates/org/packs/product-to-code/README.md +50 -0
- claude_kit/_payload/templates/org/packs/product-to-code/pack.yaml +34 -0
- claude_kit/_payload/templates/org/packs/quality-and-review/README.md +53 -0
- claude_kit/_payload/templates/org/packs/quality-and-review/pack.yaml +40 -0
- claude_kit/_payload/templates/org/packs/security-and-compliance/README.md +50 -0
- claude_kit/_payload/templates/org/packs/security-and-compliance/pack.yaml +36 -0
- claude_kit/_payload/templates/org/rules/ai-working-agreement.md +45 -0
- claude_kit/_payload/templates/org/rules/ambiguity-resolution.md +36 -0
- claude_kit/_payload/templates/org/rules/branch-and-pr-policy.md +41 -0
- claude_kit/_payload/templates/org/rules/compliance-policy.md +50 -0
- claude_kit/_payload/templates/org/rules/non-engineer-safe-coding.md +37 -0
- claude_kit/_payload/templates/org/rules/pii-policy.md +46 -0
- claude_kit/_payload/templates/org/rules/production-data-policy.md +35 -0
- claude_kit/_payload/templates/org/rules/prompt-to-task-conversion.md +30 -0
- claude_kit/_payload/templates/org/rules/prototype-boundaries.md +40 -0
- claude_kit/_payload/templates/org/rules/secrets-policy.md +34 -0
- claude_kit/_payload/templates/org/skills/customer-issue-to-fix/SKILL.md +61 -0
- claude_kit/_payload/templates/org/skills/feature-from-idea/SKILL.md +56 -0
- claude_kit/_payload/templates/org/skills/prompt-to-safe-task/SKILL.md +59 -0
- claude_kit/_payload/templates/org/skills/prototype-to-production/SKILL.md +61 -0
- claude_kit/_payload/templates/org/skills/repo-onboarding/SKILL.md +60 -0
- claude_kit/_payload/templates/settings.json +53 -0
- claude_kit/_payload/templates/stacks/backend/python/fastapi/rules/fastapi-patterns.md +64 -0
- claude_kit/_payload/templates/stacks/db/mongodb/agents/migration-specialist.md +61 -0
- claude_kit/_payload/templates/stacks/db/mongodb/agents/mongodb-specialist.md +59 -0
- claude_kit/_payload/templates/stacks/db/mongodb/rules/mongodb-patterns.md +39 -0
- claude_kit/_payload/templates/stacks/db/postgres/agents/db-performance-reviewer.md +66 -0
- claude_kit/_payload/templates/stacks/db/postgres/agents/migration-specialist.md +56 -0
- claude_kit/_payload/templates/stacks/db/postgres/agents/postgres-specialist.md +58 -0
- claude_kit/_payload/templates/stacks/db/postgres/rules/database-performance.md +64 -0
- claude_kit/_payload/templates/stacks/db/postgres/rules/postgres-patterns.md +43 -0
- claude_kit/_payload/templates/stacks/frontend/react/rules/react-patterns.md +63 -0
- claude_kit/catalog.py +476 -0
- claude_kit/cli.py +327 -0
- claude_kit/hooks.py +246 -0
- claude_kit/models.py +205 -0
- claude_kit/prompts.py +209 -0
- claude_kit/render.py +146 -0
- claude_kit/scaffold.py +492 -0
- claude_kit/upgrader.py +294 -0
- 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`).
|