cokit-cli 1.2.0 → 1.2.2
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 +7 -7
- 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 +7 -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
|
@@ -15,7 +15,7 @@ MCP is an open protocol enabling AI agents to connect to external tools and data
|
|
|
15
15
|
- Progressive disclosure of MCP capabilities (load only what's needed)
|
|
16
16
|
- Intelligent tool/prompt/resource selection based on task requirements
|
|
17
17
|
- Multi-server management from single config file
|
|
18
|
-
- Context-efficient:
|
|
18
|
+
- Context-efficient: agents handle MCP discovery and execution
|
|
19
19
|
- Persistent tool catalog: automatically saves discovered tools to JSON for fast reference
|
|
20
20
|
|
|
21
21
|
## When to Use This Skill
|
|
@@ -25,7 +25,7 @@ Use this skill when:
|
|
|
25
25
|
2. **Task-Based Tool Selection**: Analyzing which MCP tools are relevant for a specific task
|
|
26
26
|
3. **Executing MCP Tools**: Calling MCP tools programmatically with proper parameter handling
|
|
27
27
|
4. **MCP Integration**: Building or debugging MCP client implementations
|
|
28
|
-
5. **Context Management**: Avoiding context pollution by delegating MCP operations to
|
|
28
|
+
5. **Context Management**: Avoiding context pollution by delegating MCP operations to agents
|
|
29
29
|
|
|
30
30
|
## Core Capabilities
|
|
31
31
|
|
|
@@ -80,7 +80,7 @@ echo "Take a screenshot of https://example.com" | gemini -y -m <gemini.model>
|
|
|
80
80
|
npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'
|
|
81
81
|
```
|
|
82
82
|
|
|
83
|
-
**Fallback: mcp-manager
|
|
83
|
+
**Fallback: mcp-manager Agent**
|
|
84
84
|
|
|
85
85
|
See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete examples.
|
|
86
86
|
|
|
@@ -104,16 +104,16 @@ echo "Take a screenshot of https://example.com. Return JSON only per GEMINI.md i
|
|
|
104
104
|
|
|
105
105
|
**Benefits**:
|
|
106
106
|
- Automatic tool discovery
|
|
107
|
-
- Structured JSON responses (parseable by
|
|
107
|
+
- Structured JSON responses (parseable by the agent)
|
|
108
108
|
- GEMINI.md auto-loaded for consistent formatting
|
|
109
|
-
- Faster than
|
|
109
|
+
- Faster than agent orchestration
|
|
110
110
|
- No natural language ambiguity
|
|
111
111
|
|
|
112
112
|
See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
|
|
113
113
|
|
|
114
|
-
### Pattern 2:
|
|
114
|
+
### Pattern 2: Agent-Based Execution (Fallback)
|
|
115
115
|
|
|
116
|
-
Use `mcp-manager` agent when Gemini CLI unavailable.
|
|
116
|
+
Use `mcp-manager` agent when Gemini CLI unavailable. Agent discovers tools, selects relevant ones, executes tasks, reports back.
|
|
117
117
|
|
|
118
118
|
**Benefit**: Main context stays clean, only relevant tool definitions loaded when needed.
|
|
119
119
|
|
|
@@ -166,7 +166,7 @@ npx tsx cli.ts list-tools # Saves to assets/tools.json
|
|
|
166
166
|
npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'
|
|
167
167
|
```
|
|
168
168
|
|
|
169
|
-
**Method 3: mcp-manager
|
|
169
|
+
**Method 3: mcp-manager Agent**
|
|
170
170
|
|
|
171
171
|
See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
|
|
172
172
|
|
|
@@ -193,7 +193,7 @@ See [references/mcp-protocol.md](references/mcp-protocol.md) for:
|
|
|
193
193
|
- Use when: Need specific tool/server control
|
|
194
194
|
- Execute: `npx tsx scripts/cli.ts call-tool <server> <tool> <args>`
|
|
195
195
|
|
|
196
|
-
3. **mcp-manager
|
|
196
|
+
3. **mcp-manager Agent** (Fallback): Context-efficient delegation
|
|
197
197
|
- Use when: Gemini unavailable or failed
|
|
198
198
|
- Keeps main context clean
|
|
199
199
|
|
|
@@ -97,7 +97,7 @@ echo "Search for latest Next.js 15 features and summarize the top 3" | gemini -y
|
|
|
97
97
|
|
|
98
98
|
**Multi-Tool Orchestration**:
|
|
99
99
|
```bash
|
|
100
|
-
echo "Search for
|
|
100
|
+
echo "Search for AI documentation, take a screenshot of the homepage, and save both to memory" | gemini -y -m <gemini.model>
|
|
101
101
|
```
|
|
102
102
|
|
|
103
103
|
**Browser Automation**:
|
|
@@ -212,7 +212,7 @@ Shows detailed MCP communication logs.
|
|
|
212
212
|
| Direct Scripts | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | Specific tools |
|
|
213
213
|
| mcp-manager | ⭐ | ⭐⭐ | ⭐⭐⭐ | Fallback |
|
|
214
214
|
|
|
215
|
-
**Recommendation**: Use Gemini CLI as primary method, fallback to scripts/
|
|
215
|
+
**Recommendation**: Use Gemini CLI as primary method, fallback to scripts/agent when unavailable.
|
|
216
216
|
|
|
217
217
|
## Resources
|
|
218
218
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# MCP Management Scripts Environment Variables
|
|
2
2
|
|
|
3
|
-
# Path to MCP configuration file (optional, defaults to .
|
|
4
|
-
MCP_CONFIG_PATH=.
|
|
3
|
+
# Path to MCP configuration file (optional, defaults to .copilot/.mcp.json)
|
|
4
|
+
MCP_CONFIG_PATH=.copilot/.mcp.json
|
|
5
5
|
|
|
6
6
|
# Logging level (optional, defaults to info)
|
|
7
7
|
LOG_LEVEL=info
|
package/skills/planning/SKILL.md
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: planning
|
|
3
3
|
description: Plan implementations, design architectures, create technical roadmaps with detailed phases. Use for feature planning, system design, solution architecture, implementation strategy, phase documentation.
|
|
4
|
-
license: MIT
|
|
5
4
|
---
|
|
6
5
|
|
|
7
6
|
# Planning
|
|
@@ -60,11 +59,11 @@ Load: `references/output-standards.md`
|
|
|
60
59
|
|
|
61
60
|
## Task Integration (Optional)
|
|
62
61
|
|
|
63
|
-
When session has `
|
|
64
|
-
-
|
|
62
|
+
When session has `TASK_LIST_ID` set (active plan):
|
|
63
|
+
- Create tasks for each phase with clear subjects
|
|
65
64
|
- Set dependencies: Phase N+1 `blockedBy` Phase N
|
|
66
|
-
-
|
|
67
|
-
-
|
|
65
|
+
- Agents coordinate via shared task list automatically
|
|
66
|
+
- Update tasks to mark progress (in_progress → completed)
|
|
68
67
|
|
|
69
68
|
### Important
|
|
70
69
|
DO NOT create plans or reports in USER directory.
|
|
@@ -98,7 +98,7 @@ List affected files with:
|
|
|
98
98
|
- Prioritize actionable info
|
|
99
99
|
|
|
100
100
|
### Unresolved Questions
|
|
101
|
-
**IMPORTANT:**
|
|
101
|
+
**IMPORTANT:** List unresolved questions at the end of your response and ask users directly. Wait for their answers before finalizing.
|
|
102
102
|
- Questions needing clarification
|
|
103
103
|
- Technical decisions requiring input
|
|
104
104
|
- Unknowns impacting implementation
|
|
@@ -48,7 +48,7 @@ Check the `## Plan Context` section injected by hooks:
|
|
|
48
48
|
|
|
49
49
|
**After Creating Plan:**
|
|
50
50
|
```bash
|
|
51
|
-
# Update session state so
|
|
51
|
+
# Update session state so agents get the new plan context:
|
|
52
52
|
node $HOME/.copilot/scripts/set-active-plan.cjs {plan-dir}
|
|
53
53
|
```
|
|
54
54
|
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: problem-solving
|
|
3
3
|
description: Apply systematic problem-solving techniques when stuck. Use for complexity spirals, innovation blocks, recurring patterns, assumption constraints, simplification cascades, scale uncertainty.
|
|
4
|
-
version: 2.0.0
|
|
5
4
|
---
|
|
6
5
|
|
|
7
6
|
# Problem-Solving Techniques
|
package/skills/repomix/SKILL.md
CHANGED
|
@@ -5,7 +5,7 @@ description: Pack repositories into AI-friendly files with Repomix (XML, Markdow
|
|
|
5
5
|
|
|
6
6
|
# Repomix Skill
|
|
7
7
|
|
|
8
|
-
Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like
|
|
8
|
+
Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like ChatGPT, Gemini, and others.
|
|
9
9
|
|
|
10
10
|
## When to Use
|
|
11
11
|
|
|
@@ -153,7 +153,7 @@ repomix --init # creates repomix.config.json
|
|
|
153
153
|
Repomix automatically counts tokens for individual files, total repository, and per-format output.
|
|
154
154
|
|
|
155
155
|
Typical LLM context limits:
|
|
156
|
-
-
|
|
156
|
+
- Model (Medium): ~200K tokens
|
|
157
157
|
- GPT-4: ~128K tokens
|
|
158
158
|
- GPT-3.5: ~16K tokens
|
|
159
159
|
|
|
@@ -144,9 +144,9 @@ repomix --include "$(cat staged-files.txt | tr '\n' ',')" -o .context/latest.xml
|
|
|
144
144
|
{"version": "2.0.0", "tasks": [{"label": "Package for AI", "type": "shell", "command": "repomix --include 'src/**' --remove-comments --copy"}]}
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
###
|
|
147
|
+
### AI Coding Agent
|
|
148
148
|
```bash
|
|
149
|
-
repomix --style markdown --copy # Then paste into
|
|
149
|
+
repomix --style markdown --copy # Then paste into the AI agent
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
## Language-Specific Patterns
|
package/skills/research/SKILL.md
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: research
|
|
3
3
|
description: Research technical solutions, analyze architectures, gather requirements thoroughly. Use for technology evaluation, best practices research, solution design, scalability/security/maintainability analysis.
|
|
4
|
-
license: MIT
|
|
5
4
|
---
|
|
6
5
|
|
|
7
6
|
# Research
|
package/skills/scout/SKILL.md
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: scout
|
|
3
|
-
description: Fast codebase scouting using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal
|
|
4
|
-
version: 1.0.0
|
|
3
|
+
description: Fast codebase scouting using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal and external search agents.
|
|
5
4
|
---
|
|
6
5
|
|
|
7
6
|
# Scout
|
|
@@ -9,7 +8,7 @@ version: 1.0.0
|
|
|
9
8
|
Fast, token-efficient codebase scouting using parallel agents to find files needed for tasks.
|
|
10
9
|
|
|
11
10
|
## Arguments
|
|
12
|
-
- Default: Scout using built-in
|
|
11
|
+
- Default: Scout using built-in search agents in parallel (`./references/internal-scouting.md`)
|
|
13
12
|
- `ext`: Scout using external Gemini/OpenCode CLI tools in parallel (`./references/external-scouting.md`)
|
|
14
13
|
|
|
15
14
|
## When to Use
|
|
@@ -37,7 +36,7 @@ Read from `$HOME/.copilot/.ck.json`:
|
|
|
37
36
|
### 1. Analyze Task
|
|
38
37
|
- Parse user prompt for search targets
|
|
39
38
|
- Identify key directories, patterns, file types, lines of code
|
|
40
|
-
- Determine optimal SCALE value of
|
|
39
|
+
- Determine optimal SCALE value of agents to spawn
|
|
41
40
|
|
|
42
41
|
### 2. Divide and Conquer
|
|
43
42
|
- Split codebase into logical segments per agent
|
|
@@ -46,14 +45,14 @@ Read from `$HOME/.copilot/.ck.json`:
|
|
|
46
45
|
|
|
47
46
|
### 3. Spawn Parallel Agents
|
|
48
47
|
Load appropriate reference based on decision tree:
|
|
49
|
-
- **Internal (Default):** `references/internal-scouting.md` (
|
|
48
|
+
- **Internal (Default):** `references/internal-scouting.md` (search agents)
|
|
50
49
|
- **External:** `references/external-scouting.md` (Gemini/OpenCode)
|
|
51
50
|
|
|
52
51
|
**Notes:**
|
|
53
|
-
- Prompt detailed instructions for each
|
|
54
|
-
- Remember that each
|
|
55
|
-
- Amount of
|
|
56
|
-
- Each
|
|
52
|
+
- Prompt detailed instructions for each agent with exact directories or files it should read
|
|
53
|
+
- Remember that each agent has less than 200K tokens of context window
|
|
54
|
+
- Amount of agents to-be-spawned depends on the current system resources available and amount of files to be scanned
|
|
55
|
+
- Each agent must return a detailed summary report to a main agent
|
|
57
56
|
|
|
58
57
|
### 4. Collect Results
|
|
59
58
|
- Timeout: 3 minutes per agent (skip non-responders)
|
|
@@ -75,5 +74,5 @@ Load appropriate reference based on decision tree:
|
|
|
75
74
|
|
|
76
75
|
## References
|
|
77
76
|
|
|
78
|
-
- `references/internal-scouting.md` - Using
|
|
77
|
+
- `references/internal-scouting.md` - Using search agents
|
|
79
78
|
- `references/external-scouting.md` - Using Gemini/OpenCode CLI
|
|
@@ -57,16 +57,16 @@ which opencode
|
|
|
57
57
|
|
|
58
58
|
If not installed, ask user:
|
|
59
59
|
1. **Yes** - Provide installation instructions (may need manual auth steps)
|
|
60
|
-
2. **No** - Fall back to Explore
|
|
60
|
+
2. **No** - Fall back to Explore agents (`internal-scouting.md`)
|
|
61
61
|
|
|
62
62
|
## Spawning Parallel Bash Agents
|
|
63
63
|
|
|
64
|
-
Use `Task` tool with `
|
|
64
|
+
Use `Task` tool with `type: "Bash"` to spawn parallel agents:
|
|
65
65
|
|
|
66
66
|
```
|
|
67
|
-
Task 1:
|
|
68
|
-
Task 2:
|
|
69
|
-
Task 3:
|
|
67
|
+
Task 1: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt1]'"
|
|
68
|
+
Task 2: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt2]'"
|
|
69
|
+
Task 3: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt3]'"
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
Spawn all in single message for parallel execution.
|
|
@@ -112,15 +112,15 @@ lines_per_chunk = ceil(total_lines / chunks)
|
|
|
112
112
|
|
|
113
113
|
**Small files (<500 lines each):**
|
|
114
114
|
```
|
|
115
|
-
Task 1:
|
|
116
|
-
Task 2:
|
|
115
|
+
Task 1: type="Bash", prompt="cat file1.ts file2.ts"
|
|
116
|
+
Task 2: type="Bash", prompt="cat file3.ts file4.ts"
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
**Large file (>500 lines) - use sed for ranges:**
|
|
120
120
|
```
|
|
121
|
-
Task 1:
|
|
122
|
-
Task 2:
|
|
123
|
-
Task 3:
|
|
121
|
+
Task 1: type="Bash", prompt="sed -n '1,500p' large-file.ts"
|
|
122
|
+
Task 2: type="Bash", prompt="sed -n '501,1000p' large-file.ts"
|
|
123
|
+
Task 3: type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
|
|
124
124
|
```
|
|
125
125
|
|
|
126
126
|
### Chunking Decision Tree
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# Internal Scouting with Explore
|
|
1
|
+
# Internal Scouting with Explore Agents
|
|
2
2
|
|
|
3
|
-
Use Explore
|
|
3
|
+
Use Explore agents when SCALE >= 6 or external tools unavailable.
|
|
4
4
|
|
|
5
5
|
## How It Works
|
|
6
6
|
|
|
7
|
-
Spawn multiple `Explore`
|
|
7
|
+
Spawn multiple `Explore` agents via `Task` tool to search codebase in parallel.
|
|
8
8
|
|
|
9
9
|
## Task Tool Configuration
|
|
10
10
|
|
|
11
11
|
```
|
|
12
|
-
|
|
12
|
+
type: "Explore"
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Prompt Template
|
|
@@ -90,15 +90,15 @@ lines_per_chunk = ceil(total_lines / chunks)
|
|
|
90
90
|
|
|
91
91
|
**Small files (<500 lines each):**
|
|
92
92
|
```
|
|
93
|
-
Task 1:
|
|
94
|
-
Task 2:
|
|
93
|
+
Task 1: type="Bash", prompt="cat file1.ts file2.ts"
|
|
94
|
+
Task 2: type="Bash", prompt="cat file3.ts file4.ts"
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
**Large file (>500 lines) - use sed for ranges:**
|
|
98
98
|
```
|
|
99
|
-
Task 1:
|
|
100
|
-
Task 2:
|
|
101
|
-
Task 3:
|
|
99
|
+
Task 1: type="Bash", prompt="sed -n '1,500p' large-file.ts"
|
|
100
|
+
Task 2: type="Bash", prompt="sed -n '501,1000p' large-file.ts"
|
|
101
|
+
Task 3: type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
### Chunking Decision Tree
|
|
@@ -4,7 +4,7 @@ Structured, reflective problem-solving methodology converted from the sequential
|
|
|
4
4
|
|
|
5
5
|
## Overview
|
|
6
6
|
|
|
7
|
-
This skill teaches
|
|
7
|
+
This skill teaches the AI agent to apply systematic sequential thinking methodology for complex problem-solving, without relying on external MCP tools. It enables:
|
|
8
8
|
- Breaking down complex problems into manageable thought sequences
|
|
9
9
|
- Dynamic adjustment of thought count as understanding evolves
|
|
10
10
|
- Revision of previous thoughts when new insights emerge
|
|
@@ -91,7 +91,7 @@ Thought 2/5: [Further analysis]
|
|
|
91
91
|
|
|
92
92
|
**Implicit Mode**: Apply methodology internally without cluttering output
|
|
93
93
|
|
|
94
|
-
## When
|
|
94
|
+
## When the Agent Should Use This Skill
|
|
95
95
|
|
|
96
96
|
Automatically activated for:
|
|
97
97
|
- Complex problem decomposition
|
|
@@ -176,7 +176,7 @@ Scripts are **optional tooling** - the methodology can be applied without them.
|
|
|
176
176
|
|
|
177
177
|
Converted from: https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking
|
|
178
178
|
|
|
179
|
-
Original MCP server
|
|
179
|
+
Original MCP server (MIT License).
|
|
180
180
|
Skill conversion:
|
|
181
181
|
- Extracts methodology as instructions
|
|
182
182
|
- Adds executable scripts for deterministic validation
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sequential-thinking
|
|
3
3
|
description: Apply step-by-step analysis for complex problems with revision capability. Use for multi-step reasoning, hypothesis verification, adaptive planning, problem decomposition, course correction.
|
|
4
|
-
version: 1.0.0
|
|
5
|
-
license: MIT
|
|
6
4
|
---
|
|
7
5
|
|
|
8
6
|
# Sequential Thinking
|
|
@@ -1,8 +1,6 @@
|
|
|
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
|
-
version: 1.0.0
|
|
6
4
|
---
|
|
7
5
|
|
|
8
6
|
# UI Styling Skill
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: web-testing
|
|
3
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
|
-
version: 3.0.0
|
|
6
4
|
---
|
|
7
5
|
|
|
8
6
|
# Web Testing Skill
|
|
@@ -37,7 +37,7 @@ You operate by the holy trinity of software engineering: **YAGNI** (You Aren't G
|
|
|
37
37
|
## Collaboration Tools
|
|
38
38
|
- Consult the `planner` agent to research industry best practices and find proven solutions
|
|
39
39
|
- Engage the `docs-manager` agent to understand existing project implementation and constraints
|
|
40
|
-
-
|
|
40
|
+
- Search the web to find efficient approaches and learn from others' experiences
|
|
41
41
|
|
|
42
42
|
## Workflow Phases
|
|
43
43
|
1. **Discovery Phase**: Ask clarifying questions about requirements, constraints, timeline, and success criteria
|
|
@@ -37,7 +37,7 @@ When investigating issues, you will:
|
|
|
37
37
|
- Examine application logs and error traces
|
|
38
38
|
- Capture system metrics and performance data
|
|
39
39
|
- Read `./docs/codebase-summary.md` if exists and up-to-date (less than 2 days old)
|
|
40
|
-
-
|
|
40
|
+
- Search the codebase for files needed to complete the task
|
|
41
41
|
- When given a Github repository URL, use `repomix --remote <github-repo-url>` to generate codebase summary:
|
|
42
42
|
```bash
|
|
43
43
|
# usage: repomix --remote <github-repo-url>
|
|
@@ -21,7 +21,7 @@ You establish and maintain implementation standards including:
|
|
|
21
21
|
|
|
22
22
|
### 2. Documentation Analysis & Maintenance
|
|
23
23
|
You systematically:
|
|
24
|
-
- Read and analyze all existing documentation files in `./docs` directory
|
|
24
|
+
- Read and analyze all existing documentation files in `./docs` directory
|
|
25
25
|
- Identify gaps, inconsistencies, or outdated information
|
|
26
26
|
- Cross-reference documentation with actual codebase implementation
|
|
27
27
|
- Ensure documentation reflects the current state of the system
|
|
@@ -57,7 +57,7 @@ You organize documentation to:
|
|
|
57
57
|
### Documentation Review Process
|
|
58
58
|
1. Scan the entire `./docs` directory structure
|
|
59
59
|
2. Generate/update `./docs/codebase-summary.md` with comprehensive codebase summary
|
|
60
|
-
3.
|
|
60
|
+
3. Search for content in files OR use Gemini CLI for large files
|
|
61
61
|
4. Categorize documentation by type (API, guides, requirements, architecture)
|
|
62
62
|
5. Check for completeness, accuracy, and clarity
|
|
63
63
|
6. Verify all links, references, and code examples
|
|
@@ -296,10 +296,10 @@ Keep output concise (<1k chars). No explanations of what you did.
|
|
|
296
296
|
## Token Optimization Strategy
|
|
297
297
|
|
|
298
298
|
**Delegation rationale:**
|
|
299
|
-
- Gemini Flash 2.5: $0.075/$0.30 per 1M tokens
|
|
300
|
-
-
|
|
301
|
-
- For 100-line diffs,
|
|
302
|
-
-
|
|
299
|
+
- Worker model (e.g. Gemini Flash 2.5): $0.075/$0.30 per 1M tokens
|
|
300
|
+
- Orchestrator model: $1/$5 per 1M tokens
|
|
301
|
+
- For 100-line diffs, worker model = **13x cheaper** for analysis
|
|
302
|
+
- Orchestrator focuses on routing, worker model does heavy lifting
|
|
303
303
|
|
|
304
304
|
**Efficiency rules:**
|
|
305
305
|
1. **Compound commands only** - use `&&` to chain operations
|
|
@@ -314,7 +314,7 @@ Keep output concise (<1k chars). No explanations of what you did.
|
|
|
314
314
|
- 3 tools @ 5K tokens = $0.015 per commit
|
|
315
315
|
- **81% cost reduction** × 1000 commits/month = $63 saved
|
|
316
316
|
|
|
317
|
-
## Critical Instructions for
|
|
317
|
+
## Critical Instructions for Orchestrator
|
|
318
318
|
|
|
319
319
|
Your role: **EXECUTE, not EXPLORE**
|
|
320
320
|
|
|
@@ -19,9 +19,9 @@ You operate by **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, S
|
|
|
19
19
|
|
|
20
20
|
When Read fails with "exceeds maximum allowed tokens":
|
|
21
21
|
1. **Gemini CLI** (2M context): `echo "[question] in [path]" | gemini -y -m gemini-2.5-flash`
|
|
22
|
-
2.
|
|
23
|
-
3.
|
|
24
|
-
4.
|
|
22
|
+
2. Read file in portions using offset and limit parameters
|
|
23
|
+
3. Search for specific content in files
|
|
24
|
+
4. Search for specific file and content patterns
|
|
25
25
|
|
|
26
26
|
## Core Mental Models (The "How to Think" Toolkit)
|
|
27
27
|
|
|
@@ -24,7 +24,6 @@ You excel at:
|
|
|
24
24
|
- Recognizing technology trends and adoption patterns
|
|
25
25
|
- Evaluating trade-offs between different technical solutions
|
|
26
26
|
- Using `docs-seeker` skills to find relevant documentation
|
|
27
|
-
- Using `document-skills` skills to read and analyze documents
|
|
28
27
|
**IMPORTANT**: You **DO NOT** start the implementation yourself but respond with the summary and the file path of comprehensive plan.
|
|
29
28
|
|
|
30
29
|
## Report Output
|
|
@@ -9,7 +9,7 @@ You are an elite Codebase Scout, a specialized agent designed to rapidly locate
|
|
|
9
9
|
|
|
10
10
|
## Your Core Mission
|
|
11
11
|
|
|
12
|
-
When given a search task, you will use
|
|
12
|
+
When given a search task, you will use search and file reading capabilities to efficiently search the codebase and synthesize findings into a comprehensive file list for the user.
|
|
13
13
|
Requirements: **Ensure token efficiency while maintaining high quality.**
|
|
14
14
|
|
|
15
15
|
## Operational Protocol
|
|
@@ -38,8 +38,8 @@ Example prompt structure:
|
|
|
38
38
|
"Search the [directories] for files related to [functionality]. Look for [specific patterns like API routes, schema definitions, utility functions]. Return only the file paths that are directly relevant. Be concise and fast - you have 3 minutes."
|
|
39
39
|
|
|
40
40
|
### 4. Execute Parallel Searches
|
|
41
|
-
-
|
|
42
|
-
-
|
|
41
|
+
- Search with multiple file patterns
|
|
42
|
+
- Search file contents for specific patterns
|
|
43
43
|
- Read key files to understand structure
|
|
44
44
|
- Complete searches within 3-minute target
|
|
45
45
|
|
|
@@ -50,7 +50,7 @@ Example prompt structure:
|
|
|
50
50
|
|
|
51
51
|
## Search Tools
|
|
52
52
|
|
|
53
|
-
Use
|
|
53
|
+
Use search and file reading for efficient codebase exploration.
|
|
54
54
|
|
|
55
55
|
## Example Execution Flow
|
|
56
56
|
|
|
@@ -79,19 +79,19 @@ Use Glob, Grep, and Read tools for efficient codebase exploration.
|
|
|
79
79
|
|
|
80
80
|
- If results are sparse: Expand search scope or try different keywords
|
|
81
81
|
- If results are overwhelming: Categorize and prioritize by relevance
|
|
82
|
-
- If Read fails on large files: Use chunked reading or
|
|
82
|
+
- If Read fails on large files: Use chunked reading or content search for specific content
|
|
83
83
|
|
|
84
84
|
## Handling Large Files (>25K tokens)
|
|
85
85
|
|
|
86
86
|
When Read fails with "exceeds maximum allowed tokens":
|
|
87
87
|
1. **Gemini CLI** (2M context): `echo "[question] in [path]" | gemini -y -m gemini-2.5-flash`
|
|
88
|
-
2.
|
|
89
|
-
3.
|
|
88
|
+
2. Read file in portions using offset and limit parameters
|
|
89
|
+
3. Search for specific content in files
|
|
90
90
|
|
|
91
91
|
## Success Criteria
|
|
92
92
|
|
|
93
93
|
You succeed when:
|
|
94
|
-
1. You execute searches efficiently using
|
|
94
|
+
1. You execute searches efficiently using search and file reading capabilities
|
|
95
95
|
2. You synthesize results into a clear, actionable file list
|
|
96
96
|
3. The user can immediately proceed with their task using the files you found
|
|
97
97
|
4. You complete the entire operation in under 5 minutes
|
|
@@ -104,4 +104,4 @@ Save reports to `plans/reports/` directory with naming pattern `{type}-{date}-{s
|
|
|
104
104
|
- Sacrifice grammar for the sake of concision when writing reports.
|
|
105
105
|
- In reports, list any unresolved questions at the end, if any.
|
|
106
106
|
|
|
107
|
-
**Remember:** You are a fast, focused searcher. Your power lies in efficiently
|
|
107
|
+
**Remember:** You are a fast, focused searcher. Your power lies in efficiently searching and reading files to quickly locate relevant content.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
id: ck-orchestration
|
|
2
2
|
name: CK Orchestration Protocol
|
|
3
|
-
description: Workflow orchestration patterns for managing
|
|
4
|
-
tags: [orchestration, workflow,
|
|
3
|
+
description: Workflow orchestration patterns for managing agents, task delegation, and multi-phase implementations.
|
|
4
|
+
tags: [orchestration, workflow, agents, planning]
|
|
5
5
|
items:
|
|
6
6
|
- path: agents/planner.agent.md
|
|
7
7
|
kind: agent
|
|
@@ -62,5 +62,6 @@ This command focuses on architectural consultation and strategic guidance. Do no
|
|
|
62
62
|
|
|
63
63
|
| Command | Description |
|
|
64
64
|
|---------|-------------|
|
|
65
|
-
| `/ck
|
|
66
|
-
| `/ck
|
|
65
|
+
| `/ck-brainstorm` | Explore ideas |
|
|
66
|
+
| `/ck-plan` | Create plan |
|
|
67
|
+
| `/ck-spec-specify` | Write detailed feature spec |
|