claude-code-kit 0.11.3__tar.gz → 0.13.0__tar.gz
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.11.3 → claude_code_kit-0.13.0}/.claude-plugin/marketplace.json +1 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/.claude-plugin/plugin.json +1 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/CHANGELOG.md +168 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/CLAUDE.md +3 -2
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/CONTRIBUTING.md +7 -2
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/PKG-INFO +48 -12
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/README.md +47 -11
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/acceptance-reviewer.md +19 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/dependency-scanner.md +18 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/merge-reviewer.md +26 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/observability-engineer.md +1 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/orchestrator.md +2 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/catalog/org.yaml +4 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/catalog/profiles.yaml +5 -2
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/catalog/stacks.yaml +18 -1
- claude_code_kit-0.13.0/commands/abort.md +27 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/docs/agents.md +4 -3
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/docs/architecture.md +2 -1
- claude_code_kit-0.13.0/docs/coverage-audit.md +51 -0
- claude_code_kit-0.13.0/docs/eval-harness.md +58 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/docs/org-capabilities.md +4 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/pyproject.toml +1 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/continuity.md +6 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/devops-observability.md +1 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/evals.md +4 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/mandatory-workflow.md +11 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/model-tiers.md +18 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/quality-gates.md +3 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/ci-cd-and-automation/SKILL.md +9 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/sdlc/SKILL.md +15 -2
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/__init__.py +1 -1
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/catalog.py +2 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/validator.py +15 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/CLAUDE.stack.md.tmpl +1 -0
- claude_code_kit-0.13.0/templates/artifacts/api-change-report.md +29 -0
- claude_code_kit-0.13.0/templates/stacks/backend/go/net-http/rules/go-patterns.md +74 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/mongodb/agents/migration-specialist.md +3 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/mongodb/rules/mongodb-patterns.md +6 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/postgres/agents/migration-specialist.md +4 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/postgres/rules/postgres-patterns.md +7 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/.gitignore +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/LICENSE +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/auditor.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/developer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/devils-advocate.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/devops-engineer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/e2e-tester.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/em-reviewer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/incident-responder.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/owasp-reviewer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/policy-validator.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/pr-raiser.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/risk-classifier.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/sdlc-code-reviewer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/secret-scanner.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/security-reviewer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/senior-backend-dev.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/senior-frontend-dev.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/senior-tester.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/spec-doc-writer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/story-planner.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/technical-architect.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/tester.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/ui-designer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/agents/unit-tester.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/catalog/mcp.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/commands/init.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/commands/sdlc.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/commands/status.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/docs/agentic-patterns.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/hooks.json +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/audit-log.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/guard-destructive-git.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/guard-secrets.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/lint-fix.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/load-autonomy.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/load-continuity.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/load-learnings.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/type-check.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/validate-frontmatter.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/validate-settings.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/warn-large-edits.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/warn-llm-io.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/warn-missing-tests.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/warn-sensitive-files.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/hooks/scripts/warn-shared-modules.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/agent-guardrails.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/agent-memory.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/agent-resilience.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/autonomy-levels.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/code-organization.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/design-patterns.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/documentation.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/frontend-best-practices.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/goal-setting-and-monitoring.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/human-in-the-loop.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/linting-and-formatting.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/rarv-cycle.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/reasoning-techniques.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/responsive-and-accessibility.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/risk-classification.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/testing.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/rules/tool-design.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/scripts/init.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/_references/accessibility-checklist.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/_references/orchestration-patterns.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/_references/performance-checklist.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/_references/security-checklist.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/_references/testing-patterns.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/accessibility-review/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/api-and-interface-design/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/api-integration/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/archive-sprint/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/backlog/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/backlog/item-template.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/browser-testing-with-devtools/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/code-review-and-quality/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/code-simplification/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/component-design/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/consolidate-learnings/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/context-engineering/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/debugging-and-error-recovery/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/decision/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/decision/adr-template.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/deprecation-and-migration/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/documentation-and-adrs/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/doubt-driven-development/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/execute/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/frontend-ui-engineering/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/git-workflow-and-versioning/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/idea-refine/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/idea-refine/examples.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/idea-refine/frameworks.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/idea-refine/refinement-criteria.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/idea-refine/scripts/idea-refine.sh +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/incident-postmortem/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/incremental-implementation/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/interview-me/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/load-testing/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/manual-test/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/over-engineering-review/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/performance-optimization/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/planning-and-task-breakdown/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/playwright-verification/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/refresh-docs/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/remember/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/scope/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/scope/scope-template.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/security-and-hardening/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/security-verification/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/shipping-and-launch/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/simplification-debt/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/smoke-test/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/source-driven-development/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/spec-driven-development/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/sprint/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/sprint/sprint-template.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/task-tracker-sync/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/test-driven-development/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/threat-model/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/triage/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/ui-ux-design/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/unit-test/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/skills/using-agent-skills/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/__main__.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/cli.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/hooks.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/models.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/prompts.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/render.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/scaffold.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/src/claude_kit/upgrader.py +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/CLAUDE.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/CONTINUITY.template.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/README.claude-sdlc.md.tmpl +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/MEMORY.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/api/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/architecture/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/debugging/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/gotchas/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/patterns/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/agent-memory/performance/.gitkeep +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/adr.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/feature-spec.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/release-plan.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/runbook.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/security-review.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/artifacts/test-plan.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/agents/data-workflow-agent.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/agents/founder-prototype-agent.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/agents/internal-tools-builder.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/agents/pm-copilot.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/agents/support-ticket-engineer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/devops-and-release/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/devops-and-release/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/engineering-core/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/engineering-core/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/non-engineer-builder/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/non-engineer-builder/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/onboarding-and-docs/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/onboarding-and-docs/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/product-to-code/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/product-to-code/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/quality-and-review/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/quality-and-review/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/security-and-compliance/README.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/packs/security-and-compliance/pack.yaml +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/ai-working-agreement.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/ambiguity-resolution.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/branch-and-pr-policy.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/compliance-policy.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/non-engineer-safe-coding.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/pii-policy.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/production-data-policy.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/prompt-to-task-conversion.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/prototype-boundaries.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/rules/secrets-policy.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/skills/customer-issue-to-fix/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/skills/feature-from-idea/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/skills/prompt-to-safe-task/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/skills/prototype-to-production/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/org/skills/repo-onboarding/SKILL.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/settings.json +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/backend/python/fastapi/rules/fastapi-patterns.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/mongodb/agents/mongodb-specialist.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/postgres/agents/db-performance-reviewer.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/postgres/agents/postgres-specialist.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/db/postgres/rules/database-performance.md +0 -0
- {claude_code_kit-0.11.3 → claude_code_kit-0.13.0}/templates/stacks/frontend/react/rules/react-patterns.md +0 -0
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"name": "claude-kit",
|
|
11
11
|
"source": "./",
|
|
12
12
|
"description": "Cookiecutter-style scaffolder for an autonomous Claude Code SDLC config (no app code, no Docker): install CLAUDE.md + .claude/ (rules, the profile's agents/skills, hooks, artifact templates) + optional .mcp.json, then run /sdlc to drive spec → review → build → test → security → ship through profile-aware quality gates, working memory, and a self-improving learnings loop.",
|
|
13
|
-
"version": "0.
|
|
13
|
+
"version": "0.13.0",
|
|
14
14
|
"license": "MIT",
|
|
15
15
|
"keywords": ["sdlc", "agents", "orchestration", "quality-gates", "workflow", "scaffold", "cookiecutter"]
|
|
16
16
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-kit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"description": "Cookiecutter-style scaffolder for an autonomous Claude Code SDLC config (no app code, no Docker). `claude-kit init` asks ordered questions and installs CLAUDE.md + .claude/ (rules, the profile's agents/skills, hooks, artifact templates) + optional .mcp.json; run /sdlc to drive spec → review → build → test → security → ship through profile-aware quality gates with working memory and a self-improving learnings loop.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Arjunsingh Yadav",
|
|
@@ -4,6 +4,174 @@ All notable changes to claude-kit are documented here. The format follows
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/), and the project uses
|
|
5
5
|
[semantic versioning](https://semver.org/).
|
|
6
6
|
|
|
7
|
+
## [0.13.0] — 2026-06-15
|
|
8
|
+
|
|
9
|
+
A **second improvement brief** (external self-review, post-0.12.0) — Item 0 (a covered-vs-gated audit)
|
|
10
|
+
+ P0-1/P0-2, P1-1/P1-2/P1-3, and six P2 items — run through the kit's mandated **adversarial
|
|
11
|
+
reuse-first map→verify** (a 24-agent map→verify pass). The decisive finding repeated from last time:
|
|
12
|
+
several premises were **overstated** against the live files (migration safety was already largely
|
|
13
|
+
enforced; the README "no PyPI yet" text was simply stale; the README is already progressively
|
|
14
|
+
disclosed). The result is a mix of **two new gates wired as data, one new live backend stack, and
|
|
15
|
+
targeted extensions** — **zero new agents/skills/rules** beyond what already existed (core counts
|
|
16
|
+
unchanged: 28 agents · 50 skills · 23 rules).
|
|
17
|
+
|
|
18
|
+
### Added
|
|
19
|
+
- **Item 0 — `docs/coverage-audit.md`.** The justification record the briefs kept eliding: every
|
|
20
|
+
"already covered" capability classified **GATED (enforced) / RULE (always-on) / SKILL-DOC
|
|
21
|
+
(advisory)** with file evidence. Verifies rollback (GATED enterprise-only; RULE elsewhere), cost
|
|
22
|
+
(DOC by design), migration safety (overlay-advisory + enterprise rollback), accessibility, and
|
|
23
|
+
flags the one *looks-enforced-but-isn't* trap (the `accessibility-review` skill's internal "Quality
|
|
24
|
+
gates" heading is **not** a gate token).
|
|
25
|
+
- **P0-1 — `contract-clear` reaches the default `standard` profile** (API stacks), not just
|
|
26
|
+
enterprise (`catalog/profiles.yaml`). It still self-skips when the stack exposes no API contract
|
|
27
|
+
surface, so non-API projects are unaffected. *(Deliberate posture change: 0.12.0 placed it in
|
|
28
|
+
enterprise under golden-rule-#6 "heavyweight gates default to enterprise"; the brief explicitly
|
|
29
|
+
authorizes promoting it because breaking-change detection is table-stakes for the headline FastAPI
|
|
30
|
+
backend. Documented, not silent.)* Owned by `merge-reviewer`; quality-gates §4 + mandatory-workflow
|
|
31
|
+
§2d + the api-change-report template updated to say "standard+".
|
|
32
|
+
- **P1-1 — a live Go backend stack** (Go · stdlib **net/http**): a pure `catalog/stacks.yaml` entry +
|
|
33
|
+
`templates/stacks/backend/go/net-http/rules/go-patterns.md` overlay + exact `go` commands
|
|
34
|
+
(`go build ./...`, `go test ./...`, `go vet`, `gofmt`). Chosen over Node/Express precisely because
|
|
35
|
+
its build/test command shapes differ most from npm/pip — the strongest test of the stack-agnostic
|
|
36
|
+
claim. The one supporting code change: a **`build`** key added to `_BACKEND_CMD_KEYS` (compiled
|
|
37
|
+
backends surface a build command; interpreted ones leave it empty). No `resolve()` branch.
|
|
38
|
+
- **P1-2 — `accessibility-clear` gate** at organization scope, **`regulated` strictness only**
|
|
39
|
+
(`catalog/org.yaml` `extra_gates`). Owned by `acceptance-reviewer` (read-only, already present at
|
|
40
|
+
standard+), drives the existing `accessibility-review` skill over changed UI (WCAG-AA), self-skips
|
|
41
|
+
when no UI surface. Wired in `org.yaml` only, so the `lean⊊standard⊊enterprise` profile invariant is
|
|
42
|
+
untouched.
|
|
43
|
+
- **`examples/react-fastapi-postgres-feature/`** (P2-2) — a clearly-labelled **synthetic** end-to-end
|
|
44
|
+
walkthrough: request → feature-spec → story breakdown (coverage gate) → gate verdicts (incl. one
|
|
45
|
+
defect-loop cycle and a Devil's-Advocate CONFIRMED line) → sample PR diff. Repo reference (like
|
|
46
|
+
`docs/`), **not** bundled into the wheel.
|
|
47
|
+
- **`docs/eval-harness.md`** (P2-4) — a fill-in template to measure the pipeline with vs without the
|
|
48
|
+
gates (which gate caught which defect), built on `rules/evals.md` §6 median-of-N. Ships **no**
|
|
49
|
+
numbers by design (an eval result is environment-specific); honesty rules included.
|
|
50
|
+
- **Self-test matrix** (P2-5) — a parametrized test sweeping **every live frontend × backend ×
|
|
51
|
+
database × profile × scope** (now 24 combos incl. Go), each resolved + installed + validated +
|
|
52
|
+
Docker-checked. Driven off `catalog.list_options`, so new live stacks auto-join with no test edit.
|
|
53
|
+
|
|
54
|
+
### Changed
|
|
55
|
+
- **P0-2 — migration safety made explicit.** Both `migration-specialist` overlays (postgres + mongodb)
|
|
56
|
+
already mandated expand/contract, reversible down-path, and idempotent backfill *as agent guidance*;
|
|
57
|
+
added the explicit hard rule **"no destructive drop in the same release as the code that stops using
|
|
58
|
+
the old shape"** with **severity** to the always-on overlay RULES (`postgres-patterns.md`,
|
|
59
|
+
`mongodb-patterns.md`) — so it lives in a rule, not only an agent prompt. (Same-release destruction
|
|
60
|
+
= at least **High**.)
|
|
61
|
+
- **P1-3 — the PyPI story reconciled.** `claude-code-kit` **is** published (latest 0.12.0); the README
|
|
62
|
+
install block, troubleshooting row, and a stale `changelog-v0.10.0` badge said otherwise. Install is
|
|
63
|
+
now `pip install claude-code-kit`; the changelog badge is de-versioned (self-healing); the CI
|
|
64
|
+
publish machinery (`publish.yml`) was correct and left untouched.
|
|
65
|
+
- **P2-3 (on-ramp, minimal)** — added an **Examples** nav link + pipeline pointer only; the proposed
|
|
66
|
+
full README restructure was **rejected** (see below). Pipeline gate table + `docs/architecture.md`
|
|
67
|
+
diagram updated for `contract-clear` (standard+) and the Go stack.
|
|
68
|
+
|
|
69
|
+
### Not adopted (deliberately — premise overstated or against the kit's design)
|
|
70
|
+
- **A dedicated migration GATE token (P0-2).** Migrations are overlay-conditioned and not every-run;
|
|
71
|
+
`resolve()` can't emit stack gates without a branch. Strengthened the always-on overlay rules +
|
|
72
|
+
reviewer agents instead — enforcement via review + the enterprise rollback gate (`pipeline-green`),
|
|
73
|
+
per the coverage audit.
|
|
74
|
+
- **Node/Express as the new backend (P1-1).** Chose **Go** instead — its command shapes differ more
|
|
75
|
+
from the existing npm/pip stacks, which is the whole point of the breadth test. Express/Vue/Svelte/
|
|
76
|
+
Django remain `planned`.
|
|
77
|
+
- **A full README restructure + GIF (P2-3).** The README already uses progressive disclosure
|
|
78
|
+
(`<details>`); a big move-to-`docs/` churn is negative-value and a GIF can't be produced here. Added
|
|
79
|
+
only the example link. (Recording a demo GIF is a human follow-up.)
|
|
80
|
+
- **Relocating the CHANGELOG "Not adopted" blocks to `docs/decision-log.md` (P2-6).** Those blocks are
|
|
81
|
+
a **marketed feature** the README links to; moving them would break that cross-reference for low
|
|
82
|
+
value. Added a forward-looking note in `CONTRIBUTING.md` instead (split later *only if* the README
|
|
83
|
+
link is updated in the same change).
|
|
84
|
+
- **Repo About-box metadata (P2-1)** — host config outside the payload; `gh` is unavailable here.
|
|
85
|
+
Human follow-up: `gh repo edit ajyadav013/claude-kit --description "Config-only, stack-agnostic
|
|
86
|
+
autonomous-SDLC scaffolder for Claude Code (plugin + pip)" --add-topic claude-code --add-topic
|
|
87
|
+
claude-code-plugins --add-topic sdlc --add-topic ai-agents --add-topic agentic-coding --add-topic
|
|
88
|
+
claude-skills`.
|
|
89
|
+
|
|
90
|
+
## [0.12.0] — 2026-06-15
|
|
91
|
+
|
|
92
|
+
An **improvement brief** (external self-review, no repo access) proposed ~15 changes — four P0, five
|
|
93
|
+
P1, six P2. Run through the kit's own mandated **adversarial reuse-first mapping** (an 18-agent
|
|
94
|
+
map→verify pass), **every substantive (P0/P1) item resolved to _extend an existing component_, not add
|
|
95
|
+
a new one** — the brief, written without the repo, repeatedly proposed agents/gates/skills that already
|
|
96
|
+
ship. The result is **one new quality gate, one new artifact template, one new slash command, and a set
|
|
97
|
+
of surgical edits to existing files — zero new agents, skills, or rules** (counts unchanged: 28 core
|
|
98
|
+
agents · 50 skills · 23 rules). Config-only, stack-agnostic, no Docker, no new `resolve()` branches.
|
|
99
|
+
|
|
100
|
+
### Added
|
|
101
|
+
- **`contract-clear` quality gate** (enterprise profile; API-exposing backend stacks only). A
|
|
102
|
+
pre-merge **API backward-compatibility** gate **owned by the existing `merge-reviewer`** (not a new
|
|
103
|
+
agent): it diffs the API contract against the base branch (`git show <base>:<contract>`), classifies
|
|
104
|
+
each delta by the kit's severity model (removed/renamed endpoint or field, narrowed type, new
|
|
105
|
+
required field, removed status code = **Critical/High**), and blocks a breaking change that lacks an
|
|
106
|
+
approved migration note + version bump. **Self-skips** when the stack has no contract surface, so it
|
|
107
|
+
is inert for non-API projects. Wired as **data** in `catalog/profiles.yaml` (enterprise gate list),
|
|
108
|
+
documented in `rules/quality-gates.md` §4, and sequenced as the mechanical counterpart to
|
|
109
|
+
`mandatory-workflow.md` §2d. Builds **on** §2d's existing manual breaking-change check rather than
|
|
110
|
+
replacing it.
|
|
111
|
+
- **`templates/artifacts/api-change-report.md`** — the `contract-clear` gate's output artifact
|
|
112
|
+
(contract source · base ref · added/changed/removed tables with per-row severity · backward-compat
|
|
113
|
+
verdict · affected consumers). Installs with the other artifact templates.
|
|
114
|
+
- **`/claude-kit:abort`** slash command (`commands/abort.md`) — a guided, **reversible** mid-pipeline
|
|
115
|
+
cleanup: confirm a run is in progress, remove **only the worktrees this run created**, mark
|
|
116
|
+
`CONTINUITY.md` aborted. Deliberately **not** a `claude-kit abort` CLI subcommand (a destructive
|
|
117
|
+
one-shot CLI for "remove worktrees" is exactly the kind of irreversible action the kit gates).
|
|
118
|
+
|
|
119
|
+
### Changed (surgical extensions to existing components)
|
|
120
|
+
- **`skills/ci-cd-and-automation`** — named **Blue/Green vs Canary** as an explicit deployment-strategy
|
|
121
|
+
subsection (blue/green was never named anywhere in the kit; cross-refs the existing Rollout Decision
|
|
122
|
+
Thresholds). *(P0-1 — the only real gap; see "Not adopted" for the rest of P0-1.)*
|
|
123
|
+
- **`rules/devops-observability.md` + `agents/observability-engineer.md`** — Observability Ready now
|
|
124
|
+
requires, **for a hot / SLO-bearing backend path**, an empirical load run (drive the existing
|
|
125
|
+
`load-testing` skill) that meets its p95/p99 latency, error-rate, and throughput budgets; a budget
|
|
126
|
+
breach is **High**. Recorded in the `quality-gates.md` §4 row. No new gate, no new agent. *(P0-3)*
|
|
127
|
+
- **`agents/dependency-scanner.md`** — added a **Cadence Mode** (a whole-project, scheduled
|
|
128
|
+
supply-chain maintenance pass: batch grouped upgrades, defer triage to `security-and-hardening`,
|
|
129
|
+
re-run the existing gates on applied upgrades). Scheduling is left to org CI (the kit has no
|
|
130
|
+
time-driven hook). No new skill. *(P0-4)*
|
|
131
|
+
- **`rules/model-tiers.md`** — added a **profile cost expectations** subsection (relative, non-currency
|
|
132
|
+
ballpark: lean cheapest → enterprise heaviest, noting enterprise still runs only four opus agents).
|
|
133
|
+
*(P1-1)*
|
|
134
|
+
- **`skills/sdlc` + `agents/orchestrator.md`** — `/sdlc` now **detects an in-progress run** from
|
|
135
|
+
`CONTINUITY.md` and offers **resume** (re-enter at the first gate after the last PASS, read from the
|
|
136
|
+
orchestrator's `PIPELINE:` state line) **vs restart**; the orchestrator's Stage-7 summary now reports
|
|
137
|
+
per-gate PASS/FAIL + severity + PR-or-ABORTED and **tears down this run's worktrees**. *(P1-2, P1-3)*
|
|
138
|
+
- **`rules/mandatory-workflow.md`** — §2a now states the **worktree lifecycle** (one per lane → merge
|
|
139
|
+
after gates pass → remove after the PR is raised or the run is aborted); §2d gained a note pointing
|
|
140
|
+
at the mechanical `contract-clear` counterpart. *(P1-3)*
|
|
141
|
+
- **`rules/continuity.md`** — added a **Concurrency** subsection (one live `CONTINUITY.md` per working
|
|
142
|
+
dir; use a worktree per concurrent `/sdlc`; `agent-memory` is intentionally shared, not namespaced).
|
|
143
|
+
*(P1-4)*
|
|
144
|
+
- **`src/claude_kit/validator.py` + README** — `claude-kit doctor` now reports **platform visibility**:
|
|
145
|
+
on Windows without `jq` it WARNs (actionable: run under WSL/Git Bash; config + CLI work natively
|
|
146
|
+
regardless) and on Windows *with* `jq` it confirms a POSIX shell is providing the hooks — **never a
|
|
147
|
+
failure**. README gained a Windows prerequisites note + troubleshooting row. *(P1-5)*
|
|
148
|
+
|
|
149
|
+
### Not adopted (deliberately — the kit already covers these)
|
|
150
|
+
- **P0-1 `release-manager`/`release-ready`/`rollback-safety` (new agent + gate + rule).** Release &
|
|
151
|
+
rollback are **already owned by `devops-engineer`** (and the Pipeline Green gate already requires a
|
|
152
|
+
*verified* rollback + runbook); canary, feature flags, staged rollout, and rollback are already
|
|
153
|
+
covered in depth by the `shipping-and-launch` skill. Only "blue/green was never named" was a genuine
|
|
154
|
+
gap — fixed above as one subsection, no new components.
|
|
155
|
+
- **P0-2 `contract-reviewer` agent in the _standard_ profile.** Reused `merge-reviewer` instead of a
|
|
156
|
+
new agent, and placed the gate in **enterprise** (heavyweight gates default to enterprise per the
|
|
157
|
+
profile policy), not standard. It also **builds on** `mandatory-workflow.md` §2d rather than
|
|
158
|
+
duplicating it.
|
|
159
|
+
- **P0-3 `performance-engineer` agent + standalone performance gate.** Folded into the existing
|
|
160
|
+
Observability Ready gate + `observability-engineer` + `load-testing` skill.
|
|
161
|
+
- **P0-4 `dependency-maintenance` skill.** Folded into the existing `dependency-scanner` agent as a
|
|
162
|
+
mode; no competing skill.
|
|
163
|
+
- **P1-1 `cost-estimate` skill + a per-run cost hook.** A doc subsection in `model-tiers.md` conveys
|
|
164
|
+
the expectation without a runtime token-accounting surface the kit can't reliably measure.
|
|
165
|
+
- **P1-3 a `run-report` subsystem / structured run trace.** Already covered by `CONTINUITY.md` working
|
|
166
|
+
memory + the orchestrator's Stage-7 summary; only the genuine gaps (worktree teardown + clean abort)
|
|
167
|
+
were added.
|
|
168
|
+
- **P1-5 a PowerShell hook port.** The hooks stay POSIX `.sh`; `doctor` now tells Windows users to run
|
|
169
|
+
under WSL/Git Bash. Porting every guard to PowerShell would double the maintenance surface for a
|
|
170
|
+
shell most users already have via WSL/Git Bash.
|
|
171
|
+
- **The P2 items** (repo metadata, PyPI publish, listing submissions) that require a human / `gh` are
|
|
172
|
+
left as follow-ups; the **E2E worked example**, **positioning section**, and **README on-ramp** were
|
|
173
|
+
partly addressed (a "How claude-kit compares" positioning block + the adoption row were added).
|
|
174
|
+
|
|
7
175
|
## [0.11.3] — 2026-06-15
|
|
8
176
|
|
|
9
177
|
A field review of a **reference table of ecosystem repos** — official + community **MCP-server
|
|
@@ -29,8 +29,9 @@ distributed two ways from one source of truth:
|
|
|
29
29
|
| `templates/org/` | **Org overlay** content (scope-gated, organization only): `skills/`, `agents/` (personas), `rules/` (policy/vibe), `packs/<pack>/{pack.yaml,README.md}`, `README.md`. Wired via `catalog/org.yaml`. The only place org-specific content lives. |
|
|
30
30
|
| `scripts/init.sh` | Thin no-pip fallback scaffolder (copies the full payload; no catalog resolution) |
|
|
31
31
|
| `src/claude_kit/` | The pip CLI (Typer): `cli.py`, `catalog.py` (resolver), `prompts.py`, `models.py`, `scaffold.py` (installer), `render.py` (Jinja2), `hooks.py`, `validator.py`, `upgrader.py` |
|
|
32
|
-
| `tests/` | pytest suite (catalog, render, scaffold, validator, upgrader, CLI) |
|
|
33
|
-
| `
|
|
32
|
+
| `tests/` | pytest suite (catalog, render, scaffold, validator, upgrader, CLI; incl. the profile×stack×scope self-test matrix) |
|
|
33
|
+
| `examples/` | Synthetic end-to-end `/sdlc` worked example (repo reference; **not** bundled into the wheel) |
|
|
34
|
+
| `docs/architecture.md` · `docs/agents.md` · `docs/coverage-audit.md` · `docs/eval-harness.md` | Architecture diagrams · agent guide · the GATED-vs-RULE-vs-SKILL enforcement audit · the with/without eval template |
|
|
34
35
|
| `pyproject.toml` | Packaging (deps: typer/jinja2/pyyaml); `[tool.hatch...force-include]` bundles the payload into the wheel |
|
|
35
36
|
|
|
36
37
|
**One source of truth:** `agents/ skills/ commands/ hooks/ rules/ templates/ catalog/` at the repo
|
|
@@ -83,9 +83,14 @@ a specific stack — `pytest` enforces the no-Docker invariant on a scaffolded p
|
|
|
83
83
|
|
|
84
84
|
1. Bump the version in **all four** places: `pyproject.toml`, `.claude-plugin/plugin.json`, the
|
|
85
85
|
`.claude-plugin/marketplace.json` entry, and `src/claude_kit/__init__.py`.
|
|
86
|
-
2. Add a `CHANGELOG.md` entry
|
|
86
|
+
2. Add a `CHANGELOG.md` entry, including a **"Not adopted (deliberately)"** block stating what you
|
|
87
|
+
chose *not* to add and why — this is a marketed feature of the changelog (the README links to it),
|
|
88
|
+
so keep it. If those blocks ever grow unwieldy they may later split into `docs/decision-log.md`,
|
|
89
|
+
but **only if** the README's CHANGELOG cross-reference is updated in the same change; until then
|
|
90
|
+
they stay in `CHANGELOG.md` by design.
|
|
87
91
|
3. `pytest` green, then `python3 -m build && python3 -m twine check dist/*`.
|
|
88
|
-
4.
|
|
92
|
+
4. CI auto-publishes to PyPI on merge to `main` when the version is new (`.github/workflows/publish.yml`,
|
|
93
|
+
OIDC trusted publishing). Manual `python3 -m twine upload dist/*` is the fallback.
|
|
89
94
|
5. Tag the release and push so plugin users get the update.
|
|
90
95
|
|
|
91
96
|
## License
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: claude-code-kit
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.13.0
|
|
4
4
|
Summary: Cookiecutter-style scaffolder for an autonomous Claude Code SDLC configuration (no app code, no Docker). Asks ordered questions and installs CLAUDE.md + .claude/ (rules, the chosen profile's agents/skills, hooks, artifact templates) + optional .mcp.json; run /sdlc to drive spec → review → build → test → security → ship through profile-aware quality gates, working memory, and a self-improving learnings loop.
|
|
5
5
|
Project-URL: Homepage, https://github.com/ajyadav013/claude-kit
|
|
6
6
|
Project-URL: Repository, https://github.com/ajyadav013/claude-kit
|
|
@@ -39,9 +39,9 @@ with a quality gate between every phase. **No application code. No Docker. Confi
|
|
|
39
39
|
[](LICENSE)
|
|
40
40
|
[](https://www.claude.com/product/claude-code)
|
|
41
41
|
[](https://github.com/ajyadav013/claude-kit/actions/workflows/ci.yml)
|
|
42
|
-
[](CHANGELOG.md)
|
|
43
43
|
|
|
44
|
-
🚀 [Quick start](#quick-start) · 🧭 [How it works](#how-it-works) · 🔁 [The pipeline](#the-pipeline) · 🌱 [What we adopted](#influences--what-we-adopted) · 🤖 [Agents](#the-agents) · 🧩 [Catalog](#catalog--extensibility) · 🛠️ [CLI](#cli-reference) · 📖 [Agent guide](docs/agents.md)
|
|
44
|
+
🚀 [Quick start](#quick-start) · 🧭 [How it works](#how-it-works) · 🔁 [The pipeline](#the-pipeline) · 🧪 [Example](examples/) · 🌱 [What we adopted](#influences--what-we-adopted) · 🤖 [Agents](#the-agents) · 🧩 [Catalog](#catalog--extensibility) · 🛠️ [CLI](#cli-reference) · 📖 [Agent guide](docs/agents.md)
|
|
45
45
|
|
|
46
46
|
</div>
|
|
47
47
|
|
|
@@ -59,7 +59,7 @@ refuses to advance a phase until its **quality gate** passes. You drive it all w
|
|
|
59
59
|
**At a glance:**
|
|
60
60
|
|
|
61
61
|
- 🧱 **Stack-agnostic** — the pipeline assumes no language or framework. Pick a stack at `init` and it
|
|
62
|
-
installs matching overlay rules (React · FastAPI · PostgreSQL · MongoDB) and your exact
|
|
62
|
+
installs matching overlay rules (React · FastAPI · Go/net-http · PostgreSQL · MongoDB) and your exact
|
|
63
63
|
lint/test/build commands. It never writes your app code and never needs Docker.
|
|
64
64
|
- 🎚️ **Dial the rigor with profiles** — `lean ⊊ standard ⊊ enterprise` decide how many agents, skills,
|
|
65
65
|
hooks, and gates are active, from "fast track" to "full audit".
|
|
@@ -109,9 +109,9 @@ Then, inside any project you want the pipeline to manage:
|
|
|
109
109
|
A CLI (`claude-kit`, aliases `ckit` / `claude-sdlc`) that scaffolds the same config into any repo:
|
|
110
110
|
|
|
111
111
|
```bash
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
#
|
|
112
|
+
pip install claude-code-kit
|
|
113
|
+
# or, for the bleeding edge straight from the repo:
|
|
114
|
+
# pip install "git+https://github.com/ajyadav013/claude-kit.git"
|
|
115
115
|
|
|
116
116
|
claude-kit init # interactive: prompts for stack, profile, MCP
|
|
117
117
|
claude-kit init --defaults # non-interactive: React + Python/FastAPI + Postgres + standard
|
|
@@ -122,6 +122,11 @@ claude-kit init --defaults # non-interactive: React + Python/FastAPI + Post
|
|
|
122
122
|
> **Prerequisites:** [Claude Code](https://www.claude.com/product/claude-code); Python ≥ 3.9 for the
|
|
123
123
|
> CLI; `jq` to enable the shell hooks (they no-op without it); Node / `npx` only if you enable an MCP
|
|
124
124
|
> (Model Context Protocol) server.
|
|
125
|
+
>
|
|
126
|
+
> **Windows:** the config (agents · skills · rules) and the `claude-kit` CLI work natively. The shell
|
|
127
|
+
> hooks (`guard-*`, `warn-*`) need a POSIX shell + `jq`, so run inside **WSL or Git Bash** to enable
|
|
128
|
+
> them — `claude-kit doctor` detects Windows and tells you which case you're in. Without a POSIX shell
|
|
129
|
+
> the hooks silently no-op (the kit still functions; you just lose the deterministic guards).
|
|
125
130
|
|
|
126
131
|
<details>
|
|
127
132
|
<summary><b>What the init flow asks & what lands on disk</b></summary>
|
|
@@ -218,10 +223,16 @@ flowchart TD
|
|
|
218
223
|
| Profile | Gates that run |
|
|
219
224
|
|---|---|
|
|
220
225
|
| **lean** | code-review · build-green |
|
|
221
|
-
| **standard** | spec-complete · em-approved · code-review · build-green · test-coverage · security-clear |
|
|
226
|
+
| **standard** | spec-complete · em-approved · code-review · build-green · test-coverage · security-clear · contract-clear\* |
|
|
222
227
|
| **enterprise** | standard + pipeline-green · observability-ready · acceptance |
|
|
223
228
|
|
|
224
|
-
|
|
229
|
+
\* `contract-clear` (API breaking-change diff) self-skips when the stack exposes no API surface, so it
|
|
230
|
+
is inert for non-API projects. Organization scope at `regulated` strictness adds `accessibility-clear`
|
|
231
|
+
(WCAG-AA on changed UI). A **fast-track** mode collapses small changes (< 5 files) to Developer →
|
|
232
|
+
Code Reviewer → Tester → PR.
|
|
233
|
+
|
|
234
|
+
See [`examples/`](examples/) for a synthetic end-to-end walkthrough — request → spec → story breakdown
|
|
235
|
+
→ gate verdicts (with one defect-loop cycle) → sample PR diff.
|
|
225
236
|
|
|
226
237
|
---
|
|
227
238
|
|
|
@@ -239,6 +250,8 @@ non-duplicative gaps**, minimally and catalog-wired.
|
|
|
239
250
|
| **[ponytail](https://github.com/DietrichGebert/ponytail)** | YAGNI / anti-over-engineering as an explicit recurring pass; deferral-debt tracking; surfacing the active autonomy level | `over-engineering-review` & `simplification-debt` skills, the `load-autonomy` hook, median-of-N in `evals` | `0.8.0` |
|
|
240
251
|
| **[GitHub spec-kit](https://github.com/github/spec-kit)** | Spec → tasks → **analyze** coverage gate; tasks → tracker issues; stable requirement IDs + assumptions in specs | Wired the (previously orphaned) `story-planner` as the **coverage gate (1f)**, a tracker-agnostic `task-tracker-sync` skill, and enriched the feature-spec template | `0.9.0` |
|
|
241
252
|
| **[protectai/llm-guard](https://github.com/protectai/llm-guard)** | Input→model→output guardrails for LLM features — prompt injection, PII vault, treating model output as untrusted | **Opt-in** "LLM / AI Feature Security" guidance in `security-and-hardening` + the advisory `warn-llm-io` hook (warns, **never blocks**) | `0.10.0` |
|
|
253
|
+
| **Improvement brief** (external self-review) | API backward-compat as a gate; load-against-SLO as a release criterion; supply-chain maintenance cadence; pipeline resumability, clean abort, and worktree lifecycle; pipeline cost/concurrency/cross-platform transparency | The enterprise **`contract-clear`** gate (owned by `merge-reviewer`) + `api-change-report` template; a load-vs-SLO criterion in Observability Ready; dependency **Cadence Mode**; `/sdlc` resume-vs-restart, `/claude-kit:abort`, worktree teardown; cost/concurrency/Windows notes — **9 surgical extensions, 0 new agents/skills/rules** | `0.12.0` |
|
|
254
|
+
| **Improvement brief #2** (external self-review) | The covered-vs-**gated** distinction (a skill ≠ a gate); enforce API breaking-changes by default; expand/contract migration safety; back the stack-agnostic claim with a compiled backend; WCAG as a regulated gate; reconcile the PyPI story; ship a worked example + a self-test matrix | [`docs/coverage-audit.md`](docs/coverage-audit.md); **`contract-clear` promoted to `standard`**; a live **Go/net-http** backend; the **`accessibility-clear`** regulated gate; explicit migration-drop rules; a synthetic [`examples/`](examples/) run; an eval-harness template; a profile×stack×scope self-test matrix — **2 gates wired + 1 stack, 0 new agents/skills/rules** | `0.13.0` |
|
|
242
255
|
|
|
243
256
|
> Each adoption is detailed in the [CHANGELOG](CHANGELOG.md) — including, for every review, what we
|
|
244
257
|
> deliberately **did not** add because the kit already covered it.
|
|
@@ -273,6 +286,28 @@ mandatory security gate — that would have made it mandatory.
|
|
|
273
286
|
|
|
274
287
|
</details>
|
|
275
288
|
|
|
289
|
+
<details>
|
|
290
|
+
<summary><b>How claude-kit compares (positioning)</b></summary>
|
|
291
|
+
|
|
292
|
+
<br>
|
|
293
|
+
|
|
294
|
+
claude-kit is a **config-only, stack-agnostic SDLC scaffolder** — it installs a governed pipeline
|
|
295
|
+
(agents · skills · rules · gates · hooks) into your project's `.claude/` and then gets out of the way.
|
|
296
|
+
It is **not** a runtime, an orchestration engine, or a code library. That framing is the difference:
|
|
297
|
+
|
|
298
|
+
| Project | What it is | How claude-kit differs |
|
|
299
|
+
|---|---|---|
|
|
300
|
+
| **[wshobson/agents](https://github.com/wshobson/agents)** & similar agent collections | Large libraries of individual subagent prompts you pick from | claude-kit ships a **smaller, opinionated set wired into a sequenced pipeline with owned quality gates** — agents aren't a menu, they're stages that hand off and block on each other. Adopt-by-reuse, not by accumulation. |
|
|
301
|
+
| **[GitHub spec-kit](https://github.com/github/spec-kit)** | A spec-driven workflow (constitution → spec → tasks → analyze) | claude-kit **absorbed spec-kit's coverage-gate idea** (the `story-planner` 1f gate + `task-tracker-sync`) into a **broader** lifecycle that also covers review, security, build, test, release, and observability gates. Complementary, wider scope. |
|
|
302
|
+
| **claude-flow / multi-agent runtimes** | Runtime orchestrators that *execute* swarms of agents | claude-kit produces **portable configuration**, not a running process — the orchestration is described in rules the host (Claude Code) executes. No daemon, no lock-in, no app code. |
|
|
303
|
+
| **dotfiles / `CLAUDE.md` starters** | A single rules file or settings snippet | claude-kit is a **catalog-driven generator**: it resolves your stack/profile/scope into the right subset of 23 rules, ~28 agents, ~50 skills, gates, and hooks, and keeps them **upgradeable** (`claude-kit upgrade` preserves your edits via owner + checksum). |
|
|
304
|
+
|
|
305
|
+
**Choose claude-kit when** you want a consistent, reviewable, **gate-enforced** autonomous-SDLC setup
|
|
306
|
+
that's the same across every repo and stack, installs in seconds, ships nothing you have to run, and
|
|
307
|
+
**evolves reuse-first** rather than by piling on near-duplicate agents.
|
|
308
|
+
|
|
309
|
+
</details>
|
|
310
|
+
|
|
276
311
|
---
|
|
277
312
|
|
|
278
313
|
## The agents
|
|
@@ -358,8 +393,8 @@ change.
|
|
|
358
393
|
<br>
|
|
359
394
|
|
|
360
395
|
- **`catalog/stacks.yaml`** — frontend frameworks, backend languages → frameworks, and databases.
|
|
361
|
-
Live today: React · Python/FastAPI · PostgreSQL/MongoDB. Vue/Svelte/Django/Express
|
|
362
|
-
`planned` (offered by `list-options`, not yet selectable).
|
|
396
|
+
Live today: React · Python/FastAPI · **Go/net-http** · PostgreSQL/MongoDB. Vue/Svelte/Django/Express
|
|
397
|
+
are listed as `planned` (offered by `list-options`, not yet selectable).
|
|
363
398
|
- **`catalog/profiles.yaml`** — what each profile activates (`inherit:` composes; `all` = everything).
|
|
364
399
|
- **`catalog/mcp.yaml`** — ready `.mcp.json` fragments per server, with `${ENV}` placeholders.
|
|
365
400
|
- **`catalog/org.yaml`** — the **organization layer**: scopes, teams, the autonomy model, review
|
|
@@ -424,8 +459,9 @@ hints.
|
|
|
424
459
|
|---|---|---|
|
|
425
460
|
| `/sdlc`, agents, or skills "not found" right after `init` | Claude Code hasn't loaded the new project config yet | **Restart Claude Code** — or use `/claude-kit:sdlc <task>` (works without a restart) |
|
|
426
461
|
| Guard / quality hooks seem to do nothing | `jq` isn't installed (the hooks parse tool input with it) | Install `jq`; without it the hooks degrade to no-ops by design |
|
|
462
|
+
| Hooks do nothing on **Windows** | No POSIX shell — `.sh` hooks can't run under `cmd`/PowerShell | Run claude-kit inside **WSL or Git Bash** (with `jq`); `claude-kit doctor` confirms. Config + CLI work natively regardless |
|
|
427
463
|
| A selected MCP server won't start | `node` / `npx` missing (most MCP servers launch via `npx`) | Install Node.js, or remove the server from `.mcp.json` |
|
|
428
|
-
| `pip install claude-code-kit` fails |
|
|
464
|
+
| `pip install claude-code-kit` fails | Outdated `pip`, or you want an unreleased change | Upgrade pip (`pip install -U pip`); for unreleased changes use `pip install "git+https://github.com/ajyadav013/claude-kit.git"` |
|
|
429
465
|
| `validate` reports missing files | Partial or outdated install | Re-run `claude-kit init` (choose **merge**), or `claude-kit upgrade` |
|
|
430
466
|
|
|
431
467
|
</details>
|
|
@@ -12,9 +12,9 @@ with a quality gate between every phase. **No application code. No Docker. Confi
|
|
|
12
12
|
[](LICENSE)
|
|
13
13
|
[](https://www.claude.com/product/claude-code)
|
|
14
14
|
[](https://github.com/ajyadav013/claude-kit/actions/workflows/ci.yml)
|
|
15
|
-
[](CHANGELOG.md)
|
|
16
16
|
|
|
17
|
-
🚀 [Quick start](#quick-start) · 🧭 [How it works](#how-it-works) · 🔁 [The pipeline](#the-pipeline) · 🌱 [What we adopted](#influences--what-we-adopted) · 🤖 [Agents](#the-agents) · 🧩 [Catalog](#catalog--extensibility) · 🛠️ [CLI](#cli-reference) · 📖 [Agent guide](docs/agents.md)
|
|
17
|
+
🚀 [Quick start](#quick-start) · 🧭 [How it works](#how-it-works) · 🔁 [The pipeline](#the-pipeline) · 🧪 [Example](examples/) · 🌱 [What we adopted](#influences--what-we-adopted) · 🤖 [Agents](#the-agents) · 🧩 [Catalog](#catalog--extensibility) · 🛠️ [CLI](#cli-reference) · 📖 [Agent guide](docs/agents.md)
|
|
18
18
|
|
|
19
19
|
</div>
|
|
20
20
|
|
|
@@ -32,7 +32,7 @@ refuses to advance a phase until its **quality gate** passes. You drive it all w
|
|
|
32
32
|
**At a glance:**
|
|
33
33
|
|
|
34
34
|
- 🧱 **Stack-agnostic** — the pipeline assumes no language or framework. Pick a stack at `init` and it
|
|
35
|
-
installs matching overlay rules (React · FastAPI · PostgreSQL · MongoDB) and your exact
|
|
35
|
+
installs matching overlay rules (React · FastAPI · Go/net-http · PostgreSQL · MongoDB) and your exact
|
|
36
36
|
lint/test/build commands. It never writes your app code and never needs Docker.
|
|
37
37
|
- 🎚️ **Dial the rigor with profiles** — `lean ⊊ standard ⊊ enterprise` decide how many agents, skills,
|
|
38
38
|
hooks, and gates are active, from "fast track" to "full audit".
|
|
@@ -82,9 +82,9 @@ Then, inside any project you want the pipeline to manage:
|
|
|
82
82
|
A CLI (`claude-kit`, aliases `ckit` / `claude-sdlc`) that scaffolds the same config into any repo:
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
#
|
|
85
|
+
pip install claude-code-kit
|
|
86
|
+
# or, for the bleeding edge straight from the repo:
|
|
87
|
+
# pip install "git+https://github.com/ajyadav013/claude-kit.git"
|
|
88
88
|
|
|
89
89
|
claude-kit init # interactive: prompts for stack, profile, MCP
|
|
90
90
|
claude-kit init --defaults # non-interactive: React + Python/FastAPI + Postgres + standard
|
|
@@ -95,6 +95,11 @@ claude-kit init --defaults # non-interactive: React + Python/FastAPI + Post
|
|
|
95
95
|
> **Prerequisites:** [Claude Code](https://www.claude.com/product/claude-code); Python ≥ 3.9 for the
|
|
96
96
|
> CLI; `jq` to enable the shell hooks (they no-op without it); Node / `npx` only if you enable an MCP
|
|
97
97
|
> (Model Context Protocol) server.
|
|
98
|
+
>
|
|
99
|
+
> **Windows:** the config (agents · skills · rules) and the `claude-kit` CLI work natively. The shell
|
|
100
|
+
> hooks (`guard-*`, `warn-*`) need a POSIX shell + `jq`, so run inside **WSL or Git Bash** to enable
|
|
101
|
+
> them — `claude-kit doctor` detects Windows and tells you which case you're in. Without a POSIX shell
|
|
102
|
+
> the hooks silently no-op (the kit still functions; you just lose the deterministic guards).
|
|
98
103
|
|
|
99
104
|
<details>
|
|
100
105
|
<summary><b>What the init flow asks & what lands on disk</b></summary>
|
|
@@ -191,10 +196,16 @@ flowchart TD
|
|
|
191
196
|
| Profile | Gates that run |
|
|
192
197
|
|---|---|
|
|
193
198
|
| **lean** | code-review · build-green |
|
|
194
|
-
| **standard** | spec-complete · em-approved · code-review · build-green · test-coverage · security-clear |
|
|
199
|
+
| **standard** | spec-complete · em-approved · code-review · build-green · test-coverage · security-clear · contract-clear\* |
|
|
195
200
|
| **enterprise** | standard + pipeline-green · observability-ready · acceptance |
|
|
196
201
|
|
|
197
|
-
|
|
202
|
+
\* `contract-clear` (API breaking-change diff) self-skips when the stack exposes no API surface, so it
|
|
203
|
+
is inert for non-API projects. Organization scope at `regulated` strictness adds `accessibility-clear`
|
|
204
|
+
(WCAG-AA on changed UI). A **fast-track** mode collapses small changes (< 5 files) to Developer →
|
|
205
|
+
Code Reviewer → Tester → PR.
|
|
206
|
+
|
|
207
|
+
See [`examples/`](examples/) for a synthetic end-to-end walkthrough — request → spec → story breakdown
|
|
208
|
+
→ gate verdicts (with one defect-loop cycle) → sample PR diff.
|
|
198
209
|
|
|
199
210
|
---
|
|
200
211
|
|
|
@@ -212,6 +223,8 @@ non-duplicative gaps**, minimally and catalog-wired.
|
|
|
212
223
|
| **[ponytail](https://github.com/DietrichGebert/ponytail)** | YAGNI / anti-over-engineering as an explicit recurring pass; deferral-debt tracking; surfacing the active autonomy level | `over-engineering-review` & `simplification-debt` skills, the `load-autonomy` hook, median-of-N in `evals` | `0.8.0` |
|
|
213
224
|
| **[GitHub spec-kit](https://github.com/github/spec-kit)** | Spec → tasks → **analyze** coverage gate; tasks → tracker issues; stable requirement IDs + assumptions in specs | Wired the (previously orphaned) `story-planner` as the **coverage gate (1f)**, a tracker-agnostic `task-tracker-sync` skill, and enriched the feature-spec template | `0.9.0` |
|
|
214
225
|
| **[protectai/llm-guard](https://github.com/protectai/llm-guard)** | Input→model→output guardrails for LLM features — prompt injection, PII vault, treating model output as untrusted | **Opt-in** "LLM / AI Feature Security" guidance in `security-and-hardening` + the advisory `warn-llm-io` hook (warns, **never blocks**) | `0.10.0` |
|
|
226
|
+
| **Improvement brief** (external self-review) | API backward-compat as a gate; load-against-SLO as a release criterion; supply-chain maintenance cadence; pipeline resumability, clean abort, and worktree lifecycle; pipeline cost/concurrency/cross-platform transparency | The enterprise **`contract-clear`** gate (owned by `merge-reviewer`) + `api-change-report` template; a load-vs-SLO criterion in Observability Ready; dependency **Cadence Mode**; `/sdlc` resume-vs-restart, `/claude-kit:abort`, worktree teardown; cost/concurrency/Windows notes — **9 surgical extensions, 0 new agents/skills/rules** | `0.12.0` |
|
|
227
|
+
| **Improvement brief #2** (external self-review) | The covered-vs-**gated** distinction (a skill ≠ a gate); enforce API breaking-changes by default; expand/contract migration safety; back the stack-agnostic claim with a compiled backend; WCAG as a regulated gate; reconcile the PyPI story; ship a worked example + a self-test matrix | [`docs/coverage-audit.md`](docs/coverage-audit.md); **`contract-clear` promoted to `standard`**; a live **Go/net-http** backend; the **`accessibility-clear`** regulated gate; explicit migration-drop rules; a synthetic [`examples/`](examples/) run; an eval-harness template; a profile×stack×scope self-test matrix — **2 gates wired + 1 stack, 0 new agents/skills/rules** | `0.13.0` |
|
|
215
228
|
|
|
216
229
|
> Each adoption is detailed in the [CHANGELOG](CHANGELOG.md) — including, for every review, what we
|
|
217
230
|
> deliberately **did not** add because the kit already covered it.
|
|
@@ -246,6 +259,28 @@ mandatory security gate — that would have made it mandatory.
|
|
|
246
259
|
|
|
247
260
|
</details>
|
|
248
261
|
|
|
262
|
+
<details>
|
|
263
|
+
<summary><b>How claude-kit compares (positioning)</b></summary>
|
|
264
|
+
|
|
265
|
+
<br>
|
|
266
|
+
|
|
267
|
+
claude-kit is a **config-only, stack-agnostic SDLC scaffolder** — it installs a governed pipeline
|
|
268
|
+
(agents · skills · rules · gates · hooks) into your project's `.claude/` and then gets out of the way.
|
|
269
|
+
It is **not** a runtime, an orchestration engine, or a code library. That framing is the difference:
|
|
270
|
+
|
|
271
|
+
| Project | What it is | How claude-kit differs |
|
|
272
|
+
|---|---|---|
|
|
273
|
+
| **[wshobson/agents](https://github.com/wshobson/agents)** & similar agent collections | Large libraries of individual subagent prompts you pick from | claude-kit ships a **smaller, opinionated set wired into a sequenced pipeline with owned quality gates** — agents aren't a menu, they're stages that hand off and block on each other. Adopt-by-reuse, not by accumulation. |
|
|
274
|
+
| **[GitHub spec-kit](https://github.com/github/spec-kit)** | A spec-driven workflow (constitution → spec → tasks → analyze) | claude-kit **absorbed spec-kit's coverage-gate idea** (the `story-planner` 1f gate + `task-tracker-sync`) into a **broader** lifecycle that also covers review, security, build, test, release, and observability gates. Complementary, wider scope. |
|
|
275
|
+
| **claude-flow / multi-agent runtimes** | Runtime orchestrators that *execute* swarms of agents | claude-kit produces **portable configuration**, not a running process — the orchestration is described in rules the host (Claude Code) executes. No daemon, no lock-in, no app code. |
|
|
276
|
+
| **dotfiles / `CLAUDE.md` starters** | A single rules file or settings snippet | claude-kit is a **catalog-driven generator**: it resolves your stack/profile/scope into the right subset of 23 rules, ~28 agents, ~50 skills, gates, and hooks, and keeps them **upgradeable** (`claude-kit upgrade` preserves your edits via owner + checksum). |
|
|
277
|
+
|
|
278
|
+
**Choose claude-kit when** you want a consistent, reviewable, **gate-enforced** autonomous-SDLC setup
|
|
279
|
+
that's the same across every repo and stack, installs in seconds, ships nothing you have to run, and
|
|
280
|
+
**evolves reuse-first** rather than by piling on near-duplicate agents.
|
|
281
|
+
|
|
282
|
+
</details>
|
|
283
|
+
|
|
249
284
|
---
|
|
250
285
|
|
|
251
286
|
## The agents
|
|
@@ -331,8 +366,8 @@ change.
|
|
|
331
366
|
<br>
|
|
332
367
|
|
|
333
368
|
- **`catalog/stacks.yaml`** — frontend frameworks, backend languages → frameworks, and databases.
|
|
334
|
-
Live today: React · Python/FastAPI · PostgreSQL/MongoDB. Vue/Svelte/Django/Express
|
|
335
|
-
`planned` (offered by `list-options`, not yet selectable).
|
|
369
|
+
Live today: React · Python/FastAPI · **Go/net-http** · PostgreSQL/MongoDB. Vue/Svelte/Django/Express
|
|
370
|
+
are listed as `planned` (offered by `list-options`, not yet selectable).
|
|
336
371
|
- **`catalog/profiles.yaml`** — what each profile activates (`inherit:` composes; `all` = everything).
|
|
337
372
|
- **`catalog/mcp.yaml`** — ready `.mcp.json` fragments per server, with `${ENV}` placeholders.
|
|
338
373
|
- **`catalog/org.yaml`** — the **organization layer**: scopes, teams, the autonomy model, review
|
|
@@ -397,8 +432,9 @@ hints.
|
|
|
397
432
|
|---|---|---|
|
|
398
433
|
| `/sdlc`, agents, or skills "not found" right after `init` | Claude Code hasn't loaded the new project config yet | **Restart Claude Code** — or use `/claude-kit:sdlc <task>` (works without a restart) |
|
|
399
434
|
| Guard / quality hooks seem to do nothing | `jq` isn't installed (the hooks parse tool input with it) | Install `jq`; without it the hooks degrade to no-ops by design |
|
|
435
|
+
| Hooks do nothing on **Windows** | No POSIX shell — `.sh` hooks can't run under `cmd`/PowerShell | Run claude-kit inside **WSL or Git Bash** (with `jq`); `claude-kit doctor` confirms. Config + CLI work natively regardless |
|
|
400
436
|
| A selected MCP server won't start | `node` / `npx` missing (most MCP servers launch via `npx`) | Install Node.js, or remove the server from `.mcp.json` |
|
|
401
|
-
| `pip install claude-code-kit` fails |
|
|
437
|
+
| `pip install claude-code-kit` fails | Outdated `pip`, or you want an unreleased change | Upgrade pip (`pip install -U pip`); for unreleased changes use `pip install "git+https://github.com/ajyadav013/claude-kit.git"` |
|
|
402
438
|
| `validate` reports missing files | Partial or outdated install | Re-run `claude-kit init` (choose **merge**), or `claude-kit upgrade` |
|
|
403
439
|
|
|
404
440
|
</details>
|
|
@@ -53,6 +53,25 @@ Run the **RARV** cycle (`.claude/rules/rarv-cycle.md`) with a green Verify (you
|
|
|
53
53
|
checks) before issuing the verdict, and update `.claude/CONTINUITY.md`. This gate is **Acceptance**
|
|
54
54
|
in the enterprise profile and runs before the PR is handed to a human.
|
|
55
55
|
|
|
56
|
+
## Join Point: Accessibility (accessibility-clear gate)
|
|
57
|
+
|
|
58
|
+
> Active **only** under organization scope at **`regulated`** review strictness (where WCAG is
|
|
59
|
+
> commonly a legal requirement). You own the **accessibility-clear** gate. **Degrade to a no-op**
|
|
60
|
+
> (PASS, note "no UI surface") when the change touches no frontend/UI files — detect with `Bash`
|
|
61
|
+
> (`git diff --name-only <base>` against the frontend stack dir / component globs); never block a
|
|
62
|
+
> back-end-only or API-only change.
|
|
63
|
+
|
|
64
|
+
When a UI surface is present:
|
|
65
|
+
|
|
66
|
+
1. **Drive `.claude/skills/accessibility-review`** over the changed views/components (and the standards
|
|
67
|
+
in `.claude/rules/responsive-and-accessibility.md`) — keyboard operability, focus management,
|
|
68
|
+
semantics/ARIA, color contrast (WCAG AA), motion, and screen-reader labels.
|
|
69
|
+
2. **Classify each finding** by `.claude/rules/quality-gates.md` §1. A WCAG-AA failure on a
|
|
70
|
+
legally-required surface is at least **High** (per `accessibility-review`'s risk note); a missing
|
|
71
|
+
label, focus trap, or sub-threshold contrast is **High/Medium**; cosmetic spacing is **Low**.
|
|
72
|
+
3. **Verdict** — *accessibility-clear* PASSes only at zero Critical/High/Medium, consistent with every
|
|
73
|
+
other gate. Record findings in the acceptance report.
|
|
74
|
+
|
|
56
75
|
## Escalation
|
|
57
76
|
|
|
58
77
|
Escalate to the human when acceptance criteria themselves are ambiguous or untestable, when the spec
|
|
@@ -82,3 +82,21 @@ Backend deps: {N} · Frontend deps: {N} · Vulns: Critical {N} / High {N} / Medi
|
|
|
82
82
|
## HANDOFF
|
|
83
83
|
|
|
84
84
|
Return counts by severity + the finding table to `security-reviewer`. If a CVE has no patch, recommend a workaround or replacement and mark it for an allowlist-with-review-date decision (route to the human via the Orchestrator). Log durable findings to `.claude/CONTINUITY.md`.
|
|
85
|
+
|
|
86
|
+
## CADENCE MODE (whole-project maintenance pass)
|
|
87
|
+
|
|
88
|
+
The same audit can be dispatched **standalone** — outside any one feature — as a recurring
|
|
89
|
+
maintenance pass over the *whole* project (the ongoing CVE-remediation loop):
|
|
90
|
+
|
|
91
|
+
- Run the **same METHOD** across every manifest in the repo, not just one feature's dependencies.
|
|
92
|
+
- **Batch** the findings into grouped upgrade proposals — group by ecosystem and by major-vs-minor,
|
|
93
|
+
and keep **security** patches separate from routine bumps — ordered by the
|
|
94
|
+
`.claude/rules/quality-gates.md` severity model.
|
|
95
|
+
- **Triage stays in** `.claude/skills/security-and-hardening` §"Triaging Dependency Audit Results"
|
|
96
|
+
(reachability → fix-timing); cite it, do not restate it. Reuse the same recommend→apply split: you
|
|
97
|
+
**recommend**; the **developer lane applies** (manifest edits need user approval).
|
|
98
|
+
- Posture is **advisory** — you propose; the human/Orchestrator decides what to schedule and apply.
|
|
99
|
+
Every applied upgrade re-runs the existing **security-clear + build-green + test-coverage** gates
|
|
100
|
+
(no new gate logic, no new skill).
|
|
101
|
+
- **Scheduling** (cron/CI) is the consuming project's CI concern, not the kit's — claude-kit hooks are
|
|
102
|
+
event-driven (no time trigger). Wire a periodic job in the project's CI to invoke this pass.
|
|
@@ -168,6 +168,32 @@ Frontend code reviewed: ✓ | Build/tests: ✓
|
|
|
168
168
|
|
|
169
169
|
---
|
|
170
170
|
|
|
171
|
+
## Join Point: API Backward-Compatibility (contract-clear gate)
|
|
172
|
+
|
|
173
|
+
> **Extends** `.claude/rules/mandatory-workflow.md` §2d (Breaking Changes + Impact Check). §2d is the
|
|
174
|
+
> Developer's manual consumer/signature check for *internal* exports; this is its **mechanical
|
|
175
|
+
> counterpart for the externally-exposed contract** — a base-branch surface diff. It runs **only**
|
|
176
|
+
> when the selected stack exposes an API surface (a committed OpenAPI/GraphQL schema, or typed routes
|
|
177
|
+
> a generator can emit). **Degrade to a no-op** (PASS, note "no API contract surface") when no schema
|
|
178
|
+
> source is found — mirror the hooks' detect-then-skip pattern; never block a project that has no
|
|
179
|
+
> contract.
|
|
180
|
+
|
|
181
|
+
Owns the **contract-clear** gate (runs in **standard and enterprise** — any profile that includes the
|
|
182
|
+
`merge-reviewer` — whenever the selected stack exposes an API surface). With `Bash`:
|
|
183
|
+
|
|
184
|
+
1. **Locate or generate the contract** — a committed `openapi.(json|yaml)` / GraphQL SDL, or generate it from the framework's typed routes.
|
|
185
|
+
2. **Diff against the base branch** — `git show <base>:<contract-path>` vs the working copy.
|
|
186
|
+
3. **Classify each delta** by `.claude/rules/quality-gates.md` §1:
|
|
187
|
+
- **Critical/High** — a removed or renamed endpoint/field, a narrowed type, a new **required** request field, or a removed status code clients branch on (backward-incompatible for already-shipped consumers).
|
|
188
|
+
- **Medium** — an undocumented additive change, or a deprecation with no migration note.
|
|
189
|
+
- **Low/Cosmetic** — an additive **optional** field, or a doc-only change.
|
|
190
|
+
4. **Require a migration path** — any Critical/High breaking delta needs an approved migration note (cross-ref `.claude/skills/deprecation-and-migration`) **and** a version bump before PASS.
|
|
191
|
+
5. **Emit** `docs/api/{feature-name}_api-change-report.md` from the `api-change-report.md` artifact template.
|
|
192
|
+
|
|
193
|
+
**Rule:** *contract-clear* PASSes only at zero Critical/High/Medium per the severity model; a breaking change shipped without an approved migration note + version bump is **auto-High**.
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
171
197
|
## Defect Loop Integration
|
|
172
198
|
|
|
173
199
|
When the Tester or Senior Tester finds defects after your verification:
|
|
@@ -45,6 +45,7 @@ You are the **Observability Engineer** agent. You make a feature **operable in p
|
|
|
45
45
|
### 1. SLOs / SLIs
|
|
46
46
|
- For each critical journey the feature adds, define a measurable objective: latency (p95/p99), availability/success-rate, or error budget.
|
|
47
47
|
- Record them where the project keeps them (e.g., `docs/observability/{feature}-slo.md`); reference the spec's NFR targets.
|
|
48
|
+
- When the feature adds a **hot / concurrency-sensitive backend path**, don't stop at *defining* the SLO — drive `.claude/skills/load-testing` against it, attach the run to the SLO doc (record under `docs/performance/`), and confirm it **meets** the budget. A budget breach (p95/p99 latency, error rate, or throughput) is **High** per `.claude/rules/quality-gates.md`. Skip (note why in `CONTINUITY.md`) for changes with no concurrency-sensitive surface.
|
|
48
49
|
|
|
49
50
|
### 2. Health & Readiness
|
|
50
51
|
- Liveness endpoint stays trivial and dependency-free (always 200 if the process is up).
|
|
@@ -392,7 +392,8 @@ For backend-only or frontend-only tasks, spawn a single tester in `full` mode
|
|
|
392
392
|
|
|
393
393
|
### Stage 7: Pipeline Complete
|
|
394
394
|
- Report PR URL to the human.
|
|
395
|
-
- Summarize: specs, dev docs, design, reviews (senior dev + tech architect + EM per lane), code reviewed, merge verified, testing validated + verified, Devil's Advocate (if unanimous), DevOps + Observability (where applicable), PR raised.
|
|
395
|
+
- Summarize: specs, dev docs, design, reviews (senior dev + tech architect + EM per lane), code reviewed, merge verified, testing validated + verified, Devil's Advocate (if unanimous), DevOps + Observability (where applicable), PR raised. State the summary as **per-gate PASS/FAIL**, open findings by **Critical/High/Medium**, and **PR-or-ABORTED** status (`.claude/rules/quality-gates.md` severity model).
|
|
396
|
+
- **Tear down this run's worktrees.** Once the PR is raised (or the run is abandoned), remove the per-lane worktrees this run created via the Agent tool's `isolation: "worktree"` — they auto-clean when unchanged; for merged lanes confirm removal with `git worktree remove`. **Only** remove worktrees this run created — never the user's other worktrees or the primary checkout. If a run must be cancelled mid-pipeline before this stage, use `/claude-kit:abort`.
|
|
396
397
|
|
|
397
398
|
---
|
|
398
399
|
|
|
@@ -77,7 +77,10 @@ strictness:
|
|
|
77
77
|
regulated:
|
|
78
78
|
label: "Regulated — compliance-grade gates"
|
|
79
79
|
hooks: [validate-frontmatter, validate-settings]
|
|
80
|
-
|
|
80
|
+
# accessibility-clear (brief #2 P1-2): a WCAG gate owned by acceptance-reviewer, driving the
|
|
81
|
+
# accessibility-review skill. Regulated-strictness only (WCAG is often a legal requirement there);
|
|
82
|
+
# self-skips when the change touches no UI surface, so API/back-end-only work is unaffected.
|
|
83
|
+
extra_gates: [security-clear, acceptance, accessibility-clear]
|
|
81
84
|
|
|
82
85
|
# --- core agents the org layer activates regardless of profile ---------------------------------------
|
|
83
86
|
# These live in the core agents/ dir (installed via the normal agent path); listing them here unions
|