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
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
# Ship Workflow — Detailed Steps
|
|
2
|
+
|
|
3
|
+
## Step 1: Pre-flight
|
|
4
|
+
|
|
5
|
+
1. Check current branch: `git branch --show-current`
|
|
6
|
+
- If on target branch (main/master/dev): **ABORT** — "Ship from a feature branch, not the target branch."
|
|
7
|
+
2. Determine ship mode from arguments:
|
|
8
|
+
- `official` → target = auto-detect default branch (main/master)
|
|
9
|
+
- `beta` → target = auto-detect dev branch (dev/beta/develop)
|
|
10
|
+
- No argument → infer from branch name:
|
|
11
|
+
- `feature/* hotfix/* bugfix/*` → official
|
|
12
|
+
- `dev/* beta/* experiment/*` → beta
|
|
13
|
+
- Unclear → asking the user with options: "Official (main)", "Beta (dev)"
|
|
14
|
+
3. Auto-detect target branch:
|
|
15
|
+
```bash
|
|
16
|
+
# For official: detect default branch
|
|
17
|
+
git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'
|
|
18
|
+
# Fallback
|
|
19
|
+
git rev-parse --verify origin/main 2>/dev/null && echo "main" || echo "master"
|
|
20
|
+
|
|
21
|
+
# For beta: detect dev branch
|
|
22
|
+
for b in dev beta develop; do
|
|
23
|
+
git rev-parse --verify origin/$b 2>/dev/null && echo "$b" && break
|
|
24
|
+
done
|
|
25
|
+
```
|
|
26
|
+
4. Run `git status` (never use `-uall`). Uncommitted changes are always included.
|
|
27
|
+
5. Run `git diff <target>...HEAD --stat` and `git log <target>..HEAD --oneline` to understand what's being shipped.
|
|
28
|
+
6. If `--dry-run`: output what would happen at each step and stop here.
|
|
29
|
+
|
|
30
|
+
## Step 2: Link Issues
|
|
31
|
+
|
|
32
|
+
Find or create related GitHub issues for traceability.
|
|
33
|
+
|
|
34
|
+
1. Search for related open issues by keywords from branch name and commit messages:
|
|
35
|
+
```bash
|
|
36
|
+
# Extract keywords from branch name
|
|
37
|
+
BRANCH=$(git branch --show-current)
|
|
38
|
+
KEYWORDS=$(echo "$BRANCH" | sed 's/[^a-zA-Z0-9]/ /g' | tr '[:upper:]' '[:lower:]')
|
|
39
|
+
|
|
40
|
+
# Search existing issues
|
|
41
|
+
gh issue list --state open --limit 10 --search "$KEYWORDS"
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
2. Also check if any issues are referenced in commit messages:
|
|
45
|
+
```bash
|
|
46
|
+
git log <target>..HEAD --oneline | grep -oE '#[0-9]+' | sort -u
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
3. **If related issues found:** Note issue numbers for PR linking.
|
|
50
|
+
|
|
51
|
+
4. **If NO related issues found:** Create a new issue with structured format:
|
|
52
|
+
```bash
|
|
53
|
+
gh issue create --title "<type>: <summary from commits>" --body "$(cat <<'EOF'
|
|
54
|
+
## Problem Statement
|
|
55
|
+
<infer from diff and commit messages>
|
|
56
|
+
|
|
57
|
+
## Proposal
|
|
58
|
+
<summarize the implementation approach>
|
|
59
|
+
|
|
60
|
+
## How It Works
|
|
61
|
+
<describe key changes with bullet points>
|
|
62
|
+
|
|
63
|
+
### Architecture
|
|
64
|
+
```
|
|
65
|
+
<ASCII diagram of component interactions>
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Challenges
|
|
69
|
+
- <potential edge cases or risks>
|
|
70
|
+
|
|
71
|
+
## Plan & Phases
|
|
72
|
+
- [x] Implementation complete
|
|
73
|
+
- [x] Tests passing
|
|
74
|
+
- [ ] Code review approved
|
|
75
|
+
- [ ] Merged to <target>
|
|
76
|
+
|
|
77
|
+
## Human Review Tasks
|
|
78
|
+
- [ ] Verify business logic correctness
|
|
79
|
+
- [ ] Check for edge cases not covered by tests
|
|
80
|
+
- [ ] Validate UX/API contract changes (if any)
|
|
81
|
+
EOF
|
|
82
|
+
)"
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
5. Store issue numbers for Step 12 (PR creation).
|
|
86
|
+
|
|
87
|
+
## Step 3: Merge target branch
|
|
88
|
+
|
|
89
|
+
Fetch and merge so tests run against the merged state:
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
git fetch origin <target> && git merge origin/<target> --no-edit
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
- **If merge conflicts:** Try auto-resolve simple ones (lockfiles, version files). For complex conflicts, **STOP** and show them.
|
|
96
|
+
- **If already up to date:** Continue silently.
|
|
97
|
+
|
|
98
|
+
## Step 4: Run Tests
|
|
99
|
+
|
|
100
|
+
**Skip if:** `--skip-tests` flag.
|
|
101
|
+
|
|
102
|
+
1. Auto-detect test command (see `auto-detect.md`)
|
|
103
|
+
2. Delegate to `tester` subagent — don't inline test execution
|
|
104
|
+
3. Check pass/fail from agent result
|
|
105
|
+
|
|
106
|
+
- **If any test fails:** Show failures and **STOP**. Do not proceed.
|
|
107
|
+
- **If all pass:** Note counts briefly and continue.
|
|
108
|
+
- **If no test runner detected:** Use asking the user — "No test runner detected. Skip tests or provide command?"
|
|
109
|
+
|
|
110
|
+
## Step 5: Pre-Landing Review
|
|
111
|
+
|
|
112
|
+
**Skip if:** `--skip-review` flag.
|
|
113
|
+
|
|
114
|
+
1. Run `git diff origin/<target>` to get the full diff
|
|
115
|
+
2. Delegate to `code-reviewer` subagent with the diff
|
|
116
|
+
3. Two-pass model:
|
|
117
|
+
- **Pass 1 (CRITICAL):** Security, injection, race conditions, auth bypass
|
|
118
|
+
- **Pass 2 (INFORMATIONAL):** Dead code, magic numbers, test gaps, style
|
|
119
|
+
|
|
120
|
+
4. **Output findings:**
|
|
121
|
+
```
|
|
122
|
+
Pre-Landing Review: N issues (X critical, Y informational)
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
5. **If critical issues found:** For EACH critical issue, ask the user:
|
|
126
|
+
- Problem description with `file:line`
|
|
127
|
+
- Recommended fix
|
|
128
|
+
- Options: A) Fix now (recommended), B) Acknowledge and ship, C) False positive — skip
|
|
129
|
+
|
|
130
|
+
6. **If user chose Fix (A):** Apply fixes, commit fixed files, then **re-run tests** (Step 4) before continuing.
|
|
131
|
+
7. **If only informational:** Include in PR body, continue.
|
|
132
|
+
8. **If no issues:** Output "No issues found." and continue.
|
|
133
|
+
|
|
134
|
+
## Step 6: Version Bump (conditional)
|
|
135
|
+
|
|
136
|
+
1. Auto-detect version source (see `auto-detect.md`)
|
|
137
|
+
2. If no version file found: **skip silently**
|
|
138
|
+
3. Auto-decide bump level from diff size:
|
|
139
|
+
- **< 50 lines:** patch bump
|
|
140
|
+
- **50+ lines:** patch bump (default safe choice)
|
|
141
|
+
- **Major feature or breaking change:** Use asking the user — "This looks like a significant change. Bump minor or patch?"
|
|
142
|
+
4. For beta mode: use prerelease suffix (e.g., `1.2.4-beta.1`)
|
|
143
|
+
5. Write new version to detected file
|
|
144
|
+
|
|
145
|
+
## Step 7: Changelog (conditional)
|
|
146
|
+
|
|
147
|
+
1. Check for CHANGELOG.md or CHANGES.md
|
|
148
|
+
2. If not found: **skip silently**
|
|
149
|
+
3. Auto-generate entry from ALL commits on branch:
|
|
150
|
+
- `git log <target>..HEAD --oneline` for commit list
|
|
151
|
+
- `git diff <target>...HEAD` for full diff context
|
|
152
|
+
4. Categorize into: Added, Changed, Fixed, Removed
|
|
153
|
+
5. Insert after file header, dated today
|
|
154
|
+
6. Format: `## [X.Y.Z] - YYYY-MM-DD`
|
|
155
|
+
|
|
156
|
+
**Do NOT ask user to describe changes.** Infer from diff and commits.
|
|
157
|
+
|
|
158
|
+
## Step 8: Journal (background)
|
|
159
|
+
|
|
160
|
+
**Skip if:** `--skip-journal` flag.
|
|
161
|
+
|
|
162
|
+
Write a technical journal entry capturing this ship session. Run as **background task** to not block pipeline.
|
|
163
|
+
|
|
164
|
+
1. Invoke `/ck-journal` skill via `journal-writer` subagent in background:
|
|
165
|
+
- Topic: summary of shipped changes (from commit messages + diff stats)
|
|
166
|
+
- Include: what was shipped, key decisions, technical challenges encountered
|
|
167
|
+
- Output: saved to `./docs/journals/` directory
|
|
168
|
+
2. Don't wait for completion — continue to next step immediately.
|
|
169
|
+
|
|
170
|
+
## Step 9: Docs Update (conditional, background)
|
|
171
|
+
|
|
172
|
+
**Skip if:** `--skip-docs` flag OR ship mode is `beta`.
|
|
173
|
+
|
|
174
|
+
Update project documentation for official releases. Run as **background task**.
|
|
175
|
+
|
|
176
|
+
1. Invoke `/ck-docs update` skill via `docs-manager` subagent in background:
|
|
177
|
+
- Analyzes code changes since last release
|
|
178
|
+
- Updates relevant docs in `./docs/` directory
|
|
179
|
+
2. Don't wait for completion — continue to next step immediately.
|
|
180
|
+
|
|
181
|
+
## Step 10: Commit
|
|
182
|
+
|
|
183
|
+
1. Stage all changes: `git add -A`
|
|
184
|
+
2. Security check: scan staged diff for secrets (API keys, tokens, passwords)
|
|
185
|
+
- If secrets found: **STOP**, warn user, suggest `.gitignore`
|
|
186
|
+
3. Compose commit message:
|
|
187
|
+
- Format: `type(scope): description`
|
|
188
|
+
- Infer type from changes (feat/fix/refactor/chore)
|
|
189
|
+
- If version + changelog present, include in same commit
|
|
190
|
+
4. Commit:
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
git commit -m "$(cat <<'EOF'
|
|
194
|
+
type(scope): description
|
|
195
|
+
|
|
196
|
+
Brief body describing the changes.
|
|
197
|
+
EOF
|
|
198
|
+
)"
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
## Step 11: Push
|
|
202
|
+
|
|
203
|
+
```bash
|
|
204
|
+
git push -u origin $(git branch --show-current)
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
- **Never force push.**
|
|
208
|
+
- If push rejected: suggest `git pull --rebase` and retry once.
|
|
209
|
+
|
|
210
|
+
## Step 12: Create PR
|
|
211
|
+
|
|
212
|
+
Check if `gh` CLI is available:
|
|
213
|
+
```bash
|
|
214
|
+
which gh 2>/dev/null || echo "MISSING"
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
If missing: output "Install GitHub CLI (gh) to auto-create PRs" and stop after push.
|
|
218
|
+
|
|
219
|
+
Create PR targeting the correct branch:
|
|
220
|
+
```bash
|
|
221
|
+
gh pr create --base <target-branch> --title "<type>: <summary>" --body "$(cat <<'EOF'
|
|
222
|
+
<PR body from pr-template.md>
|
|
223
|
+
EOF
|
|
224
|
+
)"
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
**Link issues** collected from Step 2:
|
|
228
|
+
```bash
|
|
229
|
+
# If issues were found/created, add closing keywords in PR body
|
|
230
|
+
# e.g., "Closes #42, Relates to #43"
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
**Output the PR URL** — this is the final output the user sees.
|
|
234
|
+
|
|
235
|
+
If PR already exists for this branch, update it instead:
|
|
236
|
+
```bash
|
|
237
|
+
gh pr edit --title "<type>: <summary>" --body "$(cat <<'EOF'
|
|
238
|
+
<PR body>
|
|
239
|
+
EOF
|
|
240
|
+
)"
|
|
241
|
+
```
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: test
|
|
3
|
+
description: "Run unit, integration, e2e, and UI tests. Use for test execution, coverage analysis, build verification, visual regression, and QA reports."
|
|
4
|
+
argument-hint: "[context] OR ui [url]"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Testing & Quality Assurance
|
|
8
|
+
|
|
9
|
+
Comprehensive testing framework covering code-level testing (unit, integration, e2e), UI/visual testing via browser automation, coverage analysis, and structured QA reporting.
|
|
10
|
+
|
|
11
|
+
## Default (No Arguments)
|
|
12
|
+
|
|
13
|
+
If invoked with context (test scope), proceed with testing. If invoked WITHOUT arguments, ask the user to present available test operations:
|
|
14
|
+
|
|
15
|
+
| Operation | Description |
|
|
16
|
+
|-----------|-------------|
|
|
17
|
+
| `(default)` | Run unit/integration/e2e tests |
|
|
18
|
+
| `ui` | Run UI tests on a website |
|
|
19
|
+
|
|
20
|
+
Present as options by asking the user with header "Test Operation", question "What would you like to do?".
|
|
21
|
+
|
|
22
|
+
## Core Principle
|
|
23
|
+
|
|
24
|
+
**NEVER IGNORE FAILING TESTS.** Fix root causes, not symptoms. No mocks/cheats/tricks to pass builds.
|
|
25
|
+
|
|
26
|
+
## When to Use
|
|
27
|
+
|
|
28
|
+
- **After implementation**: Validate new features or bug fixes
|
|
29
|
+
- **Coverage checks**: Ensure coverage meets project thresholds (80%+)
|
|
30
|
+
- **UI verification**: Visual regression, responsive layout, accessibility
|
|
31
|
+
- **Build validation**: Verify build process, dependencies, CI/CD compatibility
|
|
32
|
+
- **Pre-commit/push**: Final quality gate
|
|
33
|
+
|
|
34
|
+
## Workflows
|
|
35
|
+
|
|
36
|
+
### 1. Code Testing (`references/test-execution-workflow.md`)
|
|
37
|
+
|
|
38
|
+
Execute test suites, analyze results, generate coverage. Supports JS/TS (Jest/Vitest/Mocha), Python (pytest), Go, Rust, Flutter. Includes working process, quality standards, and tool commands.
|
|
39
|
+
|
|
40
|
+
**Load when:** Running unit/integration/e2e tests, checking coverage, validating builds
|
|
41
|
+
|
|
42
|
+
### 2. UI Testing (`references/ui-testing-workflow.md`)
|
|
43
|
+
|
|
44
|
+
Browser-based visual testing via `chrome-devtools` (if available) skill. Screenshots, responsive checks, accessibility audits, form automation, console error collection. Includes auth injection for protected routes.
|
|
45
|
+
|
|
46
|
+
**Load when:** Visual regression testing, UI bugs, responsive layout checks, accessibility audits
|
|
47
|
+
|
|
48
|
+
### 3. Report Format (`references/report-format.md`)
|
|
49
|
+
|
|
50
|
+
Structured QA report template: test results overview, coverage metrics, failed tests, performance, build status, recommendations.
|
|
51
|
+
|
|
52
|
+
**Load when:** Generating test summary reports
|
|
53
|
+
|
|
54
|
+
## Quick Reference
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
Code tests → test-execution-workflow.md
|
|
58
|
+
npm test / pytest / go test / cargo test / flutter test
|
|
59
|
+
Coverage: npm run test:coverage / pytest --cov
|
|
60
|
+
|
|
61
|
+
UI tests → ui-testing-workflow.md
|
|
62
|
+
Screenshots, responsive, a11y, forms, console errors
|
|
63
|
+
Auth: inject-auth.js for protected routes
|
|
64
|
+
|
|
65
|
+
Reports → report-format.md
|
|
66
|
+
Structured QA summary with metrics & recommendations
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Working Process
|
|
70
|
+
|
|
71
|
+
1. Identify testing scope from recent changes or requirements
|
|
72
|
+
2. Run typecheck/analyze commands to catch syntax errors first
|
|
73
|
+
3. Execute appropriate test suites
|
|
74
|
+
4. Analyze results — focus on failures
|
|
75
|
+
5. Generate coverage reports if applicable
|
|
76
|
+
6. For frontend: run UI tests via `chrome-devtools` (if available) skill
|
|
77
|
+
7. Produce structured summary report
|
|
78
|
+
|
|
79
|
+
## Tools Integration
|
|
80
|
+
|
|
81
|
+
- **Test runners**: Jest, Vitest, Mocha, pytest, go test, cargo test, flutter test
|
|
82
|
+
- **Coverage**: Istanbul/c8/nyc, pytest-cov, go cover
|
|
83
|
+
- **Browser**: `chrome-devtools` (if available) skill for UI testing (screenshots, ARIA, console, network)
|
|
84
|
+
- **Analysis**: `ai-multimodal` (if available) skill for screenshot analysis
|
|
85
|
+
- **Debugging**: `debug` skill when tests reveal bugs requiring investigation
|
|
86
|
+
- **Thinking**: `sequential-thinking` skill for complex test failure analysis
|
|
87
|
+
|
|
88
|
+
## Quality Standards
|
|
89
|
+
|
|
90
|
+
- All critical paths must have test coverage
|
|
91
|
+
- Validate happy path AND error scenarios
|
|
92
|
+
- Ensure test isolation — no interdependencies
|
|
93
|
+
- Tests must be deterministic and reproducible
|
|
94
|
+
- Clean up test data after execution
|
|
95
|
+
- Never ignore failing tests to pass the build
|
|
96
|
+
|
|
97
|
+
## Report Output
|
|
98
|
+
**IMPORTANT:** Invoke "/ck-project-organization" skill to organize the outputs.
|
|
99
|
+
|
|
100
|
+
Use naming pattern from `## Naming` section injected by hooks.
|
|
101
|
+
|
|
102
|
+
## Team Mode
|
|
103
|
+
|
|
104
|
+
When operating as teammate:
|
|
105
|
+
1. On start: check `TaskList`, claim assigned/next unblocked task via `TaskUpdate`
|
|
106
|
+
2. Read full task description via `TaskGet` before starting
|
|
107
|
+
3. Wait for blocked tasks (implementation) to complete before testing
|
|
108
|
+
4. Respect file ownership — only create/edit test files assigned
|
|
109
|
+
5. When done: `TaskUpdate(status: "completed")` then `SendMessage` results to lead
|
|
110
|
+
|
|
111
|
+
**Fallback:** Task tools (`TaskList`/`TaskUpdate`/`TaskGet`) are CLI-only — unavailable in VSCode extension. If they error, use `TodoWrite` for progress tracking and coordinate via `SendMessage` only.
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Test Report Format
|
|
2
|
+
|
|
3
|
+
Structured QA report template. Sacrifice grammar for concision.
|
|
4
|
+
|
|
5
|
+
## Template
|
|
6
|
+
|
|
7
|
+
```markdown
|
|
8
|
+
# Test Report — {date} — {scope}
|
|
9
|
+
|
|
10
|
+
## Test Results Overview
|
|
11
|
+
- **Total**: X tests
|
|
12
|
+
- **Passed**: X | **Failed**: X | **Skipped**: X
|
|
13
|
+
- **Duration**: Xs
|
|
14
|
+
|
|
15
|
+
## Coverage Metrics
|
|
16
|
+
| Metric | Value | Threshold | Status |
|
|
17
|
+
|----------|-------|-----------|--------|
|
|
18
|
+
| Lines | X% | 80% | PASS/FAIL |
|
|
19
|
+
| Branches | X% | 70% | PASS/FAIL |
|
|
20
|
+
| Functions| X% | 80% | PASS/FAIL |
|
|
21
|
+
|
|
22
|
+
## Failed Tests
|
|
23
|
+
### `test/path/file.test.ts` — TestName
|
|
24
|
+
- **Error**: Error message
|
|
25
|
+
- **Stack**: Relevant stack trace (truncated)
|
|
26
|
+
- **Cause**: Brief root cause analysis
|
|
27
|
+
- **Fix**: Suggested resolution
|
|
28
|
+
|
|
29
|
+
## UI Test Results (if applicable)
|
|
30
|
+
- **Pages tested**: X
|
|
31
|
+
- **Screenshots**: ./screenshots/
|
|
32
|
+
- **Console errors**: none | [list]
|
|
33
|
+
- **Responsive**: checked at [viewports] | skipped
|
|
34
|
+
- **Performance**: LCP Xs, FID Xms, CLS X
|
|
35
|
+
|
|
36
|
+
## Build Status
|
|
37
|
+
- **Build**: PASS/FAIL
|
|
38
|
+
- **Warnings**: none | [list]
|
|
39
|
+
- **Dependencies**: all resolved | [issues]
|
|
40
|
+
|
|
41
|
+
## Critical Issues
|
|
42
|
+
1. [Blocking issue description + impact]
|
|
43
|
+
|
|
44
|
+
## Recommendations
|
|
45
|
+
1. [Actionable improvement with priority]
|
|
46
|
+
|
|
47
|
+
## Unresolved Questions
|
|
48
|
+
- [Any open questions, if any]
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Guidelines
|
|
52
|
+
|
|
53
|
+
- Include ALL failed tests with error messages — don't summarize away details
|
|
54
|
+
- Coverage: highlight specific uncovered files/functions, not just percentages
|
|
55
|
+
- Screenshots: embed paths directly in report for easy access
|
|
56
|
+
- Recommendations: prioritize by impact (critical > high > medium > low)
|
|
57
|
+
- Keep report under 200 lines — split into sections if larger scope needed
|
|
58
|
+
- Save report using naming pattern from `## Naming` section injected by hooks
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Test Execution Workflow
|
|
2
|
+
|
|
3
|
+
## Step 1: Identify Scope
|
|
4
|
+
|
|
5
|
+
Determine what to test based on recent changes:
|
|
6
|
+
- New feature → full test suite + new test cases
|
|
7
|
+
- Bug fix → regression tests + targeted fix validation
|
|
8
|
+
- Refactor → existing test suite (no new tests unless gaps found)
|
|
9
|
+
- Coverage check → full suite with coverage flags
|
|
10
|
+
|
|
11
|
+
## Step 2: Pre-flight Checks
|
|
12
|
+
|
|
13
|
+
Run syntax/type checks before tests to catch compile errors early:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# JavaScript/TypeScript
|
|
17
|
+
npx tsc --noEmit # TypeScript check
|
|
18
|
+
npx eslint . # Lint check
|
|
19
|
+
|
|
20
|
+
# Python
|
|
21
|
+
python -m py_compile file.py
|
|
22
|
+
flake8 .
|
|
23
|
+
|
|
24
|
+
# Flutter
|
|
25
|
+
flutter analyze
|
|
26
|
+
|
|
27
|
+
# Go
|
|
28
|
+
go vet ./...
|
|
29
|
+
|
|
30
|
+
# Rust
|
|
31
|
+
cargo check
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Step 3: Execute Tests
|
|
35
|
+
|
|
36
|
+
### JavaScript/TypeScript
|
|
37
|
+
```bash
|
|
38
|
+
npm test # or yarn test / pnpm test / bun test
|
|
39
|
+
npm run test:coverage # with coverage
|
|
40
|
+
npx vitest run # Vitest
|
|
41
|
+
npx jest --coverage # Jest with coverage
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Python
|
|
45
|
+
```bash
|
|
46
|
+
pytest # basic
|
|
47
|
+
pytest --cov=src --cov-report=term-missing # with coverage
|
|
48
|
+
python -m unittest discover # unittest
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Go / Rust / Flutter
|
|
52
|
+
```bash
|
|
53
|
+
go test ./... -cover # Go with coverage
|
|
54
|
+
cargo test # Rust
|
|
55
|
+
flutter test --coverage # Flutter
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Step 4: Analyze Results
|
|
59
|
+
|
|
60
|
+
Focus on:
|
|
61
|
+
1. **Failing tests** — read error messages and stack traces carefully
|
|
62
|
+
2. **Flaky tests** — tests that pass/fail intermittently indicate race conditions or state leaks
|
|
63
|
+
3. **Slow tests** — identify bottlenecks (>5s per test is suspicious)
|
|
64
|
+
4. **Skipped tests** — ensure skips are intentional, not hiding failures
|
|
65
|
+
|
|
66
|
+
## Step 5: Coverage Analysis
|
|
67
|
+
|
|
68
|
+
Thresholds:
|
|
69
|
+
- **80%+** line coverage — standard minimum
|
|
70
|
+
- **70%+** branch coverage — acceptable for most projects
|
|
71
|
+
- Focus on critical paths: auth, payment, data mutations
|
|
72
|
+
|
|
73
|
+
Identify gaps:
|
|
74
|
+
- Uncovered error handlers
|
|
75
|
+
- Missing edge case branches
|
|
76
|
+
- Untested utility functions
|
|
77
|
+
|
|
78
|
+
## Step 6: Build Verification
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npm run build # JS/TS production build
|
|
82
|
+
python setup.py build # Python
|
|
83
|
+
go build ./... # Go
|
|
84
|
+
cargo build --release # Rust
|
|
85
|
+
flutter build # Flutter
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Check for:
|
|
89
|
+
- Build warnings or deprecation notices
|
|
90
|
+
- Unresolved dependencies
|
|
91
|
+
- Production config correctness
|
|
92
|
+
|
|
93
|
+
## Quality Checklist
|
|
94
|
+
|
|
95
|
+
- [ ] All tests pass (zero failures)
|
|
96
|
+
- [ ] Coverage meets project threshold
|
|
97
|
+
- [ ] No flaky tests detected
|
|
98
|
+
- [ ] Build completes without errors
|
|
99
|
+
- [ ] Error scenarios tested
|
|
100
|
+
- [ ] Test isolation verified (no shared state)
|
|
101
|
+
- [ ] Test data cleaned up after execution
|
|
102
|
+
- [ ] Mocks/stubs properly configured
|
|
103
|
+
- [ ] Environment variables correctly set
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# UI Testing Workflow
|
|
2
|
+
|
|
3
|
+
Activate the ck:chrome-devtools (if available) skill.
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Run comprehensive UI tests on a website and generate a detailed report.
|
|
7
|
+
|
|
8
|
+
## Arguments
|
|
9
|
+
- $1: URL - The URL of the website to test
|
|
10
|
+
- $2: OPTIONS - Optional test configuration (e.g., --headless, --mobile, --auth)
|
|
11
|
+
|
|
12
|
+
## Testing Protected Routes (Authentication)
|
|
13
|
+
|
|
14
|
+
### Step 1: User Manual Login
|
|
15
|
+
Instruct the user to:
|
|
16
|
+
1. Open the target site in their browser
|
|
17
|
+
2. Log in manually with their credentials
|
|
18
|
+
3. Open browser DevTools (F12) → Application tab → Cookies/Storage
|
|
19
|
+
|
|
20
|
+
### Step 2: Extract Auth Credentials
|
|
21
|
+
Ask the user to provide one of:
|
|
22
|
+
- **Cookies**: Copy cookie values (name, value, domain)
|
|
23
|
+
- **Access Token**: Copy JWT/Bearer token from localStorage or cookies
|
|
24
|
+
- **Session Storage**: Copy relevant session keys
|
|
25
|
+
|
|
26
|
+
### Step 3: Inject Authentication
|
|
27
|
+
Use the `inject-auth.js` script:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
cd $SKILL_DIR # chrome-devtools scripts (if available)
|
|
31
|
+
|
|
32
|
+
# Option A: Inject cookies
|
|
33
|
+
node inject-auth.js --url https://example.com --cookies '[{"name":"session","value":"abc123","domain":".example.com"}]'
|
|
34
|
+
|
|
35
|
+
# Option B: Inject Bearer token
|
|
36
|
+
node inject-auth.js --url https://example.com --token "Bearer eyJhbGciOi..." --header Authorization --token-key access_token
|
|
37
|
+
|
|
38
|
+
# Option C: Inject localStorage
|
|
39
|
+
node inject-auth.js --url https://example.com --local-storage '{"auth_token":"xyz","user_id":"123"}'
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Step 4: Run Tests
|
|
43
|
+
After auth injection, run tests normally:
|
|
44
|
+
```bash
|
|
45
|
+
node navigate.js --url https://example.com/dashboard
|
|
46
|
+
node screenshot.js --url https://example.com/profile --output profile.png
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Workflow
|
|
50
|
+
- Use `plan` skill to organize the test plan & report
|
|
51
|
+
- All screenshots saved in the same report directory
|
|
52
|
+
- Browse URL, discover all pages, components, endpoints
|
|
53
|
+
- Create test plan based on discovered structure
|
|
54
|
+
- Use multiple `tester` subagents in parallel for: pages, forms, navigation, user flows, accessibility, responsive layouts, performance, security, seo
|
|
55
|
+
- Use `ai-multimodal` (if available) to analyze all screenshots
|
|
56
|
+
- Generate comprehensive Markdown report
|
|
57
|
+
- Ask user if they want to preview with `/ck-preview`
|
|
58
|
+
|
|
59
|
+
## Output Requirements
|
|
60
|
+
- Clear, structured Markdown with headers, lists, code blocks
|
|
61
|
+
- Include test results summary, key findings, screenshot references
|
|
62
|
+
- Ensure token efficiency while maintaining high quality
|
|
63
|
+
- Sacrifice grammar for concision
|
|
64
|
+
|
|
65
|
+
**Do not** start implementing fixes.
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ui-styling
|
|
3
3
|
description: Style UIs with shadcn/ui components (Radix UI + Tailwind CSS). Use for accessible components, themes, dark mode, responsive layouts, design systems, color customization.
|
|
4
|
+
license: MIT
|
|
5
|
+
argument-hint: "[component or layout]"
|
|
4
6
|
---
|
|
5
7
|
|
|
6
8
|
# UI Styling Skill
|
|
@@ -1,52 +1,25 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: web-testing
|
|
3
|
-
description: Web testing with Playwright, Vitest, k6. E2E/unit/integration/load/security/visual/a11y testing.
|
|
3
|
+
description: Web testing with Playwright, Vitest, k6. E2E/unit/integration/load/security/visual/a11y testing. Use for test automation, flakiness, Core Web Vitals, mobile gestures, cross-browser.
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
argument-hint: "[test-type] [target]"
|
|
4
6
|
---
|
|
5
7
|
|
|
6
8
|
# Web Testing Skill
|
|
7
9
|
|
|
8
|
-
Comprehensive testing: unit, integration, E2E, load, security, visual regression, accessibility.
|
|
9
|
-
|
|
10
|
-
## Core Principle
|
|
11
|
-
|
|
12
|
-
**NEVER IGNORE FAILING TESTS.** Fix root causes, not symptoms. No mocks/cheats/tricks to pass builds.
|
|
10
|
+
Comprehensive web testing: unit, integration, E2E, load, security, visual regression, accessibility.
|
|
13
11
|
|
|
14
12
|
## Quick Start
|
|
15
13
|
|
|
16
14
|
```bash
|
|
17
|
-
# JavaScript/TypeScript
|
|
18
15
|
npx vitest run # Unit tests
|
|
19
16
|
npx playwright test # E2E tests
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
# Python
|
|
23
|
-
pytest --cov=src # Unit + coverage
|
|
24
|
-
|
|
25
|
-
# Go / Rust / Flutter
|
|
26
|
-
go test ./... -cover # Go
|
|
27
|
-
cargo test # Rust
|
|
28
|
-
flutter test --coverage # Flutter
|
|
29
|
-
|
|
30
|
-
# Web Quality
|
|
17
|
+
npx playwright test --ui # E2E with UI
|
|
31
18
|
k6 run load-test.js # Load tests
|
|
32
|
-
npx @axe-core/cli https
|
|
33
|
-
npx lighthouse https
|
|
19
|
+
npx @axe-core/cli https://example.com # Accessibility
|
|
20
|
+
npx lighthouse https://example.com # Performance
|
|
34
21
|
```
|
|
35
22
|
|
|
36
|
-
## Workflows
|
|
37
|
-
|
|
38
|
-
Three orchestrated workflows — load the relevant reference when needed:
|
|
39
|
-
|
|
40
|
-
| Workflow | Reference | Use When |
|
|
41
|
-
|----------|-----------|----------|
|
|
42
|
-
| Code Testing | `./references/test-execution-workflow.md` | Running unit/integration/e2e, checking coverage, validating builds |
|
|
43
|
-
| UI Testing | `./references/ui-testing-workflow.md` | Visual regression, responsive checks, accessibility audits, form automation |
|
|
44
|
-
| Report Format | `./references/report-format.md` | Generating structured QA summary reports |
|
|
45
|
-
|
|
46
|
-
**Code Testing Process:** Identify scope → Pre-flight checks → Execute tests → Analyze results → Coverage analysis → Build verification → Report
|
|
47
|
-
|
|
48
|
-
**UI Testing Process:** Discovery → Visual capture → Console errors → Network validation → Responsive testing → Form testing → Performance metrics → Report
|
|
49
|
-
|
|
50
23
|
## Testing Strategy (Choose Your Model)
|
|
51
24
|
|
|
52
25
|
| Model | Structure | Best For |
|
|
@@ -55,15 +28,10 @@ Three orchestrated workflows — load the relevant reference when needed:
|
|
|
55
28
|
| Trophy | Integration-heavy | Modern SPAs |
|
|
56
29
|
| Honeycomb | Contract-centric | Microservices |
|
|
57
30
|
|
|
58
|
-
|
|
31
|
+
→ `./references/testing-pyramid-strategy.md`
|
|
59
32
|
|
|
60
33
|
## Reference Documentation
|
|
61
34
|
|
|
62
|
-
### Workflows & Reports
|
|
63
|
-
- `./references/test-execution-workflow.md` - Orchestrated code testing (multi-language)
|
|
64
|
-
- `./references/ui-testing-workflow.md` - Browser-based visual testing via `agent-browser`
|
|
65
|
-
- `./references/report-format.md` - Structured QA report template
|
|
66
|
-
|
|
67
35
|
### Core Testing
|
|
68
36
|
- `./references/unit-integration-testing.md` - Vitest, browser mode, AAA
|
|
69
37
|
- `./references/e2e-testing-playwright.md` - Fixtures, sharding, selectors
|
|
@@ -98,17 +66,6 @@ Three orchestrated workflows — load the relevant reference when needed:
|
|
|
98
66
|
- `./references/pre-release-checklist.md` - Complete release checklist
|
|
99
67
|
- `./references/functional-testing-checklist.md` - Feature testing
|
|
100
68
|
|
|
101
|
-
## Tools Integration
|
|
102
|
-
|
|
103
|
-
- **Test runners**: Vitest, Jest, Mocha, pytest, go test, cargo test, flutter test
|
|
104
|
-
- **Coverage**: Istanbul/c8/nyc, pytest-cov, go cover
|
|
105
|
-
- **E2E**: Playwright (multi-browser, sharding)
|
|
106
|
-
- **Load**: k6
|
|
107
|
-
- **Browser**: `agent-browser` skill for UI testing
|
|
108
|
-
- **Analysis**: `ai-multimodal` skill (if available) for screenshot analysis
|
|
109
|
-
- **Debugging**: `debug` skill when tests reveal bugs
|
|
110
|
-
- **Thinking**: `sequential-thinking` skill for complex test failure analysis
|
|
111
|
-
|
|
112
69
|
## Scripts
|
|
113
70
|
|
|
114
71
|
### Initialize Playwright Project
|
|
@@ -137,12 +94,3 @@ jobs:
|
|
|
137
94
|
- run: npm run test:a11y # Accessibility
|
|
138
95
|
- run: npx lhci autorun # Performance
|
|
139
96
|
```
|
|
140
|
-
|
|
141
|
-
## Quality Standards
|
|
142
|
-
|
|
143
|
-
- All critical paths must have test coverage
|
|
144
|
-
- Validate happy path AND error scenarios
|
|
145
|
-
- Ensure test isolation — no interdependencies
|
|
146
|
-
- Tests must be deterministic and reproducible
|
|
147
|
-
- Clean up test data after execution
|
|
148
|
-
- Coverage: 80%+ lines, 70%+ branches minimum
|