cokit-cli 1.2.6 → 1.3.0
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.
- package/README.md +9 -42
- package/agents/brainstormer.agent.md +28 -14
- package/agents/code-reviewer.agent.md +101 -67
- package/agents/code-simplifier.agent.md +36 -41
- package/agents/debugger.agent.md +29 -24
- package/agents/docs-manager.agent.md +15 -23
- package/agents/fullstack-developer.agent.md +16 -6
- package/agents/git-manager.agent.md +0 -3
- package/agents/planner.agent.md +16 -34
- package/agents/project-manager.agent.md +24 -0
- package/agents/researcher.agent.md +15 -13
- package/agents/tester.agent.md +43 -20
- package/agents/ui-ux-designer.agent.md +16 -49
- package/docs/README.md +8 -9
- package/docs/Skills Orchestration Layer - Training Slides - en.pdf +0 -0
- package/docs/Skills Orchestration Layer - Training Slides - vi.pdf +0 -0
- package/docs/code-standards.md +1 -2
- package/docs/codebase-summary.md +35 -66
- package/docs/cokit-commands-usage-guide.md +27 -73
- package/docs/cokit-comprehensive-mapping-guide.md +9 -15
- package/docs/cokit-slides.md +4 -9
- package/docs/cokit-sync-and-maintenance-guide.md +42 -190
- package/docs/cokit-team-presentation.md +6 -11
- package/docs/copilot-processing-flow.md +3 -3
- package/docs/migration-guide.md +15 -15
- package/docs/project-overview-pdr.md +6 -7
- package/docs/project-roadmap.md +13 -15
- package/docs/skills-and-orchestration-layer-en.md +404 -0
- package/docs/skills-and-orchestration-layer-vi.md +404 -0
- package/docs/system-architecture.md +14 -20
- package/docs/{claudekit-porting-rules.md → upstream-porting-rules.md} +15 -16
- package/package.json +3 -4
- package/prompts/ck-ask.prompt.md +0 -1
- package/prompts/ck-bootstrap.prompt.md +0 -3
- package/prompts/ck-brainstorm.prompt.md +0 -1
- package/prompts/ck-cook.prompt.md +0 -1
- package/prompts/ck-debug.prompt.md +0 -1
- package/prompts/ck-deploy.prompt.md +22 -0
- package/prompts/ck-docs.prompt.md +0 -1
- package/prompts/ck-frontend.prompt.md +20 -0
- package/prompts/ck-help.prompt.md +0 -1
- package/prompts/ck-plan-fast.prompt.md +0 -3
- package/prompts/ck-plan-hard.prompt.md +0 -3
- package/prompts/ck-plan.prompt.md +0 -3
- package/prompts/ck-project.prompt.md +20 -0
- package/prompts/ck-review.prompt.md +0 -3
- package/prompts/ck-scout.prompt.md +0 -1
- package/prompts/ck-security.prompt.md +22 -0
- package/prompts/ck-ship.prompt.md +22 -0
- package/prompts/ck-test.prompt.md +0 -2
- package/prompts/ck-watzup.prompt.md +0 -1
- package/skills/agent-browser/SKILL.md +11 -8
- package/skills/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
- package/skills/bootstrap/SKILL.md +102 -0
- package/skills/bootstrap/references/shared-phases.md +59 -0
- package/skills/bootstrap/references/workflow-auto.md +52 -0
- package/skills/bootstrap/references/workflow-fast.md +50 -0
- package/skills/bootstrap/references/workflow-full.md +60 -0
- package/skills/bootstrap/references/workflow-parallel.md +59 -0
- package/skills/brainstorm/SKILL.md +63 -15
- package/skills/code-review/SKILL.md +138 -135
- package/skills/code-review/references/adversarial-review.md +223 -0
- package/skills/code-review/references/checklist-workflow.md +100 -0
- package/skills/code-review/references/checklists/api.md +52 -0
- package/skills/code-review/references/checklists/base.md +100 -0
- package/skills/code-review/references/checklists/web-app.md +54 -0
- package/skills/code-review/references/code-review-reception.md +48 -144
- package/skills/code-review/references/codebase-scan-workflow.md +30 -0
- package/skills/code-review/references/edge-case-scouting.md +119 -0
- package/skills/code-review/references/input-mode-resolution.md +135 -0
- package/skills/code-review/references/parallel-review-workflow.md +76 -0
- package/skills/code-review/references/requesting-code-review.md +115 -104
- package/skills/code-review/references/spec-compliance-review.md +43 -0
- package/skills/code-review/references/task-management-reviews.md +155 -0
- package/skills/common/README.md +2 -12
- package/skills/common/api_key_helper.py +7 -37
- package/skills/context-engineering/SKILL.md +4 -3
- package/skills/context-engineering/references/context-degradation.md +2 -2
- package/skills/context-engineering/references/runtime-awareness.md +5 -47
- package/skills/cook/README.md +13 -13
- package/skills/cook/SKILL.md +86 -58
- package/skills/cook/references/intent-detection.md +7 -7
- package/skills/cook/references/review-cycle.md +2 -2
- package/skills/cook/references/subagent-patterns.md +75 -0
- package/skills/cook/references/workflow-steps.md +75 -23
- package/skills/databases/SKILL.md +3 -30
- package/skills/databases/db-design.md +1 -1
- package/skills/debug/SKILL.md +47 -105
- package/skills/debug/references/frontend-verification.md +103 -0
- package/skills/debug/references/investigation-methodology.md +101 -0
- package/skills/debug/references/log-and-ci-analysis.md +97 -0
- package/skills/debug/references/performance-diagnostics.md +113 -0
- package/skills/debug/references/reporting-standards.md +122 -0
- package/skills/debug/references/task-management-debugging.md +155 -0
- package/skills/deploy/SKILL.md +154 -0
- package/skills/deploy/references/platform-config-templates.md +35 -0
- package/skills/deploy/references/platforms/aws.md +58 -0
- package/skills/deploy/references/platforms/cloudflare.md +41 -0
- package/skills/deploy/references/platforms/coolify.md +32 -0
- package/skills/deploy/references/platforms/digitalocean.md +45 -0
- package/skills/deploy/references/platforms/dokploy.md +29 -0
- package/skills/deploy/references/platforms/flyio.md +54 -0
- package/skills/deploy/references/platforms/gcp.md +45 -0
- package/skills/deploy/references/platforms/github-pages.md +56 -0
- package/skills/deploy/references/platforms/heroku.md +31 -0
- package/skills/deploy/references/platforms/netlify.md +39 -0
- package/skills/deploy/references/platforms/railway.md +38 -0
- package/skills/deploy/references/platforms/render.md +39 -0
- package/skills/deploy/references/platforms/tose.md +35 -0
- package/skills/deploy/references/platforms/vercel.md +37 -0
- package/skills/deploy/references/platforms/vultr.md +27 -0
- package/skills/devops/SKILL.md +6 -12
- package/skills/docs-seeker/SKILL.md +2 -1
- package/skills/docs-seeker/references/context7-patterns.md +4 -0
- package/skills/docs-seeker/scripts/fetch-docs.js +1 -2
- package/skills/docs-seeker/scripts/utils/env-loader.js +4 -4
- package/skills/docs-seeker/workflows/library-search.md +1 -0
- package/skills/fix/SKILL.md +141 -44
- package/skills/fix/references/complexity-assessment.md +21 -9
- package/skills/fix/references/diagnosis-protocol.md +133 -0
- package/skills/fix/references/mode-selection.md +27 -11
- package/skills/fix/references/parallel-exploration.md +35 -12
- package/skills/fix/references/prevention-gate.md +87 -0
- package/skills/fix/references/review-cycle.md +3 -3
- package/skills/fix/references/skill-activation-matrix.md +64 -31
- package/skills/fix/references/task-orchestration.md +110 -0
- package/skills/fix/references/workflow-deep.md +110 -47
- package/skills/fix/references/workflow-logs.md +46 -10
- package/skills/fix/references/workflow-quick.md +43 -20
- package/skills/fix/references/workflow-standard.md +75 -41
- package/skills/fix/references/workflow-test.md +49 -10
- package/skills/fix/references/workflow-ui.md +56 -18
- package/skills/frontend-design/SKILL.md +109 -77
- package/skills/frontend-design/references/ai-multimodal-overview.md +165 -0
- package/skills/frontend-design/references/anti-slop-rules.md +103 -0
- package/skills/frontend-design/references/asset-generation.md +284 -108
- package/skills/frontend-design/references/bento-motion-engine.md +142 -0
- package/skills/frontend-design/references/magicui-components.md +129 -0
- package/skills/frontend-design/references/performance-guardrails.md +169 -0
- package/skills/frontend-design/references/premium-design-patterns.md +93 -0
- package/skills/frontend-design/references/redesign-audit-checklist.md +114 -0
- package/skills/frontend-design/references/visual-analysis-overview.md +1 -1
- package/skills/frontend-design/references/workflow-3d.md +98 -0
- package/skills/frontend-design/references/workflow-describe.md +4 -3
- package/skills/frontend-design/references/workflow-immersive.md +82 -0
- package/skills/frontend-design/references/workflow-quick.md +10 -12
- package/skills/frontend-design/references/workflow-screenshot.md +9 -8
- package/skills/frontend-design/references/workflow-video.md +74 -0
- package/skills/frontend-development/SKILL.md +400 -0
- package/skills/frontend-development/resources/common-patterns.md +331 -0
- package/skills/frontend-development/resources/complete-examples.md +872 -0
- package/skills/frontend-development/resources/component-patterns.md +502 -0
- package/skills/frontend-development/resources/data-fetching.md +767 -0
- package/skills/frontend-development/resources/file-organization.md +502 -0
- package/skills/frontend-development/resources/loading-and-error-states.md +501 -0
- package/skills/frontend-development/resources/performance.md +406 -0
- package/skills/frontend-development/resources/routing-guide.md +364 -0
- package/skills/frontend-development/resources/styling-guide.md +428 -0
- package/skills/frontend-development/resources/typescript-standards.md +418 -0
- package/skills/git/SKILL.md +18 -4
- package/skills/git/references/commit-standards.md +3 -3
- package/skills/git/references/workflow-commit.md +3 -3
- package/skills/git/references/workflow-merge.md +1 -1
- package/skills/git/references/workflow-pr.md +1 -1
- package/skills/git/references/workflow-push.md +1 -1
- package/skills/mcp-management/README.md +18 -18
- package/skills/mcp-management/SKILL.md +16 -15
- package/skills/mcp-management/references/configuration.md +4 -4
- package/skills/mcp-management/references/gemini-cli-integration.md +12 -12
- package/skills/mcp-management/scripts/.env.example +2 -2
- package/skills/mcp-management/scripts/dist/mcp-client.js +1 -1
- package/skills/mcp-management/scripts/mcp-client.ts +1 -1
- package/skills/mermaidjs-v11/SKILL.md +1 -0
- package/skills/planning/SKILL.md +122 -91
- package/skills/planning/references/archive-workflow.md +53 -0
- package/skills/planning/references/codebase-understanding.md +1 -1
- package/skills/planning/references/output-standards.md +17 -13
- package/skills/planning/references/plan-organization.md +52 -30
- package/skills/planning/references/red-team-personas.md +69 -0
- package/skills/planning/references/red-team-workflow.md +77 -0
- package/skills/planning/references/scope-challenge.md +90 -0
- package/skills/planning/references/task-management.md +134 -0
- package/skills/planning/references/validate-question-framework.md +80 -0
- package/skills/planning/references/validate-workflow.md +65 -0
- package/skills/planning/references/workflow-modes.md +154 -0
- package/skills/problem-solving/SKILL.md +1 -0
- package/skills/project-management/SKILL.md +133 -0
- package/skills/project-management/references/documentation-triggers.md +60 -0
- package/skills/project-management/references/hydration-workflow.md +89 -0
- package/skills/project-management/references/progress-tracking.md +120 -0
- package/skills/project-management/references/reporting-patterns.md +94 -0
- package/skills/project-management/references/task-operations.md +87 -0
- package/skills/repomix/SKILL.md +3 -2
- package/skills/repomix/references/usage-patterns.md +2 -2
- package/skills/repomix/scripts/README.md +1 -1
- package/skills/repomix/scripts/repomix_batch.py +2 -2
- package/skills/research/SKILL.md +7 -4
- package/skills/scout/SKILL.md +24 -24
- package/skills/scout/references/external-scouting.md +17 -17
- package/skills/scout/references/internal-scouting.md +9 -9
- package/skills/scout/references/task-management-scouting.md +125 -0
- package/skills/security/SKILL.md +139 -0
- package/skills/security/references/stride-owasp-checklist.md +128 -0
- package/skills/sequential-thinking/README.md +3 -3
- package/skills/sequential-thinking/SKILL.md +2 -0
- package/skills/sequential-thinking/package.json +1 -1
- package/skills/ship/SKILL.md +116 -0
- package/skills/ship/references/auto-detect.md +103 -0
- package/skills/ship/references/pr-template.md +90 -0
- package/skills/ship/references/ship-workflow.md +241 -0
- package/skills/test/SKILL.md +111 -0
- package/skills/test/references/report-format.md +58 -0
- package/skills/test/references/test-execution-workflow.md +103 -0
- package/skills/test/references/ui-testing-workflow.md +65 -0
- package/skills/ui-styling/SKILL.md +2 -0
- package/skills/web-testing/SKILL.md +8 -60
- package/src/commands/add.js +0 -1
- package/src/commands/doctor.js +2 -2
- package/src/commands/init.js +19 -28
- package/src/commands/update.js +1 -1
- package/templates/repo/.github/agents/brainstormer.agent.md +28 -14
- package/templates/repo/.github/agents/code-reviewer.agent.md +101 -67
- package/templates/repo/.github/agents/code-simplifier.agent.md +36 -41
- package/templates/repo/.github/agents/debugger.agent.md +29 -24
- package/templates/repo/.github/agents/docs-manager.agent.md +15 -23
- package/templates/repo/.github/agents/fullstack-developer.agent.md +16 -6
- package/templates/repo/.github/agents/git-manager.agent.md +0 -3
- package/templates/repo/.github/agents/planner.agent.md +16 -34
- package/templates/repo/.github/agents/project-manager.agent.md +24 -0
- package/templates/repo/.github/agents/researcher.agent.md +15 -13
- package/templates/repo/.github/agents/tester.agent.md +43 -20
- package/templates/repo/.github/agents/ui-ux-designer.agent.md +16 -49
- package/templates/repo/.github/prompts/ck-ask.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +0 -3
- package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-cook.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-debug.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-deploy.prompt.md +22 -0
- package/templates/repo/.github/prompts/ck-docs.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-frontend.prompt.md +20 -0
- package/templates/repo/.github/prompts/ck-help.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +0 -3
- package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +0 -3
- package/templates/repo/.github/prompts/ck-plan.prompt.md +0 -3
- package/templates/repo/.github/prompts/ck-project.prompt.md +20 -0
- package/templates/repo/.github/prompts/ck-review.prompt.md +0 -3
- package/templates/repo/.github/prompts/ck-scout.prompt.md +0 -1
- package/templates/repo/.github/prompts/ck-security.prompt.md +22 -0
- package/templates/repo/.github/prompts/ck-ship.prompt.md +22 -0
- package/templates/repo/.github/prompts/ck-test.prompt.md +0 -2
- package/templates/repo/.github/prompts/ck-watzup.prompt.md +0 -1
- package/templates/repo/.github/skills/agent-browser/SKILL.md +11 -8
- package/templates/repo/.github/skills/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
- package/templates/repo/.github/skills/bootstrap/SKILL.md +102 -0
- package/templates/repo/.github/skills/bootstrap/references/shared-phases.md +59 -0
- package/templates/repo/.github/skills/bootstrap/references/workflow-auto.md +52 -0
- package/templates/repo/.github/skills/bootstrap/references/workflow-fast.md +50 -0
- package/templates/repo/.github/skills/bootstrap/references/workflow-full.md +60 -0
- package/templates/repo/.github/skills/bootstrap/references/workflow-parallel.md +59 -0
- package/templates/repo/.github/skills/brainstorm/SKILL.md +63 -15
- package/templates/repo/.github/skills/code-review/SKILL.md +138 -135
- package/templates/repo/.github/skills/code-review/references/adversarial-review.md +223 -0
- package/templates/repo/.github/skills/code-review/references/checklist-workflow.md +100 -0
- package/templates/repo/.github/skills/code-review/references/checklists/api.md +52 -0
- package/templates/repo/.github/skills/code-review/references/checklists/base.md +100 -0
- package/templates/repo/.github/skills/code-review/references/checklists/web-app.md +54 -0
- package/templates/repo/.github/skills/code-review/references/code-review-reception.md +48 -144
- package/templates/repo/.github/skills/code-review/references/codebase-scan-workflow.md +30 -0
- package/templates/repo/.github/skills/code-review/references/edge-case-scouting.md +119 -0
- package/templates/repo/.github/skills/code-review/references/input-mode-resolution.md +135 -0
- package/templates/repo/.github/skills/code-review/references/parallel-review-workflow.md +76 -0
- package/templates/repo/.github/skills/code-review/references/requesting-code-review.md +19 -8
- package/templates/repo/.github/skills/code-review/references/spec-compliance-review.md +43 -0
- package/templates/repo/.github/skills/code-review/references/task-management-reviews.md +155 -0
- package/templates/repo/.github/skills/common/README.md +2 -12
- package/templates/repo/.github/skills/common/api_key_helper.py +7 -37
- package/templates/repo/.github/skills/context-engineering/SKILL.md +4 -3
- package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +2 -2
- package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +5 -47
- package/templates/repo/.github/skills/cook/README.md +13 -13
- package/templates/repo/.github/skills/cook/SKILL.md +86 -58
- package/templates/repo/.github/skills/cook/references/intent-detection.md +7 -7
- package/templates/repo/.github/skills/cook/references/review-cycle.md +2 -2
- package/templates/repo/.github/skills/cook/references/subagent-patterns.md +75 -0
- package/templates/repo/.github/skills/cook/references/workflow-steps.md +75 -23
- package/templates/repo/.github/skills/databases/SKILL.md +3 -30
- package/templates/repo/.github/skills/databases/db-design.md +1 -1
- package/templates/repo/.github/skills/debug/SKILL.md +47 -105
- package/templates/repo/.github/skills/debug/references/frontend-verification.md +103 -0
- package/templates/repo/.github/skills/debug/references/investigation-methodology.md +101 -0
- package/templates/repo/.github/skills/debug/references/log-and-ci-analysis.md +97 -0
- package/templates/repo/.github/skills/debug/references/performance-diagnostics.md +113 -0
- package/templates/repo/.github/skills/debug/references/reporting-standards.md +122 -0
- package/templates/repo/.github/skills/debug/references/task-management-debugging.md +155 -0
- package/templates/repo/.github/skills/deploy/SKILL.md +154 -0
- package/templates/repo/.github/skills/deploy/references/platform-config-templates.md +35 -0
- package/templates/repo/.github/skills/deploy/references/platforms/aws.md +58 -0
- package/templates/repo/.github/skills/deploy/references/platforms/cloudflare.md +41 -0
- package/templates/repo/.github/skills/deploy/references/platforms/coolify.md +32 -0
- package/templates/repo/.github/skills/deploy/references/platforms/digitalocean.md +45 -0
- package/templates/repo/.github/skills/deploy/references/platforms/dokploy.md +29 -0
- package/templates/repo/.github/skills/deploy/references/platforms/flyio.md +54 -0
- package/templates/repo/.github/skills/deploy/references/platforms/gcp.md +45 -0
- package/templates/repo/.github/skills/deploy/references/platforms/github-pages.md +56 -0
- package/templates/repo/.github/skills/deploy/references/platforms/heroku.md +31 -0
- package/templates/repo/.github/skills/deploy/references/platforms/netlify.md +39 -0
- package/templates/repo/.github/skills/deploy/references/platforms/railway.md +38 -0
- package/templates/repo/.github/skills/deploy/references/platforms/render.md +39 -0
- package/templates/repo/.github/skills/deploy/references/platforms/tose.md +35 -0
- package/templates/repo/.github/skills/deploy/references/platforms/vercel.md +37 -0
- package/templates/repo/.github/skills/deploy/references/platforms/vultr.md +27 -0
- package/templates/repo/.github/skills/devops/SKILL.md +6 -12
- package/templates/repo/.github/skills/docs-seeker/SKILL.md +2 -1
- package/templates/repo/.github/skills/docs-seeker/references/context7-patterns.md +4 -0
- package/templates/repo/.github/skills/docs-seeker/scripts/fetch-docs.js +1 -2
- package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +4 -4
- package/templates/repo/.github/skills/docs-seeker/workflows/library-search.md +1 -0
- package/templates/repo/.github/skills/fix/SKILL.md +141 -44
- package/templates/repo/.github/skills/fix/references/complexity-assessment.md +21 -9
- package/templates/repo/.github/skills/fix/references/diagnosis-protocol.md +133 -0
- package/templates/repo/.github/skills/fix/references/mode-selection.md +27 -11
- package/templates/repo/.github/skills/fix/references/parallel-exploration.md +35 -12
- package/templates/repo/.github/skills/fix/references/prevention-gate.md +87 -0
- package/templates/repo/.github/skills/fix/references/review-cycle.md +3 -3
- package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +64 -31
- package/templates/repo/.github/skills/fix/references/task-orchestration.md +110 -0
- package/templates/repo/.github/skills/fix/references/workflow-deep.md +110 -47
- package/templates/repo/.github/skills/fix/references/workflow-logs.md +46 -10
- package/templates/repo/.github/skills/fix/references/workflow-quick.md +43 -20
- package/templates/repo/.github/skills/fix/references/workflow-standard.md +75 -41
- package/templates/repo/.github/skills/fix/references/workflow-test.md +49 -10
- package/templates/repo/.github/skills/fix/references/workflow-ui.md +56 -18
- package/templates/repo/.github/skills/frontend-design/SKILL.md +49 -17
- package/templates/repo/.github/skills/frontend-design/references/ai-multimodal-overview.md +165 -0
- package/templates/repo/.github/skills/frontend-design/references/anti-slop-rules.md +103 -0
- package/templates/repo/.github/skills/frontend-design/references/asset-generation.md +284 -108
- package/templates/repo/.github/skills/frontend-design/references/bento-motion-engine.md +142 -0
- package/templates/repo/.github/skills/frontend-design/references/magicui-components.md +129 -0
- package/templates/repo/.github/skills/frontend-design/references/performance-guardrails.md +169 -0
- package/templates/repo/.github/skills/frontend-design/references/premium-design-patterns.md +93 -0
- package/templates/repo/.github/skills/frontend-design/references/redesign-audit-checklist.md +114 -0
- package/templates/repo/.github/skills/frontend-design/references/visual-analysis-overview.md +1 -1
- package/templates/repo/.github/skills/frontend-design/references/workflow-3d.md +98 -0
- package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +4 -3
- package/templates/repo/.github/skills/frontend-design/references/workflow-immersive.md +82 -0
- package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +10 -12
- package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +9 -8
- package/templates/repo/.github/skills/frontend-design/references/workflow-video.md +74 -0
- package/templates/repo/.github/skills/frontend-development/SKILL.md +400 -0
- package/templates/repo/.github/skills/frontend-development/resources/common-patterns.md +331 -0
- package/templates/repo/.github/skills/frontend-development/resources/complete-examples.md +872 -0
- package/templates/repo/.github/skills/frontend-development/resources/component-patterns.md +502 -0
- package/templates/repo/.github/skills/frontend-development/resources/data-fetching.md +767 -0
- package/templates/repo/.github/skills/frontend-development/resources/file-organization.md +502 -0
- package/templates/repo/.github/skills/frontend-development/resources/loading-and-error-states.md +501 -0
- package/templates/repo/.github/skills/frontend-development/resources/performance.md +406 -0
- package/templates/repo/.github/skills/frontend-development/resources/routing-guide.md +364 -0
- package/templates/repo/.github/skills/frontend-development/resources/styling-guide.md +428 -0
- package/templates/repo/.github/skills/frontend-development/resources/typescript-standards.md +418 -0
- package/templates/repo/.github/skills/git/SKILL.md +18 -4
- package/templates/repo/.github/skills/git/references/commit-standards.md +3 -3
- package/templates/repo/.github/skills/git/references/workflow-commit.md +3 -3
- package/templates/repo/.github/skills/git/references/workflow-merge.md +1 -1
- package/templates/repo/.github/skills/git/references/workflow-pr.md +1 -1
- package/templates/repo/.github/skills/git/references/workflow-push.md +1 -1
- package/templates/repo/.github/skills/mcp-management/README.md +18 -18
- package/templates/repo/.github/skills/mcp-management/SKILL.md +16 -15
- package/templates/repo/.github/skills/mcp-management/references/configuration.md +4 -4
- package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +12 -12
- package/templates/repo/.github/skills/mcp-management/scripts/.env.example +2 -2
- package/templates/repo/.github/skills/mcp-management/scripts/mcp-client.ts +1 -1
- package/templates/repo/.github/skills/mermaidjs-v11/SKILL.md +1 -0
- package/templates/repo/.github/skills/planning/SKILL.md +122 -91
- package/templates/repo/.github/skills/planning/references/archive-workflow.md +53 -0
- package/templates/repo/.github/skills/planning/references/codebase-understanding.md +1 -1
- package/templates/repo/.github/skills/planning/references/output-standards.md +17 -13
- package/templates/repo/.github/skills/planning/references/plan-organization.md +52 -30
- package/templates/repo/.github/skills/planning/references/red-team-personas.md +69 -0
- package/templates/repo/.github/skills/planning/references/red-team-workflow.md +77 -0
- package/templates/repo/.github/skills/planning/references/scope-challenge.md +90 -0
- package/templates/repo/.github/skills/planning/references/task-management.md +134 -0
- package/templates/repo/.github/skills/planning/references/validate-question-framework.md +80 -0
- package/templates/repo/.github/skills/planning/references/validate-workflow.md +65 -0
- package/templates/repo/.github/skills/planning/references/workflow-modes.md +154 -0
- package/templates/repo/.github/skills/problem-solving/SKILL.md +1 -0
- package/templates/repo/.github/skills/project-management/SKILL.md +133 -0
- package/templates/repo/.github/skills/project-management/references/documentation-triggers.md +60 -0
- package/templates/repo/.github/skills/project-management/references/hydration-workflow.md +89 -0
- package/templates/repo/.github/skills/project-management/references/progress-tracking.md +120 -0
- package/templates/repo/.github/skills/project-management/references/reporting-patterns.md +94 -0
- package/templates/repo/.github/skills/project-management/references/task-operations.md +87 -0
- package/templates/repo/.github/skills/repomix/SKILL.md +3 -2
- package/templates/repo/.github/skills/repomix/references/usage-patterns.md +2 -2
- package/templates/repo/.github/skills/repomix/scripts/README.md +1 -1
- package/templates/repo/.github/skills/repomix/scripts/repomix_batch.py +2 -2
- package/templates/repo/.github/skills/research/SKILL.md +7 -4
- package/templates/repo/.github/skills/scout/SKILL.md +24 -24
- package/templates/repo/.github/skills/scout/references/external-scouting.md +17 -17
- package/templates/repo/.github/skills/scout/references/internal-scouting.md +9 -9
- package/templates/repo/.github/skills/scout/references/task-management-scouting.md +125 -0
- package/templates/repo/.github/skills/security/SKILL.md +139 -0
- package/templates/repo/.github/skills/security/references/stride-owasp-checklist.md +128 -0
- package/templates/repo/.github/skills/sequential-thinking/README.md +3 -3
- package/templates/repo/.github/skills/sequential-thinking/SKILL.md +2 -0
- package/templates/repo/.github/skills/sequential-thinking/package-lock.json +3652 -0
- package/templates/repo/.github/skills/sequential-thinking/package.json +1 -1
- package/templates/repo/.github/skills/ship/SKILL.md +116 -0
- package/templates/repo/.github/skills/ship/references/auto-detect.md +103 -0
- package/templates/repo/.github/skills/ship/references/pr-template.md +90 -0
- package/templates/repo/.github/skills/ship/references/ship-workflow.md +241 -0
- package/templates/repo/.github/skills/test/SKILL.md +111 -0
- package/templates/repo/.github/skills/test/references/report-format.md +58 -0
- package/templates/repo/.github/skills/test/references/test-execution-workflow.md +103 -0
- package/templates/repo/.github/skills/test/references/ui-testing-workflow.md +65 -0
- package/templates/repo/.github/skills/ui-styling/SKILL.md +2 -0
- package/templates/repo/.github/skills/web-testing/SKILL.md +8 -60
- package/docs/guide-next-steps-speckit-cokit-implementation.md +0 -187
- package/prompts/ck-spec-analyze.prompt.md +0 -201
- package/prompts/ck-spec-checklist.prompt.md +0 -308
- package/prompts/ck-spec-clarify.prompt.md +0 -190
- package/prompts/ck-spec-constitution.prompt.md +0 -92
- package/prompts/ck-spec-implement.prompt.md +0 -157
- package/prompts/ck-spec-plan.prompt.md +0 -95
- package/prompts/ck-spec-specify.prompt.md +0 -261
- package/prompts/ck-spec-tasks.prompt.md +0 -181
- package/templates/repo/.github/AGENTS.md +0 -103
- package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +0 -201
- package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +0 -308
- package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +0 -190
- package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +0 -92
- package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +0 -157
- package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +0 -95
- package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +0 -261
- package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +0 -181
- package/templates/repo/.github/skills/databases/stacks/bigquery.md +0 -231
- package/templates/repo/.github/skills/databases/stacks/d1_cloudflare.md +0 -137
- package/templates/repo/.github/skills/databases/stacks/mysql.md +0 -216
- package/templates/repo/.github/skills/databases/stacks/postgres.md +0 -235
- package/templates/repo/.github/skills/databases/stacks/sqlite.md +0 -244
- package/templates/repo/.github/skills/mcp-management/assets/tools.json +0 -3146
- package/templates/repo/.github/skills/mcp-management/scripts/dist/analyze-tools.js +0 -70
- package/templates/repo/.github/skills/mcp-management/scripts/dist/cli.js +0 -160
- package/templates/repo/.github/skills/mcp-management/scripts/dist/mcp-client.js +0 -183
- package/templates/repo/.github/skills/ui-styling/LICENSE.txt +0 -202
- package/templates/repo/.github/spec-kit/memory/constitution.md +0 -50
- package/templates/repo/.github/spec-kit/scripts/bash/check-prerequisites.sh +0 -166
- package/templates/repo/.github/spec-kit/scripts/bash/common.sh +0 -156
- package/templates/repo/.github/spec-kit/scripts/bash/create-new-feature.sh +0 -297
- package/templates/repo/.github/spec-kit/scripts/bash/setup-plan.sh +0 -61
- package/templates/repo/.github/spec-kit/scripts/bash/update-agent-context.sh +0 -799
- package/templates/repo/.github/spec-kit/scripts/powershell/check-prerequisites.ps1 +0 -148
- package/templates/repo/.github/spec-kit/scripts/powershell/common.ps1 +0 -137
- package/templates/repo/.github/spec-kit/scripts/powershell/create-new-feature.ps1 +0 -283
- package/templates/repo/.github/spec-kit/scripts/powershell/setup-plan.ps1 +0 -61
- package/templates/repo/.github/spec-kit/scripts/powershell/update-agent-context.ps1 +0 -448
- package/templates/repo/.github/spec-kit/templates/agent-file-template.md +0 -28
- package/templates/repo/.github/spec-kit/templates/checklist-template.md +0 -40
- package/templates/repo/.github/spec-kit/templates/commands/analyze.md +0 -187
- package/templates/repo/.github/spec-kit/templates/commands/checklist.md +0 -297
- package/templates/repo/.github/spec-kit/templates/commands/clarify.md +0 -184
- package/templates/repo/.github/spec-kit/templates/commands/constitution.md +0 -82
- package/templates/repo/.github/spec-kit/templates/commands/implement.md +0 -138
- package/templates/repo/.github/spec-kit/templates/commands/plan.md +0 -95
- package/templates/repo/.github/spec-kit/templates/commands/specify.md +0 -261
- package/templates/repo/.github/spec-kit/templates/commands/tasks.md +0 -140
- package/templates/repo/.github/spec-kit/templates/commands/taskstoissues.md +0 -33
- package/templates/repo/.github/spec-kit/templates/plan-template.md +0 -104
- package/templates/repo/.github/spec-kit/templates/spec-template.md +0 -115
- package/templates/repo/.github/spec-kit/templates/tasks-phase-template.md +0 -42
- package/templates/repo/.github/spec-kit/templates/tasks-template.md +0 -268
- package/templates/repo/.github/spec-kit/templates/vscode-settings.json +0 -14
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
# CoKit Sync & Maintenance Guide
|
|
2
2
|
|
|
3
|
-
> **IMPORTANT**: This is the official guide for maintaining CoKit's integration with upstream
|
|
3
|
+
> **IMPORTANT**: This is the official guide for maintaining CoKit's integration with its upstream source. Read this before making any changes to the sync pipeline.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
## Architecture Overview
|
|
8
8
|
|
|
9
|
-
CoKit
|
|
9
|
+
CoKit transforms upstream commands into a unified `ck-*` command namespace:
|
|
10
10
|
|
|
11
11
|
```
|
|
12
12
|
┌─────────────────────────────────────────────────────────────────┐
|
|
13
|
-
│
|
|
13
|
+
│ SOURCE │
|
|
14
14
|
├─────────────────────────────────────────────────────────────────┤
|
|
15
15
|
│ │
|
|
16
|
-
│
|
|
17
|
-
│
|
|
18
|
-
│ ├── commands/
|
|
16
|
+
│ Upstream Source (pre-installed) │
|
|
17
|
+
│ (configured path) │
|
|
18
|
+
│ ├── commands/ │
|
|
19
19
|
│ ├── agents/ │
|
|
20
20
|
│ └── skills/ │
|
|
21
21
|
│ │
|
|
@@ -26,10 +26,9 @@ CoKit merges two upstream sources into a unified `ck-*` command namespace:
|
|
|
26
26
|
│ SYNC PIPELINE │
|
|
27
27
|
│ npm run sync │
|
|
28
28
|
├─────────────────────────────────────────────────────────────────┤
|
|
29
|
-
│ 1.
|
|
30
|
-
│ 2.
|
|
31
|
-
│ 3.
|
|
32
|
-
│ 4. GENERATE → Write to prompts/, agents/, skills/ │
|
|
29
|
+
│ 1. TRANSFORM → Rename commands, fix placeholders │
|
|
30
|
+
│ 2. PATCH → Inject unified navigation │
|
|
31
|
+
│ 3. GENERATE → Write to prompts/ │
|
|
33
32
|
└───────────────────────┬─────────────────────────────────────────┘
|
|
34
33
|
│
|
|
35
34
|
▼
|
|
@@ -38,9 +37,8 @@ CoKit merges two upstream sources into a unified `ck-*` command namespace:
|
|
|
38
37
|
├─────────────────────────────────────────────────────────────────┤
|
|
39
38
|
│ prompts/ agents/ skills/ │
|
|
40
39
|
│ ├── ck-brainstorm ├── planner ├── ck-planning/ │
|
|
41
|
-
│ ├── ck-
|
|
42
|
-
│
|
|
43
|
-
│ └── ... │
|
|
40
|
+
│ ├── ck-plan ├── debugger ├── ck-databases/ │
|
|
41
|
+
│ └── ... └── ... └── ... │
|
|
44
42
|
│ │
|
|
45
43
|
│ All use unified ck-* namespace │
|
|
46
44
|
│ All have cross-navigation to other ck-* commands │
|
|
@@ -54,8 +52,7 @@ CoKit merges two upstream sources into a unified `ck-*` command namespace:
|
|
|
54
52
|
| File | Purpose |
|
|
55
53
|
|------|---------|
|
|
56
54
|
| `eng/sync.mjs` | Main sync orchestrator |
|
|
57
|
-
| `eng/transform-
|
|
58
|
-
| `eng/transform-speckit.mjs` | SpecKit → CoKit transform rules |
|
|
55
|
+
| `eng/transform-upstream.mjs` | Upstream → CoKit transform rules |
|
|
59
56
|
| `eng/patch-navigation.mjs` | Injects unified navigation footer |
|
|
60
57
|
| `eng/resource-origins.yml` | **CRITICAL** - Maps ck-* commands to upstream sources |
|
|
61
58
|
|
|
@@ -72,100 +69,24 @@ version: "2.0"
|
|
|
72
69
|
synced_at: "2026-02-03"
|
|
73
70
|
|
|
74
71
|
sources:
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
ref: main
|
|
78
|
-
last_sync: "2026-02-03"
|
|
79
|
-
claudekit:
|
|
80
|
-
path: ~/.claude
|
|
72
|
+
upstream:
|
|
73
|
+
path: (configured source)
|
|
81
74
|
last_sync: "2026-02-03"
|
|
82
75
|
|
|
83
76
|
# COMMAND MAPPINGS
|
|
84
|
-
# Format: ck-{name} → source info
|
|
85
77
|
mappings:
|
|
86
|
-
# ═══════════════════════════════════════════════════════════════
|
|
87
|
-
# FROM SPECKIT
|
|
88
|
-
# ═══════════════════════════════════════════════════════════════
|
|
89
|
-
ck-specify:
|
|
90
|
-
origin: speckit
|
|
91
|
-
original: speckit.specify
|
|
92
|
-
upstream_file: templates/commands/specify.md
|
|
93
|
-
description: Create feature specification from description
|
|
94
|
-
|
|
95
|
-
ck-clarify:
|
|
96
|
-
origin: speckit
|
|
97
|
-
original: speckit.clarify
|
|
98
|
-
upstream_file: templates/commands/clarify.md
|
|
99
|
-
description: Resolve specification ambiguities
|
|
100
|
-
|
|
101
|
-
ck-constitution:
|
|
102
|
-
origin: speckit
|
|
103
|
-
original: speckit.constitution
|
|
104
|
-
upstream_file: templates/commands/constitution.md
|
|
105
|
-
description: Create/update project constitution
|
|
106
|
-
|
|
107
|
-
ck-spec-tasks:
|
|
108
|
-
origin: speckit
|
|
109
|
-
original: speckit.tasks
|
|
110
|
-
upstream_file: templates/commands/tasks.md
|
|
111
|
-
description: Generate task list from plan
|
|
112
|
-
|
|
113
|
-
ck-analyze:
|
|
114
|
-
origin: speckit
|
|
115
|
-
original: speckit.analyze
|
|
116
|
-
upstream_file: templates/commands/analyze.md
|
|
117
|
-
description: Analyze spec consistency
|
|
118
|
-
|
|
119
|
-
ck-checklist:
|
|
120
|
-
origin: speckit
|
|
121
|
-
original: speckit.checklist
|
|
122
|
-
upstream_file: templates/commands/checklist.md
|
|
123
|
-
description: Quality validation checklist
|
|
124
|
-
|
|
125
|
-
# ═══════════════════════════════════════════════════════════════
|
|
126
|
-
# FROM CLAUDEKIT
|
|
127
|
-
# ═══════════════════════════════════════════════════════════════
|
|
128
78
|
ck-brainstorm:
|
|
129
|
-
origin:
|
|
79
|
+
origin: upstream
|
|
130
80
|
original: brainstorm
|
|
131
81
|
upstream_file: skills/brainstorm/SKILL.md
|
|
132
82
|
description: Explore solutions with trade-off analysis
|
|
133
83
|
|
|
134
84
|
ck-plan:
|
|
135
|
-
origin:
|
|
85
|
+
origin: upstream
|
|
136
86
|
original: plan
|
|
137
87
|
upstream_file: commands/plan.md
|
|
138
88
|
description: Intelligent plan creation
|
|
139
|
-
|
|
140
|
-
ck-plan-hard:
|
|
141
|
-
origin: claudekit
|
|
142
|
-
original: plan/hard
|
|
143
|
-
upstream_file: commands/plan/hard.md
|
|
144
|
-
description: Deep research + comprehensive plan
|
|
145
|
-
|
|
146
|
-
ck-plan-fast:
|
|
147
|
-
origin: claudekit
|
|
148
|
-
original: plan/fast
|
|
149
|
-
upstream_file: commands/plan/fast.md
|
|
150
|
-
description: Quick plan without research
|
|
151
|
-
|
|
152
|
-
ck-cook:
|
|
153
|
-
origin: claudekit
|
|
154
|
-
original: cook
|
|
155
|
-
upstream_file: skills/cook/SKILL.md
|
|
156
|
-
description: Implement feature step by step
|
|
157
|
-
|
|
158
|
-
ck-fix:
|
|
159
|
-
origin: claudekit
|
|
160
|
-
original: fix
|
|
161
|
-
upstream_file: skills/fix/SKILL.md
|
|
162
|
-
description: Analyze and fix issues
|
|
163
|
-
|
|
164
|
-
ck-test:
|
|
165
|
-
origin: claudekit
|
|
166
|
-
original: test
|
|
167
|
-
upstream_file: commands/test.md
|
|
168
|
-
description: Run tests and analyze results
|
|
89
|
+
# ... more mappings
|
|
169
90
|
|
|
170
91
|
# New commands discovered during sync (review and add to mappings)
|
|
171
92
|
unknown_commands: []
|
|
@@ -175,28 +96,25 @@ unknown_commands: []
|
|
|
175
96
|
|
|
176
97
|
## Sync Workflow
|
|
177
98
|
|
|
178
|
-
### Regular Sync
|
|
99
|
+
### Regular Sync
|
|
179
100
|
|
|
180
101
|
```bash
|
|
181
|
-
# 1.
|
|
182
|
-
npm run sync
|
|
102
|
+
# 1. Transform and generate
|
|
103
|
+
npm run sync
|
|
183
104
|
|
|
184
|
-
# 2.
|
|
185
|
-
npm run sync:transform
|
|
186
|
-
|
|
187
|
-
# 3. Review changes
|
|
105
|
+
# 2. Review changes
|
|
188
106
|
git diff
|
|
189
107
|
|
|
190
|
-
#
|
|
108
|
+
# 3. Check for unknown commands
|
|
191
109
|
cat eng/resource-origins.yml | grep -A5 "unknown_commands"
|
|
192
110
|
|
|
193
|
-
#
|
|
111
|
+
# 4. If unknown commands found, add them to mappings
|
|
194
112
|
# Edit eng/resource-origins.yml, then re-run:
|
|
195
|
-
npm run sync
|
|
113
|
+
npm run sync
|
|
196
114
|
|
|
197
|
-
#
|
|
115
|
+
# 5. Commit
|
|
198
116
|
git add .
|
|
199
|
-
git commit -m "sync: update from
|
|
117
|
+
git commit -m "sync: update from upstream $(date +%Y-%m-%d)"
|
|
200
118
|
```
|
|
201
119
|
|
|
202
120
|
### When Upstream Adds New Commands
|
|
@@ -204,7 +122,7 @@ git commit -m "sync: update from claudekit + speckit $(date +%Y-%m-%d)"
|
|
|
204
122
|
1. **Sync detects unknown command** → logged to `unknown_commands` in resource-origins.yml
|
|
205
123
|
2. **Review the new command** → check upstream docs
|
|
206
124
|
3. **Add to mappings** with appropriate `ck-*` name
|
|
207
|
-
4. **Re-run
|
|
125
|
+
4. **Re-run sync**
|
|
208
126
|
5. **Test the new command**
|
|
209
127
|
|
|
210
128
|
### When Upstream Removes/Renames Commands
|
|
@@ -222,19 +140,10 @@ git commit -m "sync: update from claudekit + speckit $(date +%Y-%m-%d)"
|
|
|
222
140
|
|
|
223
141
|
| Original | Transformed |
|
|
224
142
|
|----------|-------------|
|
|
225
|
-
| `/
|
|
226
|
-
| `/speckit.plan` | `/ck-plan` (conflicts with claudekit, see below) |
|
|
227
|
-
| `/plan` (claudekit) | `/ck-plan` |
|
|
143
|
+
| `/plan` (upstream) | `/ck-plan` |
|
|
228
144
|
| `/plan:hard` | `/ck-plan-hard` |
|
|
229
145
|
| `/brainstorm` | `/ck-brainstorm` |
|
|
230
146
|
|
|
231
|
-
### Conflict Resolution
|
|
232
|
-
|
|
233
|
-
When both sources have same command name (e.g., `plan`):
|
|
234
|
-
- **Default**: ClaudeKit version wins (more mature)
|
|
235
|
-
- **SpecKit version**: Available as `ck-plan.spec` if needed
|
|
236
|
-
- **Document in resource-origins.yml**
|
|
237
|
-
|
|
238
147
|
### Placeholder Substitution
|
|
239
148
|
|
|
240
149
|
| Original | Transformed |
|
|
@@ -245,23 +154,7 @@ When both sources have same command name (e.g., `plan`):
|
|
|
245
154
|
### Model Field
|
|
246
155
|
|
|
247
156
|
- **Remove entirely** - Let Copilot use its default
|
|
248
|
-
-
|
|
249
|
-
|
|
250
|
-
### Handoffs (SpecKit-specific)
|
|
251
|
-
|
|
252
|
-
SpecKit commands have `handoffs` in frontmatter:
|
|
253
|
-
```yaml
|
|
254
|
-
handoffs:
|
|
255
|
-
- label: Build Technical Plan
|
|
256
|
-
agent: speckit.plan
|
|
257
|
-
```
|
|
258
|
-
|
|
259
|
-
Transform to:
|
|
260
|
-
```yaml
|
|
261
|
-
handoffs:
|
|
262
|
-
- label: Build Technical Plan
|
|
263
|
-
agent: ck-plan
|
|
264
|
-
```
|
|
157
|
+
- Upstream `model: opus/sonnet/haiku` → removed
|
|
265
158
|
|
|
266
159
|
---
|
|
267
160
|
|
|
@@ -276,13 +169,11 @@ Every prompt gets a navigation footer injected:
|
|
|
276
169
|
|
|
277
170
|
| Current | Next Options |
|
|
278
171
|
|---------|--------------|
|
|
279
|
-
| After `ck-brainstorm` | `/ck-
|
|
280
|
-
| After `ck-
|
|
281
|
-
| After `ck-clarify` | `/ck-specify` (update), `/ck-plan` |
|
|
282
|
-
| After `ck-plan` | `/ck-spec-tasks`, `/ck-cook`, `/ck-brainstorm` (rethink) |
|
|
172
|
+
| After `ck-brainstorm` | `/ck-plan`, `/ck-plan-fast` |
|
|
173
|
+
| After `ck-plan` | `/ck-cook`, `/ck-brainstorm` (rethink) |
|
|
283
174
|
| After `ck-cook` | `/ck-test`, `/ck-fix` |
|
|
284
175
|
|
|
285
|
-
**All commands:** `ck-brainstorm`, `ck-
|
|
176
|
+
**All commands:** `ck-brainstorm`, `ck-plan`, `ck-plan-hard`, `ck-plan-fast`, `ck-cook`, `ck-fix`, `ck-test`
|
|
286
177
|
```
|
|
287
178
|
|
|
288
179
|
---
|
|
@@ -303,28 +194,13 @@ Every prompt gets a navigation footer injected:
|
|
|
303
194
|
│ │ │
|
|
304
195
|
│ ▼ │
|
|
305
196
|
│ ┌─────────────┐ │
|
|
306
|
-
│ │ ck-
|
|
197
|
+
│ │ ck-plan │ ← Create implementation plan │
|
|
307
198
|
│ └──────┬──────┘ │
|
|
308
|
-
│ │
|
|
199
|
+
│ │ │
|
|
309
200
|
│ ▼ │
|
|
310
201
|
│ ┌─────────────┐ │
|
|
311
|
-
│ │ ck-
|
|
202
|
+
│ │ ck-cook │ ← Implement step by step │
|
|
312
203
|
│ └──────┬──────┘ │
|
|
313
|
-
│ │◄────────────────────────┐ │
|
|
314
|
-
│ ▼ │ │
|
|
315
|
-
│ ┌─────────────┐ │ │
|
|
316
|
-
│ │ ck-plan │ Loop back if │ │
|
|
317
|
-
│ └──────┬──────┘ approach needs│ │
|
|
318
|
-
│ │ rethinking │ │
|
|
319
|
-
│ ▼ │ │
|
|
320
|
-
│ ┌───────────────┐ │ │
|
|
321
|
-
│ │ck-spec-tasks │ ← Break into tasks │
|
|
322
|
-
│ └───────┬───────┘ │ │
|
|
323
|
-
│ │ │ │
|
|
324
|
-
│ ▼ │ │
|
|
325
|
-
│ ┌─────────────┐ │ │
|
|
326
|
-
│ │ ck-cook │──────────────────┘ │
|
|
327
|
-
│ └──────┬──────┘ (via ck-brainstorm) │
|
|
328
204
|
│ │ │
|
|
329
205
|
│ ▼ │
|
|
330
206
|
│ ┌─────────────┐ │
|
|
@@ -359,13 +235,13 @@ These are generated. Fix the source:
|
|
|
359
235
|
2. Check resource-origins.yml for correct mappings
|
|
360
236
|
3. Re-run sync
|
|
361
237
|
|
|
362
|
-
###
|
|
238
|
+
### Upstream source not found
|
|
363
239
|
|
|
364
|
-
Ensure
|
|
240
|
+
Ensure upstream source is available at the configured path:
|
|
365
241
|
```bash
|
|
366
|
-
ls
|
|
367
|
-
ls
|
|
368
|
-
ls
|
|
242
|
+
ls <upstream-path>/commands/
|
|
243
|
+
ls <upstream-path>/agents/
|
|
244
|
+
ls <upstream-path>/skills/
|
|
369
245
|
```
|
|
370
246
|
|
|
371
247
|
---
|
|
@@ -380,40 +256,16 @@ For commands that don't come from upstream:
|
|
|
380
256
|
```yaml
|
|
381
257
|
ck-workflow.enterprise:
|
|
382
258
|
origin: cokit-native
|
|
383
|
-
description: Full enterprise flow (brainstorm →
|
|
259
|
+
description: Full enterprise flow (brainstorm → plan → cook)
|
|
384
260
|
```
|
|
385
261
|
|
|
386
262
|
3. These won't be overwritten by sync
|
|
387
263
|
|
|
388
264
|
---
|
|
389
265
|
|
|
390
|
-
## Version Pinning (Production)
|
|
391
|
-
|
|
392
|
-
For stability, pin SpecKit to a specific tag:
|
|
393
|
-
|
|
394
|
-
```yaml
|
|
395
|
-
# eng/resource-origins.yml
|
|
396
|
-
sources:
|
|
397
|
-
speckit:
|
|
398
|
-
repo: github/spec-kit
|
|
399
|
-
ref: v1.2.6 # Pin to tag instead of main
|
|
400
|
-
```
|
|
401
|
-
|
|
402
|
-
Update `sync:pull` script to use the ref:
|
|
403
|
-
```bash
|
|
404
|
-
git subtree pull --prefix=upstream/speckit https://github.com/github/spec-kit.git v1.2.6 --squash
|
|
405
|
-
```
|
|
406
|
-
|
|
407
|
-
---
|
|
408
|
-
|
|
409
266
|
## Changelog
|
|
410
267
|
|
|
411
268
|
| Date | Change |
|
|
412
269
|
|------|--------|
|
|
270
|
+
| 2026-03-30 | Removed SpecKit integration |
|
|
413
271
|
| 2026-02-03 | Initial architecture design |
|
|
414
|
-
|
|
415
|
-
---
|
|
416
|
-
|
|
417
|
-
## Questions?
|
|
418
|
-
|
|
419
|
-
Check the brainstorm report: `plans/reports/brainstorm-260203-1630-cokit-v2-architecture-refresh.md`
|
|
@@ -17,8 +17,8 @@
|
|
|
17
17
|
- Planning frameworks
|
|
18
18
|
- Project-specific context
|
|
19
19
|
|
|
20
|
-
**Solution:** CoKit
|
|
21
|
-
-
|
|
20
|
+
**Solution:** CoKit provides proven AI workflow patterns for GitHub Copilot via:
|
|
21
|
+
- 17 prompts with unified `ck-*` namespace using `mode: agent`
|
|
22
22
|
- 27 skills teaching Copilot best practices (debugging, code-review, planning, frontend-design, databases, devops, etc.)
|
|
23
23
|
- 12 specialized agents (including code-simplifier, fullstack-developer, ui-ux-designer)
|
|
24
24
|
- 5 instructions (backend, frontend, testing, development, research)
|
|
@@ -158,8 +158,6 @@ your-project/
|
|
|
158
158
|
| Command | Description |
|
|
159
159
|
|---------|-------------|
|
|
160
160
|
| `npx cokit-cli init` | Interactive setup wizard |
|
|
161
|
-
| `npx cokit-cli init -g` | Install personal skills only |
|
|
162
|
-
| `npx cokit-cli init -a` | Both project + personal |
|
|
163
161
|
| `npx cokit-cli add <skill>` | Add specific skill |
|
|
164
162
|
| `npx cokit-cli list` | Show installed components |
|
|
165
163
|
| `npx cokit-cli doctor` | Diagnose setup issues |
|
|
@@ -169,13 +167,10 @@ your-project/
|
|
|
169
167
|
|
|
170
168
|
## 5. Prompts Included (27 total)
|
|
171
169
|
|
|
172
|
-
**
|
|
173
|
-
- `/ck-fix`, `/ck-plan`, `/ck-cook`, `/ck-test`, `/ck-review`, `/ck-debug`, `/ck-ask`, etc.
|
|
170
|
+
**CoKit (ck-*):** Development workflow commands
|
|
171
|
+
- `/ck-fix`, `/ck-plan`, `/ck-cook`, `/ck-test`, `/ck-review`, `/ck-debug`, `/ck-ask`, `/ck-brainstorm`, `/ck-scout`, `/ck-git`, `/ck-docs`, etc.
|
|
174
172
|
|
|
175
|
-
|
|
176
|
-
- `/ck-spec-specify`, `/ck-spec-clarify`, `/ck-spec-plan`, `/ck-spec-tasks`, `/ck-spec-implement`, etc.
|
|
177
|
-
|
|
178
|
-
All 25 prompts unified in single namespace with cross-navigation support.
|
|
173
|
+
All 17 prompts unified in single namespace with cross-navigation support.
|
|
179
174
|
|
|
180
175
|
---
|
|
181
176
|
|
|
@@ -293,7 +288,7 @@ npx cokit-cli init # Always fetches latest
|
|
|
293
288
|
|
|
294
289
|
## 11. What's NOT Included (Limitations)
|
|
295
290
|
|
|
296
|
-
|
|
|
291
|
+
| Feature | Status | Reason |
|
|
297
292
|
|---------------------|--------|--------|
|
|
298
293
|
| Runtime hooks | ❌ Skip | Copilot has no equivalent |
|
|
299
294
|
| Multi-agent delegation | ❌ Skip | Single agent only |
|
|
@@ -18,11 +18,11 @@ How Copilot processes user input through CoKit resources to produce output.
|
|
|
18
18
|
|
|
19
19
|
### CoKit Examples
|
|
20
20
|
|
|
21
|
-
**Prompts (
|
|
21
|
+
**Prompts (31 total):** CoKit (ck-*) namespace with 31 unified commands
|
|
22
22
|
|
|
23
|
-
**Agents (
|
|
23
|
+
**Agents (13 total):** planner, code-reviewer, debugger, tester, researcher, scout, git-manager, brainstormer, docs-manager, code-simplifier, fullstack-developer, ui-ux-designer, project-manager
|
|
24
24
|
|
|
25
|
-
**Skills (
|
|
25
|
+
**Skills (30 total):** debugging, code-review, planning, problem-solving, sequential-thinking, backend-development, frontend-design, databases, devops, git, mcp-management, deploy, ship, security, and more
|
|
26
26
|
|
|
27
27
|
**Instructions:** ck-backend, ck-frontend, ck-testing, ck-development, ck-research
|
|
28
28
|
|
package/docs/migration-guide.md
CHANGED
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
# Migration Guide:
|
|
1
|
+
# Migration Guide: Switching to CoKit
|
|
2
2
|
|
|
3
|
-
This guide helps
|
|
3
|
+
This guide helps users adapt to GitHub Copilot with CoKit.
|
|
4
4
|
|
|
5
5
|
## Key Differences
|
|
6
6
|
|
|
7
|
-
| Feature |
|
|
8
|
-
|
|
7
|
+
| Feature | Other AI Tools | CoKit/Copilot |
|
|
8
|
+
|---------|----------------|---------------|
|
|
9
9
|
| Commands | `/fix:types`, `/plan:auto` | `/ck-fix`, `/ck-plan`, `/ck-cook`, etc. |
|
|
10
10
|
| Arguments | `$ARGUMENTS` variable | User provides in chat |
|
|
11
11
|
| Subagents | Task tool delegates to agents | Referenced in prompts |
|
|
12
12
|
| Hooks | Pre/post execution | Not supported |
|
|
13
|
-
| Skills |
|
|
14
|
-
| Prompts |
|
|
15
|
-
| Instructions |
|
|
13
|
+
| Skills | Various locations | `~/.copilot/skills/ck-*/` |
|
|
14
|
+
| Prompts | Various locations | `.github/prompts/ck-*.prompt.md` |
|
|
15
|
+
| Instructions | Various locations | `.github/instructions/ck-*.instructions.md` |
|
|
16
16
|
| Collections | Manual management | `.github/collections/ck-*.collection.yml` |
|
|
17
17
|
|
|
18
18
|
## What's Different
|
|
19
19
|
|
|
20
20
|
### No Sub-Commands
|
|
21
21
|
|
|
22
|
-
**
|
|
22
|
+
**Other AI tools:**
|
|
23
23
|
```
|
|
24
24
|
/fix:types # Fix type errors
|
|
25
25
|
/fix:tests # Fix test failures
|
|
@@ -35,7 +35,7 @@ Provide context directly in your message.
|
|
|
35
35
|
|
|
36
36
|
### No $ARGUMENTS Variable
|
|
37
37
|
|
|
38
|
-
**
|
|
38
|
+
**Other AI tool prompt:**
|
|
39
39
|
```markdown
|
|
40
40
|
Fix the issue: $ARGUMENTS
|
|
41
41
|
```
|
|
@@ -49,7 +49,7 @@ Users describe the issue in chat naturally.
|
|
|
49
49
|
|
|
50
50
|
### No Subagent Delegation
|
|
51
51
|
|
|
52
|
-
**
|
|
52
|
+
**Other AI tools:**
|
|
53
53
|
```
|
|
54
54
|
Use Task tool to launch tester agent
|
|
55
55
|
```
|
|
@@ -63,7 +63,7 @@ Copilot handles everything in one agent.
|
|
|
63
63
|
|
|
64
64
|
### No Hooks
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
Hooks (pre/post commands) from other AI tools don't exist in Copilot.
|
|
67
67
|
|
|
68
68
|
**Workaround:** Include instructions in the prompt itself:
|
|
69
69
|
```markdown
|
|
@@ -76,9 +76,9 @@ After fixing:
|
|
|
76
76
|
2. Verify the fix works
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
## Mapping
|
|
79
|
+
## Mapping Skills & Agents to CoKit
|
|
80
80
|
|
|
81
|
-
|
|
|
81
|
+
| Feature | CoKit Equivalent | Notes |
|
|
82
82
|
|---|---|---|
|
|
83
83
|
| debugging skill | ck-debugging + debugger agent | Same root cause methodology |
|
|
84
84
|
| code-review skill | ck-code-review + code-reviewer agent | Same verification principles |
|
|
@@ -102,7 +102,7 @@ After fixing:
|
|
|
102
102
|
|
|
103
103
|
1. Install CoKit:
|
|
104
104
|
```bash
|
|
105
|
-
npx cokit-cli init
|
|
105
|
+
npx cokit-cli init
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
2. Use prompts directly:
|
|
@@ -117,7 +117,7 @@ After fixing:
|
|
|
117
117
|
- Agents are referenced by prompts
|
|
118
118
|
- Skills auto-activate based on context
|
|
119
119
|
|
|
120
|
-
## Tips for
|
|
120
|
+
## Tips for New Users
|
|
121
121
|
|
|
122
122
|
1. **Be descriptive** - Without $ARGUMENTS, include context in chat
|
|
123
123
|
2. **Use specialized prompts** - `/ck-cook` for implementation, `/ck-bootstrap` for setup
|
|
@@ -5,24 +5,23 @@ Make GitHub Copilot smarter in 30 seconds via curated prompts, agents, and workf
|
|
|
5
5
|
|
|
6
6
|
## Problem
|
|
7
7
|
- Copilot lacks structured workflows for complex tasks
|
|
8
|
-
- No spec-driven development support
|
|
9
8
|
- Manual prompt engineering for each project
|
|
10
9
|
|
|
11
10
|
## Solution
|
|
12
11
|
CoKit CLI installs pre-built resources to `~/.copilot/`:
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
- **
|
|
12
|
+
- **31 prompts**: CoKit (ck-*)
|
|
13
|
+
- **13 agents**: brainstormer, planner, tester, code-simplifier, fullstack-developer, ui-ux-designer, project-manager, etc.
|
|
14
|
+
- **30 skills**: debugging, planning, code-review, frontend-design, databases, devops, deploy, ship, security, etc.
|
|
16
15
|
- **5 collections**: bundled workflows
|
|
17
16
|
|
|
18
17
|
## Key Features
|
|
19
18
|
|
|
20
19
|
| Feature | Description |
|
|
21
20
|
|---------|-------------|
|
|
22
|
-
|
|
|
23
|
-
| Sync Pipeline |
|
|
21
|
+
| Unified Workflow | `ck-*` commands for all development tasks |
|
|
22
|
+
| Sync Pipeline | Transform upstream commands to ck-* namespace |
|
|
24
23
|
| Navigation | Cross-command suggestions in all prompts |
|
|
25
|
-
|
|
|
24
|
+
| Install | Single `npx cokit-cli init` command |
|
|
26
25
|
|
|
27
26
|
## Target Users
|
|
28
27
|
- Developers using GitHub Copilot
|
package/docs/project-roadmap.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# CoKit Project Roadmap
|
|
2
2
|
|
|
3
|
-
**Project:** CoKit -
|
|
3
|
+
**Project:** CoKit - GitHub Copilot AI Workflow Toolkit
|
|
4
4
|
**Version:** 1.2.6
|
|
5
5
|
**Start Date:** 2026-01-06
|
|
6
6
|
**Last Updated:** 2026-02-25 (agents/prompts/skills Copilot alignment)
|
|
@@ -9,15 +9,15 @@
|
|
|
9
9
|
|
|
10
10
|
## Project Overview
|
|
11
11
|
|
|
12
|
-
CoKit makes it dead-simple for non-technical users to
|
|
12
|
+
CoKit makes it dead-simple for non-technical users to add structured AI workflow patterns to GitHub Copilot with a single command: `npx cokit-cli init`.
|
|
13
13
|
|
|
14
14
|
### Key Features (Current)
|
|
15
|
-
-
|
|
15
|
+
- 17 prompt files with `ck-` prefix
|
|
16
16
|
- 27 specialized skills (debugging, code-review, planning, frontend-design, databases, devops, etc.)
|
|
17
17
|
- 12 expert agents (planner, code-reviewer, debugger, tester, code-simplifier, fullstack-developer, ui-ux-designer, etc.)
|
|
18
18
|
- 5 instructions (backend, frontend, testing, development, research)
|
|
19
19
|
- 5 collections bundling resources by workflow
|
|
20
|
-
- Sync pipeline for upstream
|
|
20
|
+
- Sync pipeline for upstream sources
|
|
21
21
|
- Repo-level templates (VS Code settings, agent instructions, prompts, collections)
|
|
22
22
|
- Beginner-friendly CLI with zero configuration
|
|
23
23
|
- Cross-platform support (VS Code + JetBrains)
|
|
@@ -60,11 +60,9 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
60
60
|
**Status:** COMPLETE (2026-01-06, Enhanced 2026-02-10)
|
|
61
61
|
**Effort:** 4h
|
|
62
62
|
**Deliverables:**
|
|
63
|
-
-
|
|
64
|
-
- ClaudeKit: `ck-fix`, `ck-plan`, `ck-cook`, `ck-test`, `ck-review`, etc.
|
|
65
|
-
- SpecKit: `ck-spec-specify`, `ck-spec-clarify`, `ck-spec-plan`, `ck-spec-tasks`, etc.
|
|
63
|
+
- 17 prompt files from upstream (`ck-fix`, `ck-plan`, `ck-cook`, `ck-test`, `ck-review`, etc.)
|
|
66
64
|
- Unified namespace: `ck-*` for all commands
|
|
67
|
-
- Sync pipeline
|
|
65
|
+
- Sync pipeline transforms upstream sources
|
|
68
66
|
- All prompts follow Copilot format with `mode: agent`
|
|
69
67
|
- 0 critical issues
|
|
70
68
|
|
|
@@ -85,7 +83,7 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
85
83
|
- README.md with quick-start (30 seconds)
|
|
86
84
|
- Comprehensive documentation in `docs/` directory
|
|
87
85
|
- Team presentation slides and guides
|
|
88
|
-
- Migration guide for
|
|
86
|
+
- Migration guide for users switching to Copilot
|
|
89
87
|
|
|
90
88
|
### Phase 6: Cleanup & Consolidation (COMPLETE)
|
|
91
89
|
**Status:** COMPLETE (2026-01-20)
|
|
@@ -93,14 +91,14 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
93
91
|
**Deliverables:**
|
|
94
92
|
- Removed non-coding resources
|
|
95
93
|
- Consolidated documentation with updated counts
|
|
96
|
-
- Updated all CLI references: `cokit` → `cokit-cli`,
|
|
94
|
+
- Updated all CLI references: `cokit` → `cokit-cli`, removed `-g`/`--global` flag
|
|
97
95
|
- Updated version references to 1.0.8
|
|
98
96
|
- Fixed broken links (README.FLOW.md, FAQ.md)
|
|
99
97
|
- Added real CoKit examples throughout docs
|
|
100
98
|
- Updated resource counts: 9 agents, 14 prompts, 5 instructions, 7 skills, 5 collections
|
|
101
99
|
- QUICK-START.md one-pager - DONE
|
|
102
100
|
- FAQ.md with troubleshooting - DONE
|
|
103
|
-
- Migration guide for
|
|
101
|
+
- Migration guide for users switching to Copilot - DONE
|
|
104
102
|
- Visual assets (screenshots, GIFs) - Pending npm publication
|
|
105
103
|
- terminal-init.png (pending)
|
|
106
104
|
- vscode-after.png (pending)
|
|
@@ -174,11 +172,11 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
174
172
|
- Prompts: 21 → 27 (added SpecKit spec-driven workflow commands)
|
|
175
173
|
- Agents: 9 → 12 (added code-simplifier, fullstack-developer, ui-ux-designer)
|
|
176
174
|
- Skills: 7 → 27 (major expansion including frontend-design, databases, devops, etc.)
|
|
177
|
-
- Sync Pipeline: Unified
|
|
175
|
+
- Sync Pipeline: Unified upstream + SpecKit sources into single `ck-*` namespace
|
|
178
176
|
|
|
179
177
|
**Features Added:**
|
|
180
178
|
- Sync pipeline (eng/sync.mjs) for automated upstream merging
|
|
181
|
-
- Transform modules for both
|
|
179
|
+
- Transform modules for both upstream and SpecKit sources
|
|
182
180
|
- Navigation patcher for cross-command workflow suggestions
|
|
183
181
|
- Configuration-driven resource mappings (resource-origins.yml)
|
|
184
182
|
- Conversion scripts for agents, commands, and skills
|
|
@@ -205,7 +203,7 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
205
203
|
- README.md with beginner-friendly quick-start (30 seconds)
|
|
206
204
|
- QUICK-START.md one-pager for rapid setup
|
|
207
205
|
- FAQ.md with troubleshooting and common issues
|
|
208
|
-
- Migration guide for
|
|
206
|
+
- Migration guide for users switching to Copilot transitioning to Copilot
|
|
209
207
|
- npm and license badges added
|
|
210
208
|
- User testing completed with non-technical users (PASS)
|
|
211
209
|
- 369 lines of documentation delivered
|
|
@@ -267,7 +265,7 @@ CoKit makes it dead-simple for non-technical users to port Claude Code workflow
|
|
|
267
265
|
|
|
268
266
|
### Adoption Goals
|
|
269
267
|
- README comprehensible to non-developers
|
|
270
|
-
- Migration guide helps
|
|
268
|
+
- Migration guide helps users transition to Copilot
|
|
271
269
|
- All commands copy-paste ready
|
|
272
270
|
- <5 minutes from discovery to working prompt
|
|
273
271
|
|