cokit-cli 1.2.0 → 1.2.3
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 +47 -36
- package/agents/brainstormer.agent.md +1 -1
- package/agents/debugger.agent.md +1 -1
- package/agents/docs-manager.agent.md +2 -2
- package/agents/git-manager.agent.md +5 -5
- package/agents/planner.agent.md +3 -3
- package/agents/researcher.agent.md +0 -1
- package/agents/scout.agent.md +9 -9
- package/agents/ui-ux-designer.agent.md +0 -1
- package/collections/ck-orchestration.collection.yml +2 -2
- package/docs/README.md +8 -8
- package/docs/codebase-summary.md +19 -19
- package/docs/cokit-commands-usage-guide.md +42 -43
- package/docs/cokit-comprehensive-mapping-guide.md +15 -15
- package/docs/cokit-slides.md +6 -6
- package/docs/cokit-sync-and-maintenance-guide.md +45 -45
- package/docs/cokit-team-presentation.md +11 -11
- package/docs/copilot-processing-flow.md +11 -11
- package/docs/guide-next-steps-speckit-cokit-implementation.md +1 -1
- package/docs/migration-guide.md +9 -9
- package/docs/project-overview-pdr.md +3 -3
- package/docs/project-roadmap.md +20 -11
- package/docs/system-architecture.md +6 -6
- package/package.json +1 -1
- package/prompts/ck-ask.prompt.md +3 -2
- package/prompts/ck-bootstrap.prompt.md +26 -32
- package/prompts/ck-brainstorm.prompt.md +4 -3
- package/prompts/ck-cook.prompt.md +5 -4
- package/prompts/ck-debug.prompt.md +4 -3
- package/prompts/ck-docs.prompt.md +4 -3
- package/prompts/ck-fix-ci.prompt.md +46 -0
- package/prompts/ck-fix-fast.prompt.md +44 -0
- package/prompts/ck-fix-hard.prompt.md +60 -0
- package/prompts/ck-fix-logs.prompt.md +53 -0
- package/prompts/ck-fix-test.prompt.md +47 -0
- package/prompts/ck-fix-types.prompt.md +29 -0
- package/prompts/ck-fix-ui.prompt.md +50 -0
- package/prompts/ck-fix.prompt.md +13 -15
- package/prompts/ck-git.prompt.md +2 -2
- package/prompts/ck-help.prompt.md +8 -6
- package/prompts/ck-journal.prompt.md +5 -3
- package/prompts/ck-plan-fast.prompt.md +26 -5
- package/prompts/ck-plan-hard.prompt.md +30 -9
- package/prompts/ck-plan-validate.prompt.md +209 -0
- package/prompts/ck-plan.prompt.md +49 -12
- package/prompts/ck-preview.prompt.md +16 -32
- package/prompts/ck-review.prompt.md +10 -11
- package/prompts/ck-scout.prompt.md +5 -4
- package/prompts/ck-simplify.prompt.md +3 -3
- package/prompts/ck-spec-analyze.prompt.md +9 -11
- package/prompts/ck-spec-checklist.prompt.md +7 -9
- package/prompts/ck-spec-clarify.prompt.md +8 -15
- package/prompts/ck-spec-constitution.prompt.md +6 -11
- package/prompts/ck-spec-implement.prompt.md +7 -10
- package/prompts/ck-spec-plan.prompt.md +5 -18
- package/prompts/ck-spec-specify.prompt.md +8 -17
- package/prompts/ck-spec-tasks.prompt.md +4 -16
- package/prompts/ck-test.prompt.md +5 -3
- package/prompts/ck-watzup.prompt.md +4 -2
- package/skills/INSTALLATION.md +3 -3
- package/skills/README.md +12 -34
- package/skills/agent-browser/SKILL.md +0 -1
- package/skills/agent_skills_spec.md +2 -2
- package/skills/backend-development/SKILL.md +0 -2
- package/skills/brainstorm/SKILL.md +7 -9
- package/skills/code-review/SKILL.md +9 -9
- package/skills/code-review/references/code-review-reception.md +1 -1
- package/skills/code-review/references/requesting-code-review.md +7 -7
- package/skills/common/api_key_helper.py +8 -8
- package/skills/context-engineering/SKILL.md +3 -4
- package/skills/context-engineering/references/context-degradation.md +2 -2
- package/skills/context-engineering/references/runtime-awareness.md +6 -6
- package/skills/cook/README.md +2 -2
- package/skills/cook/SKILL.md +3 -4
- package/skills/cook/references/agent-patterns.md +75 -0
- package/skills/cook/references/review-cycle.md +2 -2
- package/skills/cook/references/workflow-steps.md +6 -6
- package/skills/databases/SKILL.md +0 -1
- package/skills/databases/scripts/db_migrate.py +2 -2
- package/skills/databases/scripts/db_performance_check.py +2 -2
- package/skills/debug/SKILL.md +0 -1
- package/skills/devops/SKILL.md +0 -2
- package/skills/devops/scripts/docker_optimize.py +2 -2
- package/skills/docs-seeker/SKILL.md +0 -1
- package/skills/docs-seeker/package.json +1 -1
- package/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
- package/skills/fix/SKILL.md +10 -11
- package/skills/fix/references/mode-selection.md +11 -27
- package/skills/fix/references/parallel-exploration.md +9 -9
- package/skills/fix/references/review-cycle.md +3 -3
- package/skills/fix/references/skill-activation-matrix.md +3 -3
- package/skills/fix/references/workflow-deep.md +11 -11
- package/skills/fix/references/workflow-quick.md +5 -5
- package/skills/fix/references/workflow-standard.md +12 -12
- package/skills/frontend-design/SKILL.md +2 -3
- package/skills/frontend-design/references/workflow-describe.md +1 -1
- package/skills/frontend-design/references/workflow-quick.md +1 -1
- package/skills/frontend-design/references/workflow-screenshot.md +1 -1
- package/skills/git/SKILL.md +2 -3
- package/skills/git/references/commit-standards.md +2 -2
- package/skills/git/references/workflow-commit.md +1 -1
- 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/install.ps1 +5 -5
- package/skills/install.sh +2 -2
- package/skills/mcp-management/README.md +8 -8
- package/skills/mcp-management/SKILL.md +9 -9
- package/skills/mcp-management/references/gemini-cli-integration.md +2 -2
- package/skills/mcp-management/scripts/.env.example +2 -2
- package/skills/planning/SKILL.md +4 -5
- package/skills/planning/references/output-standards.md +1 -1
- package/skills/planning/references/plan-organization.md +1 -1
- package/skills/problem-solving/SKILL.md +1 -2
- package/skills/repomix/SKILL.md +2 -2
- package/skills/repomix/references/usage-patterns.md +2 -2
- package/skills/research/SKILL.md +0 -1
- package/skills/scout/SKILL.md +9 -10
- package/skills/scout/references/external-scouting.md +10 -10
- package/skills/scout/references/internal-scouting.md +9 -9
- package/skills/sequential-thinking/README.md +3 -3
- package/skills/sequential-thinking/SKILL.md +0 -2
- package/skills/sequential-thinking/package.json +1 -1
- package/skills/ui-styling/SKILL.md +0 -2
- package/skills/web-testing/SKILL.md +0 -2
- package/templates/repo/.github/agents/brainstormer.agent.md +1 -1
- package/templates/repo/.github/agents/debugger.agent.md +1 -1
- package/templates/repo/.github/agents/docs-manager.agent.md +2 -2
- package/templates/repo/.github/agents/git-manager.agent.md +5 -5
- package/templates/repo/.github/agents/planner.agent.md +3 -3
- package/templates/repo/.github/agents/researcher.agent.md +0 -1
- package/templates/repo/.github/agents/scout.agent.md +9 -9
- package/templates/repo/.github/agents/ui-ux-designer.agent.md +0 -1
- package/templates/repo/.github/collections/ck-orchestration.collection.yml +2 -2
- package/templates/repo/.github/prompts/ck-ask.prompt.md +3 -2
- package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +26 -32
- package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-cook.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-debug.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-docs.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-fix-ci.prompt.md +46 -0
- package/templates/repo/.github/prompts/ck-fix-fast.prompt.md +44 -0
- package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +60 -0
- package/templates/repo/.github/prompts/ck-fix-logs.prompt.md +53 -0
- package/templates/repo/.github/prompts/ck-fix-test.prompt.md +47 -0
- package/templates/repo/.github/prompts/ck-fix-types.prompt.md +29 -0
- package/templates/repo/.github/prompts/ck-fix-ui.prompt.md +50 -0
- package/templates/repo/.github/prompts/ck-fix.prompt.md +13 -15
- package/templates/repo/.github/prompts/ck-git.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-help.prompt.md +8 -6
- package/templates/repo/.github/prompts/ck-journal.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +26 -5
- package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +30 -9
- package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +209 -0
- package/templates/repo/.github/prompts/ck-plan.prompt.md +49 -12
- package/templates/repo/.github/prompts/ck-preview.prompt.md +16 -32
- package/templates/repo/.github/prompts/ck-review.prompt.md +10 -11
- package/templates/repo/.github/prompts/ck-scout.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-simplify.prompt.md +3 -3
- package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +9 -11
- package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +7 -9
- package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +8 -15
- package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +6 -11
- package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +7 -10
- package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +5 -18
- package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +7 -17
- package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +4 -16
- package/templates/repo/.github/prompts/ck-test.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-watzup.prompt.md +4 -2
- package/templates/repo/.github/skills/INSTALLATION.md +3 -3
- package/templates/repo/.github/skills/README.md +12 -34
- package/templates/repo/.github/skills/agent-browser/SKILL.md +0 -1
- package/templates/repo/.github/skills/agent_skills_spec.md +2 -2
- package/templates/repo/.github/skills/backend-development/SKILL.md +0 -2
- package/templates/repo/.github/skills/brainstorm/SKILL.md +7 -9
- package/templates/repo/.github/skills/code-review/SKILL.md +9 -9
- package/templates/repo/.github/skills/code-review/references/code-review-reception.md +1 -1
- package/templates/repo/.github/skills/code-review/references/requesting-code-review.md +7 -7
- package/templates/repo/.github/skills/common/api_key_helper.py +8 -8
- package/templates/repo/.github/skills/context-engineering/SKILL.md +3 -4
- package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +2 -2
- package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +6 -6
- package/templates/repo/.github/skills/cook/README.md +2 -2
- package/templates/repo/.github/skills/cook/SKILL.md +3 -4
- package/templates/repo/.github/skills/cook/references/agent-patterns.md +75 -0
- package/templates/repo/.github/skills/cook/references/review-cycle.md +2 -2
- package/templates/repo/.github/skills/cook/references/workflow-steps.md +6 -6
- package/templates/repo/.github/skills/databases/SKILL.md +0 -1
- package/templates/repo/.github/skills/databases/scripts/db_migrate.py +2 -2
- package/templates/repo/.github/skills/databases/scripts/db_performance_check.py +2 -2
- package/templates/repo/.github/skills/debug/SKILL.md +0 -1
- package/templates/repo/.github/skills/devops/SKILL.md +0 -2
- package/templates/repo/.github/skills/devops/scripts/docker_optimize.py +2 -2
- package/templates/repo/.github/skills/docs-seeker/SKILL.md +0 -1
- package/templates/repo/.github/skills/docs-seeker/package.json +1 -1
- package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
- package/templates/repo/.github/skills/fix/SKILL.md +10 -11
- package/templates/repo/.github/skills/fix/references/mode-selection.md +11 -27
- package/templates/repo/.github/skills/fix/references/parallel-exploration.md +9 -9
- package/templates/repo/.github/skills/fix/references/review-cycle.md +3 -3
- package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +3 -3
- package/templates/repo/.github/skills/fix/references/workflow-deep.md +11 -11
- package/templates/repo/.github/skills/fix/references/workflow-quick.md +5 -5
- package/templates/repo/.github/skills/fix/references/workflow-standard.md +12 -12
- package/templates/repo/.github/skills/frontend-design/SKILL.md +2 -3
- package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +1 -1
- package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +1 -1
- package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +1 -1
- package/templates/repo/.github/skills/git/SKILL.md +2 -3
- package/templates/repo/.github/skills/git/references/commit-standards.md +2 -2
- package/templates/repo/.github/skills/git/references/workflow-commit.md +1 -1
- 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/install.ps1 +5 -5
- package/templates/repo/.github/skills/install.sh +2 -2
- package/templates/repo/.github/skills/mcp-management/README.md +8 -8
- package/templates/repo/.github/skills/mcp-management/SKILL.md +9 -9
- package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +2 -2
- package/templates/repo/.github/skills/mcp-management/scripts/.env.example +2 -2
- package/templates/repo/.github/skills/planning/SKILL.md +4 -5
- package/templates/repo/.github/skills/planning/references/output-standards.md +1 -1
- package/templates/repo/.github/skills/planning/references/plan-organization.md +1 -1
- package/templates/repo/.github/skills/problem-solving/SKILL.md +1 -2
- package/templates/repo/.github/skills/repomix/SKILL.md +2 -2
- package/templates/repo/.github/skills/repomix/references/usage-patterns.md +2 -2
- package/templates/repo/.github/skills/research/SKILL.md +0 -1
- package/templates/repo/.github/skills/scout/SKILL.md +9 -10
- package/templates/repo/.github/skills/scout/references/external-scouting.md +10 -10
- package/templates/repo/.github/skills/scout/references/internal-scouting.md +9 -9
- package/templates/repo/.github/skills/sequential-thinking/README.md +3 -3
- package/templates/repo/.github/skills/sequential-thinking/SKILL.md +0 -2
- package/templates/repo/.github/skills/sequential-thinking/package.json +1 -1
- package/templates/repo/.github/skills/ui-styling/SKILL.md +0 -2
- package/templates/repo/.github/skills/web-testing/SKILL.md +0 -2
- package/docs/cokit-instruction-guide.html +0 -3004
- package/docs/images/cokit-command-finder-final.png +0 -0
- package/docs/images/cokit-highlight-fix.png +0 -0
- package/docs/images/cokit-highlight-test.png +0 -0
- package/prompts/ck-spec-taskstoissues.prompt.md +0 -48
- package/skills/cook/references/subagent-patterns.md +0 -75
- package/templates/repo/.github/prompts/ck-spec-taskstoissues.prompt.md +0 -48
- package/templates/repo/.github/skills/cook/references/subagent-patterns.md +0 -75
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
agent: 'agent'
|
|
3
|
-
description: 'Convert tasks into GitHub issues for project tracking'
|
|
4
|
-
tools:
|
|
5
|
-
- github/github-mcp-server/issue_write
|
|
6
|
-
scripts:
|
|
7
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
|
|
8
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## User Input
|
|
12
|
-
|
|
13
|
-
```text
|
|
14
|
-
${input}
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
You **MUST** consider the user input before proceeding (if not empty).
|
|
18
|
-
|
|
19
|
-
## Outline
|
|
20
|
-
|
|
21
|
-
1. Run `{SCRIPT}` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
|
|
22
|
-
|
|
23
|
-
2. From the executed script, extract the path to **tasks**.
|
|
24
|
-
|
|
25
|
-
3. **Verify Git repository and GitHub remote**:
|
|
26
|
-
- Check if this is a git repository: `git rev-parse --git-dir 2>/dev/null`
|
|
27
|
-
- If NOT a git repo: **STOP** and inform user "This command requires a git repository with a GitHub remote. Initialize git first or use `/ck.spec.implement` instead."
|
|
28
|
-
- Get the Git remote: `git config --get remote.origin.url`
|
|
29
|
-
|
|
30
|
-
> [!CAUTION]
|
|
31
|
-
> ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL (contains github.com)
|
|
32
|
-
|
|
33
|
-
4. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.
|
|
34
|
-
|
|
35
|
-
> [!CAUTION]
|
|
36
|
-
> UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## Suggested Next Steps
|
|
41
|
-
|
|
42
|
-
| Command | Description | When to Use |
|
|
43
|
-
|---------|-------------|-------------|
|
|
44
|
-
| `/ck.spec.implement` | Start implementation | Issues created, ready to code |
|
|
45
|
-
| `/ck.spec.tasks` | Regenerate tasks | Need to update task list |
|
|
46
|
-
| `/ck.kanban` | View project board | Track progress on created issues |
|
|
47
|
-
|
|
48
|
-
**Usage:** Run after `/ck.spec.tasks` to sync tasks with GitHub Issues for team tracking
|
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
# Subagent Patterns
|
|
2
|
-
|
|
3
|
-
Standard patterns for spawning and using subagents in cook workflows.
|
|
4
|
-
|
|
5
|
-
## Task Tool Pattern
|
|
6
|
-
```
|
|
7
|
-
Task(subagent_type="[type]", prompt="[task description]", description="[brief]")
|
|
8
|
-
```
|
|
9
|
-
|
|
10
|
-
## Research Phase
|
|
11
|
-
```
|
|
12
|
-
Task(subagent_type="researcher", prompt="Research [topic]. Report ≤150 lines.", description="Research [topic]")
|
|
13
|
-
```
|
|
14
|
-
- Use multiple researchers in parallel for different topics
|
|
15
|
-
- Keep reports ≤150 lines with citations
|
|
16
|
-
|
|
17
|
-
## Scout Phase
|
|
18
|
-
```
|
|
19
|
-
Task(subagent_type="scout", prompt="Find files related to [feature] in codebase", description="Scout [feature]")
|
|
20
|
-
```
|
|
21
|
-
- Use `/scout:ext` (preferred) or `/scout` (fallback)
|
|
22
|
-
|
|
23
|
-
## Planning Phase
|
|
24
|
-
```
|
|
25
|
-
Task(subagent_type="planner", prompt="Create implementation plan based on reports: [reports]. Save to [path]", description="Plan [feature]")
|
|
26
|
-
```
|
|
27
|
-
- Input: researcher and scout reports
|
|
28
|
-
- Output: `plan.md` + `phase-XX-*.md` files
|
|
29
|
-
|
|
30
|
-
## UI Implementation
|
|
31
|
-
```
|
|
32
|
-
Task(subagent_type="ui-ux-designer", prompt="Implement [feature] UI per ./docs/design-guidelines.md", description="UI [feature]")
|
|
33
|
-
```
|
|
34
|
-
- For frontend work
|
|
35
|
-
- Follow design guidelines
|
|
36
|
-
|
|
37
|
-
## Testing
|
|
38
|
-
```
|
|
39
|
-
Task(subagent_type="tester", prompt="Run test suite for plan phase [phase-name]", description="Test [phase]")
|
|
40
|
-
```
|
|
41
|
-
- Must achieve 100% pass rate
|
|
42
|
-
|
|
43
|
-
## Debugging
|
|
44
|
-
```
|
|
45
|
-
Task(subagent_type="debugger", prompt="Analyze failures: [details]", description="Debug [issue]")
|
|
46
|
-
```
|
|
47
|
-
- Use when tests fail
|
|
48
|
-
- Provides root cause analysis
|
|
49
|
-
|
|
50
|
-
## Code Review
|
|
51
|
-
```
|
|
52
|
-
Task(subagent_type="code-reviewer", prompt="Review changes for [phase]. Check security, performance, YAGNI/KISS/DRY. Return score (X/10), critical, warnings, suggestions.", description="Review [phase]")
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## Project Management
|
|
56
|
-
```
|
|
57
|
-
Task(subagent_type="project-manager", prompt="Update plan status in [path]. Mark [phase] as DONE. Update roadmap.", description="Update plan")
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
## Documentation
|
|
61
|
-
```
|
|
62
|
-
Task(subagent_type="docs-manager", prompt="Update docs for [phase]. Changed files: [list]", description="Update docs")
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
## Git Operations
|
|
66
|
-
```
|
|
67
|
-
Task(subagent_type="git-manager", prompt="Stage and commit changes with conventional commit message", description="Commit changes")
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## Parallel Execution
|
|
71
|
-
```
|
|
72
|
-
Task(subagent_type="fullstack-developer", prompt="Implement [phase-file] with file ownership: [files]", description="Implement phase [N]")
|
|
73
|
-
```
|
|
74
|
-
- Launch multiple for parallel phases
|
|
75
|
-
- Include file ownership boundaries
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
agent: 'agent'
|
|
3
|
-
description: 'Convert tasks into GitHub issues for project tracking'
|
|
4
|
-
tools:
|
|
5
|
-
- github/github-mcp-server/issue_write
|
|
6
|
-
scripts:
|
|
7
|
-
sh: spec-kit/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
|
|
8
|
-
ps: spec-kit/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## User Input
|
|
12
|
-
|
|
13
|
-
```text
|
|
14
|
-
${input}
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
You **MUST** consider the user input before proceeding (if not empty).
|
|
18
|
-
|
|
19
|
-
## Outline
|
|
20
|
-
|
|
21
|
-
1. Run `{SCRIPT}` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
|
|
22
|
-
|
|
23
|
-
2. From the executed script, extract the path to **tasks**.
|
|
24
|
-
|
|
25
|
-
3. **Verify Git repository and GitHub remote**:
|
|
26
|
-
- Check if this is a git repository: `git rev-parse --git-dir 2>/dev/null`
|
|
27
|
-
- If NOT a git repo: **STOP** and inform user "This command requires a git repository with a GitHub remote. Initialize git first or use `/ck.spec.implement` instead."
|
|
28
|
-
- Get the Git remote: `git config --get remote.origin.url`
|
|
29
|
-
|
|
30
|
-
> [!CAUTION]
|
|
31
|
-
> ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL (contains github.com)
|
|
32
|
-
|
|
33
|
-
4. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.
|
|
34
|
-
|
|
35
|
-
> [!CAUTION]
|
|
36
|
-
> UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## Suggested Next Steps
|
|
41
|
-
|
|
42
|
-
| Command | Description | When to Use |
|
|
43
|
-
|---------|-------------|-------------|
|
|
44
|
-
| `/ck.spec.implement` | Start implementation | Issues created, ready to code |
|
|
45
|
-
| `/ck.spec.tasks` | Regenerate tasks | Need to update task list |
|
|
46
|
-
| `/ck.kanban` | View project board | Track progress on created issues |
|
|
47
|
-
|
|
48
|
-
**Usage:** Run after `/ck.spec.tasks` to sync tasks with GitHub Issues for team tracking
|
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
# Subagent Patterns
|
|
2
|
-
|
|
3
|
-
Standard patterns for spawning and using subagents in cook workflows.
|
|
4
|
-
|
|
5
|
-
## Task Tool Pattern
|
|
6
|
-
```
|
|
7
|
-
Task(subagent_type="[type]", prompt="[task description]", description="[brief]")
|
|
8
|
-
```
|
|
9
|
-
|
|
10
|
-
## Research Phase
|
|
11
|
-
```
|
|
12
|
-
Task(subagent_type="researcher", prompt="Research [topic]. Report ≤150 lines.", description="Research [topic]")
|
|
13
|
-
```
|
|
14
|
-
- Use multiple researchers in parallel for different topics
|
|
15
|
-
- Keep reports ≤150 lines with citations
|
|
16
|
-
|
|
17
|
-
## Scout Phase
|
|
18
|
-
```
|
|
19
|
-
Task(subagent_type="scout", prompt="Find files related to [feature] in codebase", description="Scout [feature]")
|
|
20
|
-
```
|
|
21
|
-
- Use `/scout:ext` (preferred) or `/scout` (fallback)
|
|
22
|
-
|
|
23
|
-
## Planning Phase
|
|
24
|
-
```
|
|
25
|
-
Task(subagent_type="planner", prompt="Create implementation plan based on reports: [reports]. Save to [path]", description="Plan [feature]")
|
|
26
|
-
```
|
|
27
|
-
- Input: researcher and scout reports
|
|
28
|
-
- Output: `plan.md` + `phase-XX-*.md` files
|
|
29
|
-
|
|
30
|
-
## UI Implementation
|
|
31
|
-
```
|
|
32
|
-
Task(subagent_type="ui-ux-designer", prompt="Implement [feature] UI per ./docs/design-guidelines.md", description="UI [feature]")
|
|
33
|
-
```
|
|
34
|
-
- For frontend work
|
|
35
|
-
- Follow design guidelines
|
|
36
|
-
|
|
37
|
-
## Testing
|
|
38
|
-
```
|
|
39
|
-
Task(subagent_type="tester", prompt="Run test suite for plan phase [phase-name]", description="Test [phase]")
|
|
40
|
-
```
|
|
41
|
-
- Must achieve 100% pass rate
|
|
42
|
-
|
|
43
|
-
## Debugging
|
|
44
|
-
```
|
|
45
|
-
Task(subagent_type="debugger", prompt="Analyze failures: [details]", description="Debug [issue]")
|
|
46
|
-
```
|
|
47
|
-
- Use when tests fail
|
|
48
|
-
- Provides root cause analysis
|
|
49
|
-
|
|
50
|
-
## Code Review
|
|
51
|
-
```
|
|
52
|
-
Task(subagent_type="code-reviewer", prompt="Review changes for [phase]. Check security, performance, YAGNI/KISS/DRY. Return score (X/10), critical, warnings, suggestions.", description="Review [phase]")
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## Project Management
|
|
56
|
-
```
|
|
57
|
-
Task(subagent_type="project-manager", prompt="Update plan status in [path]. Mark [phase] as DONE. Update roadmap.", description="Update plan")
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
## Documentation
|
|
61
|
-
```
|
|
62
|
-
Task(subagent_type="docs-manager", prompt="Update docs for [phase]. Changed files: [list]", description="Update docs")
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
## Git Operations
|
|
66
|
-
```
|
|
67
|
-
Task(subagent_type="git-manager", prompt="Stage and commit changes with conventional commit message", description="Commit changes")
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## Parallel Execution
|
|
71
|
-
```
|
|
72
|
-
Task(subagent_type="fullstack-developer", prompt="Implement [phase-file] with file ownership: [files]", description="Implement phase [N]")
|
|
73
|
-
```
|
|
74
|
-
- Launch multiple for parallel phases
|
|
75
|
-
- Include file ownership boundaries
|