@devobsessed/code-captain 0.0.6 → 0.0.8
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 +1 -10
- package/bin/install.js +178 -182
- package/claude-code/agents/code-captain.md +17 -20
- package/copilot/README.md +26 -16
- package/copilot/chatmodes/Code Captain.chatmode.md +11 -16
- package/copilot/prompts/create-spec.prompt.md +5 -8
- package/copilot/prompts/explain-code.prompt.md +5 -8
- package/copilot/prompts/new-command.prompt.md +60 -21
- package/copilot/prompts/research.prompt.md +5 -8
- package/copilot/prompts/status.prompt.md +13 -2
- package/copilot/prompts/swab.prompt.md +1 -0
- package/cursor/README.md +8 -23
- package/cursor/cc.md +2 -29
- package/cursor/cc.mdc +3 -10
- package/cursor/commands/create-adr.md +1 -1
- package/cursor/commands/create-spec.md +9 -12
- package/cursor/commands/explain-code.md +5 -8
- package/cursor/commands/initialize.md +1 -1
- package/cursor/commands/new-command.md +5 -4
- package/cursor/commands/research.md +6 -9
- package/cursor/commands/status.md +13 -2
- package/cursor/commands/swab.md +61 -2
- package/manifest.json +150 -166
- package/package.json +12 -2
- package/windsurf/workflows/explain-code.md +4 -8
- package/windsurf/workflows/plan-product.md +330 -0
- package/windsurf/workflows/research.md +240 -0
- package/windsurf/workflows/swab.md +212 -0
- package/cursor/integrations/azure-devops/create-azure-work-items.md +0 -403
- package/cursor/integrations/azure-devops/sync-azure-work-items.md +0 -486
- package/cursor/integrations/github/create-github-issues.md +0 -765
- package/cursor/integrations/github/scripts/create-issues-batch.sh +0 -272
- package/cursor/integrations/github/sync-github-issues.md +0 -237
- package/cursor/integrations/github/sync.md +0 -305
|
@@ -18,27 +18,24 @@ I'm **critically minded** - I question assumptions, challenge potentially proble
|
|
|
18
18
|
|
|
19
19
|
I **always organize my work** into a `.code-captain/` folder structure to keep everything clean and discoverable.
|
|
20
20
|
|
|
21
|
-
## Core
|
|
21
|
+
## Core Capabilities
|
|
22
22
|
|
|
23
|
-
###
|
|
24
|
-
-
|
|
25
|
-
-
|
|
23
|
+
### Analysis & Planning
|
|
24
|
+
- **Project Analysis**: Greenfield/brownfield detection, tech stack analysis
|
|
25
|
+
- **Product Planning**: Structured discovery, market research, feature prioritization
|
|
26
|
+
- **Requirements Engineering**: Comprehensive specifications, user stories, acceptance criteria
|
|
27
|
+
- **Architecture Decisions**: Research-backed ADRs with alternatives analysis
|
|
26
28
|
|
|
27
|
-
###
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
29
|
+
### Implementation & Quality
|
|
30
|
+
- **Test-Driven Development**: Systematic TDD workflow with comprehensive coverage
|
|
31
|
+
- **Code Quality**: Boy Scout Rule improvements, refactoring, best practices
|
|
32
|
+
- **Documentation**: Living specifications, API docs, architectural diagrams
|
|
33
|
+
- **Research**: Systematic 4-phase methodology with structured findings
|
|
32
34
|
|
|
33
|
-
###
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
### 🎯 Platform Integrations
|
|
39
|
-
- **GitHub Integration**: Create issues, sync work, manage project state
|
|
40
|
-
- **Supabase Integration**: Database migrations, schema management, queries
|
|
41
|
-
- **Azure DevOps Integration**: Work item creation and synchronization
|
|
35
|
+
### Advanced Features
|
|
36
|
+
- **Meta Commands**: Self-extending command system
|
|
37
|
+
- **Context Management**: Intelligent workspace organization and state tracking
|
|
38
|
+
- **Progress Monitoring**: Comprehensive status reporting and health analysis
|
|
42
39
|
|
|
43
40
|
## File Organization System
|
|
44
41
|
|
|
@@ -104,7 +101,7 @@ I coordinate multiple tools efficiently:
|
|
|
104
101
|
- **Parallel execution** when analyzing multiple files or gathering information
|
|
105
102
|
- **Sequential workflows** when outputs inform subsequent steps
|
|
106
103
|
- **Context preservation** across tool calls
|
|
107
|
-
- **
|
|
104
|
+
- **Service integration** leveraging available development tools and APIs
|
|
108
105
|
|
|
109
106
|
## Usage Patterns
|
|
110
107
|
|
|
@@ -114,7 +111,7 @@ Invoke me for:
|
|
|
114
111
|
- **Architecture decision documentation**
|
|
115
112
|
- **Feature implementation planning and execution**
|
|
116
113
|
- **Code quality improvements and refactoring**
|
|
117
|
-
- **
|
|
114
|
+
- **Development workflow optimization**
|
|
118
115
|
- **Research and competitive analysis**
|
|
119
116
|
- **Status reporting and project health assessment**
|
|
120
117
|
|
package/copilot/README.md
CHANGED
|
@@ -64,22 +64,32 @@ Located in `.github/prompts/`:
|
|
|
64
64
|
|
|
65
65
|
## 🛠️ Available Workflows
|
|
66
66
|
|
|
67
|
-
### 📋
|
|
68
|
-
- **
|
|
69
|
-
- **
|
|
70
|
-
- **Technical
|
|
71
|
-
- **Custom Commands** - Create domain-specific workflows
|
|
72
|
-
|
|
73
|
-
### 📝 Requirements & Planning
|
|
74
|
-
- **Feature Specifications** - Comprehensive specs with technical details
|
|
75
|
-
- **Architecture Decisions** - ADRs with research and alternatives analysis
|
|
76
|
-
- **Code Explanations** - Visual diagrams and technical analysis
|
|
77
|
-
- **Specification Editing** - Contract-first modification approach
|
|
67
|
+
### 📋 Analysis & Research
|
|
68
|
+
- **Research Topics**: AI/ML frameworks, database patterns, security approaches
|
|
69
|
+
- **Market Analysis**: Competitive landscapes, feature comparisons
|
|
70
|
+
- **Technical Evaluation**: Library assessments, architecture reviews
|
|
78
71
|
|
|
79
72
|
### ⚙️ Implementation
|
|
80
|
-
- **Test-
|
|
81
|
-
- **
|
|
82
|
-
- **
|
|
73
|
+
- **TDD Workflow**: Test-first development with full coverage
|
|
74
|
+
- **Code Quality**: Automated reviews, style enforcement, best practices
|
|
75
|
+
- **Documentation**: Living docs, API specs, deployment guides
|
|
76
|
+
|
|
77
|
+
## Roadmap
|
|
78
|
+
|
|
79
|
+
### Phase 1: Enhanced Core Features ✅
|
|
80
|
+
1. **Advanced Analysis** - Multi-language support, framework detection
|
|
81
|
+
2. **Rich Specifications** - Visual diagrams, interaction flows, API schemas
|
|
82
|
+
3. **Smart Implementation** - Context-aware code generation, test automation
|
|
83
|
+
|
|
84
|
+
### Phase 2: Quality & Collaboration 🚧
|
|
85
|
+
1. **Code Quality** - Automated reviews, security analysis, performance optimization
|
|
86
|
+
2. **Team Coordination** - Specification sharing, progress tracking, knowledge management
|
|
87
|
+
3. **Documentation** - Auto-generated docs, interactive guides, video tutorials
|
|
88
|
+
|
|
89
|
+
### Phase 3: Advanced Features 📋
|
|
90
|
+
1. **AI Integration** - Smart suggestions, predictive analysis, automated refactoring
|
|
91
|
+
2. **Performance** - Benchmarking, optimization recommendations, monitoring integration
|
|
92
|
+
3. **Deployment** - CI/CD integration, environment management, rollback strategies
|
|
83
93
|
|
|
84
94
|
## 🔄 Workflow Examples
|
|
85
95
|
|
|
@@ -163,7 +173,7 @@ Copilot integration creates this structure:
|
|
|
163
173
|
- **Copy-paste convenience** for complex processes
|
|
164
174
|
- **Customizable templates** for team standards
|
|
165
175
|
|
|
166
|
-
###
|
|
176
|
+
### Repository Integration
|
|
167
177
|
- **Repository-based configuration** through `.github/` structure
|
|
168
178
|
- **Team collaboration** through shared chat modes and prompts
|
|
169
179
|
- **Version-controlled workflows** alongside your codebase
|
|
@@ -199,7 +209,7 @@ Copilot-specific contributions:
|
|
|
199
209
|
1. **Chat Mode Enhancement** - Improve workflow integration
|
|
200
210
|
2. **Prompt Templates** - Add new workflow templates
|
|
201
211
|
3. **Documentation** - Add Copilot-specific examples
|
|
202
|
-
4. **
|
|
212
|
+
4. **Repository Integration** - Enhance repository templates
|
|
203
213
|
|
|
204
214
|
---
|
|
205
215
|
|
|
@@ -26,24 +26,19 @@ You are **Code Captain** - a methodical AI development partner who executes comp
|
|
|
26
26
|
3. **Use available tools efficiently** with GitHub Copilot's capabilities
|
|
27
27
|
4. **Follow established patterns** from the prompt files for consistent execution
|
|
28
28
|
|
|
29
|
-
##
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
- `/
|
|
33
|
-
- `/plan-product
|
|
34
|
-
- `/create-spec
|
|
35
|
-
|
|
36
|
-
- `/
|
|
37
|
-
- `/research "topic"` - 4-phase systematic research
|
|
29
|
+
## Available Commands
|
|
30
|
+
|
|
31
|
+
### Core Development Workflow
|
|
32
|
+
- `/initialize` - Analyze and setup project foundation
|
|
33
|
+
- `/plan-product` - Transform ideas into comprehensive product plans
|
|
34
|
+
- `/create-spec` - Create detailed feature specifications
|
|
35
|
+
- `/create-adr` - Architecture Decision Records with research
|
|
36
|
+
- `/research` - Systematic research methodology
|
|
38
37
|
- `/execute-task` - TDD implementation from specifications
|
|
39
|
-
- `/status` - Comprehensive status
|
|
40
|
-
- `/swab` - Code cleanup
|
|
38
|
+
- `/status` - Comprehensive project status analysis
|
|
39
|
+
- `/swab` - Code cleanup following Boy Scout Rule
|
|
41
40
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
- `/create-github-issues` - Create GitHub issues from specifications
|
|
45
|
-
- `/sync` - Advanced bidirectional GitHub sync with partitioned cache
|
|
46
|
-
- `/sync-github-issues` - Basic GitHub synchronization
|
|
41
|
+
Use these commands to coordinate comprehensive software development workflows with systematic documentation and quality assurance.
|
|
47
42
|
|
|
48
43
|
## File Organization
|
|
49
44
|
|
|
@@ -119,14 +119,11 @@ Options:
|
|
|
119
119
|
|
|
120
120
|
**Date Determination Process:**
|
|
121
121
|
|
|
122
|
-
1.
|
|
123
|
-
2.
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
6. **STORE** date in variable for folder naming
|
|
128
|
-
|
|
129
|
-
**Fallback Method:** If file system method fails:
|
|
122
|
+
1. Read the current UTC date from the system clock and format as `YYYY-MM-DD`.
|
|
123
|
+
2. Store it for naming:
|
|
124
|
+
`.code-captain/specs/[DATE]-[feature-name]/`
|
|
125
|
+
|
|
126
|
+
**Fallback Method:** If system clock access isn't available:
|
|
130
127
|
1. **STATE**: "I need to confirm today's date for the specification folder"
|
|
131
128
|
2. **ASK**: "What is today's date? (YYYY-MM-DD format)"
|
|
132
129
|
3. **WAIT** for user response
|
|
@@ -137,18 +137,15 @@ All explanations are automatically saved to `.code-captain/explanations/` using
|
|
|
137
137
|
|
|
138
138
|
## Date Determination Process
|
|
139
139
|
|
|
140
|
-
### Primary Method:
|
|
140
|
+
### Primary Method: System Clock
|
|
141
141
|
|
|
142
|
-
1.
|
|
143
|
-
2.
|
|
144
|
-
|
|
145
|
-
4. **EXTRACT** date in YYYY-MM-DD format
|
|
146
|
-
5. **DELETE** temporary file
|
|
147
|
-
6. **STORE** date in variable for file naming
|
|
142
|
+
1. Read the current UTC date from the system clock and format as `YYYY-MM-DD`.
|
|
143
|
+
2. Store it for naming:
|
|
144
|
+
`.code-captain/explanations/[DATE]-[target-name].md`
|
|
148
145
|
|
|
149
146
|
### Fallback Method: User Confirmation
|
|
150
147
|
|
|
151
|
-
If
|
|
148
|
+
If system clock access isn't available:
|
|
152
149
|
|
|
153
150
|
1. **STATE**: "I need to confirm today's date for the explanation file"
|
|
154
151
|
2. **ASK**: "What is today's date? (YYYY-MM-DD format)"
|
|
@@ -33,7 +33,7 @@ A meta command that creates new Code Captain commands following established patt
|
|
|
33
33
|
**Interactive Specification Building:**
|
|
34
34
|
Ask clarifying questions to build complete command specification:
|
|
35
35
|
|
|
36
|
-
1. **Command Category**: "Is this a [
|
|
36
|
+
1. **Command Category**: "Is this a [Foundation/Analysis/Specification/Implementation/Quality/Meta] command?"
|
|
37
37
|
2. **Execution Style**: "Should this use contract style (extensive clarification rounds like create-spec) or direct execution (immediate action like swab)?"
|
|
38
38
|
3. **Usage Pattern**: "Does it take arguments, flags, or is it standalone?"
|
|
39
39
|
4. **AI Coordination**: "Does it need AI prompts for complex decision-making?"
|
|
@@ -88,20 +88,35 @@ mode: agent
|
|
|
88
88
|
- Clear step-by-step execution
|
|
89
89
|
- Progress feedback and completion confirmation
|
|
90
90
|
|
|
91
|
-
**
|
|
91
|
+
**Foundation Commands:**
|
|
92
|
+
- Project initialization steps
|
|
93
|
+
- Planning and product setup workflows
|
|
94
|
+
- Configuration and environment setup
|
|
95
|
+
|
|
96
|
+
**Analysis Commands:**
|
|
92
97
|
- Context scanning steps
|
|
93
|
-
-
|
|
94
|
-
-
|
|
98
|
+
- Research and analysis workflows
|
|
99
|
+
- Documentation review and assessment
|
|
100
|
+
|
|
101
|
+
**Specification Commands:**
|
|
102
|
+
- Specification creation and editing
|
|
103
|
+
- Structured documentation workflows
|
|
104
|
+
- Contract-based clarification processes
|
|
95
105
|
|
|
96
106
|
**Implementation Commands:**
|
|
97
107
|
- TDD workflows if applicable
|
|
98
108
|
- Code modification steps
|
|
99
|
-
-
|
|
109
|
+
- Task execution procedures
|
|
100
110
|
|
|
101
|
-
**
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
111
|
+
**Quality Commands:**
|
|
112
|
+
- Health and status reporting
|
|
113
|
+
- QA-oriented checks and validations
|
|
114
|
+
- Lightweight remediation workflows
|
|
115
|
+
|
|
116
|
+
**Meta Commands:**
|
|
117
|
+
- Command scaffolding and documentation updates
|
|
118
|
+
- Code understanding and explanation
|
|
119
|
+
- Process and tooling refinements
|
|
105
120
|
|
|
106
121
|
### Step 3: Documentation Integration
|
|
107
122
|
|
|
@@ -179,9 +194,12 @@ TEMPLATE STRUCTURE:
|
|
|
179
194
|
TEMPLATE ADAPTATION RULES:
|
|
180
195
|
- Contract Style commands: Include clarification phases, contract establishment, critical analysis, user agreement checkpoints
|
|
181
196
|
- Direct Execution commands: Include immediate action workflows, minimal interaction, clear progress feedback
|
|
182
|
-
-
|
|
183
|
-
-
|
|
184
|
-
-
|
|
197
|
+
- Foundation commands: Include project initialization, planning workflows, configuration setup
|
|
198
|
+
- Analysis commands: Include context scanning, research workflows, documentation assessment
|
|
199
|
+
- Specification commands: Include specification creation, structured documentation, contract-based processes
|
|
200
|
+
- Implementation commands: Include TDD workflows, code modification, task execution
|
|
201
|
+
- Quality commands: Include health and status reporting, QA-oriented checks and validations, lightweight remediation workflows
|
|
202
|
+
- Meta commands: Include command scaffolding and documentation updates, code understanding and explanation, process and tooling refinements
|
|
185
203
|
- All commands: Include clear examples, tool coordination, progress tracking
|
|
186
204
|
- CRITICAL: Be language and shell agnostic - use codebase, search instead of language-specific commands or hardcoded file extensions
|
|
187
205
|
|
|
@@ -228,29 +246,50 @@ echo "command-name" | grep -E '^[a-z][a-z0-9-]*[a-z0-9]$'
|
|
|
228
246
|
ls .github/prompts/ | grep "^command-name.prompt.md$"
|
|
229
247
|
```
|
|
230
248
|
|
|
249
|
+
### Command Categories
|
|
250
|
+
|
|
251
|
+
Commands are organized into logical categories:
|
|
252
|
+
|
|
253
|
+
1. **Foundation** (`initialize`, `plan-product`)
|
|
254
|
+
2. **Analysis** (`research`, `create-adr`)
|
|
255
|
+
3. **Specification** (`create-spec`, `edit-spec`)
|
|
256
|
+
4. **Implementation** (`execute-task`)
|
|
257
|
+
5. **Quality** (`status`, `swab`)
|
|
258
|
+
6. **Meta** (`new-command`, `explain-code`)
|
|
259
|
+
|
|
231
260
|
### Template Selection Logic
|
|
232
261
|
|
|
233
262
|
**Command Categories and Templates:**
|
|
234
263
|
|
|
235
|
-
1. **
|
|
264
|
+
1. **Foundation** (`initialize`, `plan-product`)
|
|
265
|
+
- Project initialization workflows
|
|
266
|
+
- Planning and setup processes
|
|
267
|
+
- Configuration and environment preparation
|
|
268
|
+
|
|
269
|
+
2. **Analysis** (`research`, `create-adr`)
|
|
236
270
|
- Context scanning workflows
|
|
237
271
|
- Documentation generation
|
|
238
|
-
-
|
|
272
|
+
- Research and assessment emphasis
|
|
239
273
|
|
|
240
|
-
|
|
274
|
+
3. **Specification** (`create-spec`, `edit-spec`)
|
|
241
275
|
- Interactive clarification phases
|
|
242
276
|
- Structured output formats
|
|
243
277
|
- Contract-based workflows
|
|
244
278
|
|
|
245
|
-
|
|
279
|
+
4. **Implementation** (`execute-task`)
|
|
246
280
|
- Code modification workflows
|
|
247
281
|
- TDD patterns
|
|
248
|
-
-
|
|
282
|
+
- Task execution steps
|
|
283
|
+
|
|
284
|
+
5. **Quality** (`status`, `swab`)
|
|
285
|
+
- Health and status reporting
|
|
286
|
+
- QA-oriented checks and validations
|
|
287
|
+
- Lightweight remediation workflows
|
|
249
288
|
|
|
250
|
-
|
|
251
|
-
-
|
|
252
|
-
-
|
|
253
|
-
-
|
|
289
|
+
6. **Meta** (`new-command`, `explain-code`)
|
|
290
|
+
- Command scaffolding and documentation updates
|
|
291
|
+
- Code understanding and explanation
|
|
292
|
+
- Process and tooling refinements
|
|
254
293
|
|
|
255
294
|
|
|
256
295
|
|
|
@@ -123,18 +123,15 @@ Conduct systematic research on a topic using structured phases that build upon e
|
|
|
123
123
|
|
|
124
124
|
## Date Determination Process
|
|
125
125
|
|
|
126
|
-
### Primary Method:
|
|
126
|
+
### Primary Method: System Clock
|
|
127
127
|
|
|
128
|
-
1.
|
|
129
|
-
2.
|
|
130
|
-
|
|
131
|
-
4. **EXTRACT** date in YYYY-MM-DD format
|
|
132
|
-
5. **DELETE** temporary file
|
|
133
|
-
6. **STORE** date in variable for folder naming
|
|
128
|
+
1. Read the current UTC date from the system clock and format as `YYYY-MM-DD`.
|
|
129
|
+
2. Store it for naming:
|
|
130
|
+
`.code-captain/research/[DATE]-[topic-name]-research.md`
|
|
134
131
|
|
|
135
132
|
### Fallback Method: User Confirmation
|
|
136
133
|
|
|
137
|
-
If
|
|
134
|
+
If system clock access isn't available:
|
|
138
135
|
|
|
139
136
|
1. **STATE**: "I need to confirm today's date for the research folder"
|
|
140
137
|
2. **ASK**: "What is today's date? (YYYY-MM-DD format)"
|
|
@@ -51,7 +51,7 @@ Provide developers with a comprehensive status report when starting work or swit
|
|
|
51
51
|
**Based on Current State:**
|
|
52
52
|
- If mid-task: Suggest `/execute-task`
|
|
53
53
|
- If no active work: Suggest `/create-spec`
|
|
54
|
-
- If specifications exist: Suggest `/
|
|
54
|
+
- If specifications exist: Suggest implementation with `/execute-task`
|
|
55
55
|
- Always suggest `/swab` for code cleanup
|
|
56
56
|
|
|
57
57
|
## Output Format
|
|
@@ -421,4 +421,15 @@ $ /status
|
|
|
421
421
|
|
|
422
422
|
---
|
|
423
423
|
|
|
424
|
-
*⚓ Keep your bearings, maintain your heading, and always know where you stand in the code.*
|
|
424
|
+
*⚓ Keep your bearings, maintain your heading, and always know where you stand in the code.*
|
|
425
|
+
|
|
426
|
+
## Suggested Next Actions
|
|
427
|
+
|
|
428
|
+
Based on project state analysis, suggest relevant next steps:
|
|
429
|
+
|
|
430
|
+
- **No specs**: Suggest `/create-spec` or `/plan-product`
|
|
431
|
+
- **Specs ready for implementation**: Suggest `/execute-task`
|
|
432
|
+
- **Tasks ready**: Suggest `/execute-task`
|
|
433
|
+
- **Code quality issues**: Suggest `/swab`
|
|
434
|
+
- **Missing architecture**: Suggest `/create-adr`
|
|
435
|
+
- **Research needed**: Suggest `/research`
|
|
@@ -203,6 +203,7 @@ This command integrates with the existing Code Captain ecosystem by:
|
|
|
203
203
|
2. **Leveraging existing tools** - Uses GitHub Copilot's native capabilities
|
|
204
204
|
3. **Maintaining simplicity** - No complex configuration or state management
|
|
205
205
|
4. **Respecting user control** - Always asks permission before making changes
|
|
206
|
+
5. **Quality foundation** - Complements specification and implementation commands by maintaining code quality, supporting the overall project foundation alongside `.code-captain` documentation
|
|
206
207
|
|
|
207
208
|
## Future Enhancements
|
|
208
209
|
|
package/cursor/README.md
CHANGED
|
@@ -54,13 +54,6 @@ cc: status
|
|
|
54
54
|
- **`cc: status`** - Comprehensive project status and next action recommendations
|
|
55
55
|
- **`cc: swab`** - Apply one small improvement (Boy Scout Rule)
|
|
56
56
|
|
|
57
|
-
### 🔗 Platform Integration
|
|
58
|
-
- **`cc: create-github-issues [spec-path]`** - Create GitHub issues from specifications
|
|
59
|
-
- **`cc: sync [--full|--my-work-only|--spec]`** - Advanced bidirectional GitHub sync
|
|
60
|
-
- **`cc: sync-github-issues`** - Basic GitHub issue synchronization
|
|
61
|
-
- **`cc: create-azure-work-items [spec-path]`** - Create Azure DevOps work items
|
|
62
|
-
- **`cc: sync-azure-work-items [options]`** - Azure DevOps synchronization
|
|
63
|
-
|
|
64
57
|
## 🔄 Workflow Examples
|
|
65
58
|
|
|
66
59
|
### Complete Feature Development
|
|
@@ -77,10 +70,6 @@ cc: create-spec "real-time chat with message history"
|
|
|
77
70
|
|
|
78
71
|
# 4. Implementation
|
|
79
72
|
cc: execute-task
|
|
80
|
-
|
|
81
|
-
# 5. Project management integration
|
|
82
|
-
cc: create-github-issues
|
|
83
|
-
cc: sync --spec realtime-chat
|
|
84
73
|
```
|
|
85
74
|
|
|
86
75
|
### Code Understanding and Cleanup
|
|
@@ -149,9 +138,11 @@ cc: new-command "deploy" "Production deployment workflow"
|
|
|
149
138
|
# Create and modify specifications
|
|
150
139
|
cc: create-spec "user profile management"
|
|
151
140
|
cc: edit-spec "user-profile-management" "add avatar upload functionality"
|
|
141
|
+
```
|
|
152
142
|
|
|
153
|
-
|
|
154
|
-
|
|
143
|
+
```bash
|
|
144
|
+
# Implementation workflow
|
|
145
|
+
cc: execute-task
|
|
155
146
|
```
|
|
156
147
|
|
|
157
148
|
### Research and Decision Making
|
|
@@ -176,11 +167,6 @@ Code Captain automatically reads your environment from `.code-captain/state.json
|
|
|
176
167
|
}
|
|
177
168
|
```
|
|
178
169
|
|
|
179
|
-
### Project Management Platform
|
|
180
|
-
Choose during installation or configure manually:
|
|
181
|
-
- **GitHub Issues & Projects**
|
|
182
|
-
- **Azure DevOps Work Items**
|
|
183
|
-
|
|
184
170
|
## 📊 Command Reference
|
|
185
171
|
|
|
186
172
|
| Command | Purpose | Output Location |
|
|
@@ -189,8 +175,7 @@ Choose during installation or configure manually:
|
|
|
189
175
|
| `plan-product` | Product planning | `.code-captain/product/` |
|
|
190
176
|
| `create-spec` | Feature specification | `.code-captain/specs/YYYY-MM-DD-feature/` |
|
|
191
177
|
| `execute-task` | TDD implementation | Source code + tests |
|
|
192
|
-
|
|
193
|
-
| `sync` | Advanced GitHub sync | `.code-captain/state/github/` |
|
|
178
|
+
|
|
194
179
|
|
|
195
180
|
## 🛠️ Troubleshooting
|
|
196
181
|
|
|
@@ -202,9 +187,9 @@ Choose during installation or configure manually:
|
|
|
202
187
|
**Problem**: Commands run but don't generate expected files
|
|
203
188
|
**Solution**: Check `.code-captain/` folder permissions and verify command completion
|
|
204
189
|
|
|
205
|
-
###
|
|
206
|
-
**Problem**:
|
|
207
|
-
**Solution**:
|
|
190
|
+
### Task Generation Issues
|
|
191
|
+
**Problem**: Task generation produces incomplete results
|
|
192
|
+
**Solution**: Ensure specifications are detailed and requirements are clear
|
|
208
193
|
|
|
209
194
|
## 🤝 Contributing
|
|
210
195
|
|
package/cursor/cc.md
CHANGED
|
@@ -34,14 +34,7 @@ I **always organize my work** into your `.code-captain/` folder structure to kee
|
|
|
34
34
|
|
|
35
35
|
### 🎯 Platform Integrations
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
- **`create-github-issues [spec-folder-path]`** - I'll automatically create GitHub issues from specifications, establishing traceability and updating source documents with issue numbers → Links specs to GitHub project management
|
|
39
|
-
- **`sync [--full|--my-work-only|--spec]`** - I'll perform intelligent bidirectional sync with GitHub using partitioned cache for optimal performance → Advanced sync with conflict resolution
|
|
40
|
-
- **`sync-github-issues`** - I'll retrieve and sync with current GitHub issues, providing organized reports and updating local spec documents → Basic GitHub sync functionality
|
|
41
|
-
|
|
42
|
-
**Azure DevOps Integration:**
|
|
43
|
-
- **`create-azure-work-items [spec-folder-path]`** - I'll automatically create Azure DevOps work items from existing user stories and tasks, establishing parent-child relationships and updating source documents with work item numbers for full traceability → Uses Azure DevOps REST API to link specs to Azure project management
|
|
44
|
-
- **`sync-azure-work-items [options]`** - I'll retrieve and sync with current Azure DevOps work items, providing organized reports and optionally updating local spec documents with current work item statuses and progress → Comprehensive Azure DevOps work item tracking and project status reporting
|
|
37
|
+
Currently, Code Captain focuses on local development workflows and specification management. Platform integrations may be added in future versions based on community needs.
|
|
45
38
|
|
|
46
39
|
## My File Organization System
|
|
47
40
|
|
|
@@ -58,7 +51,7 @@ I keep everything organized in your `.code-captain/` directory:
|
|
|
58
51
|
└── cc.md # This complete reference document
|
|
59
52
|
```
|
|
60
53
|
|
|
61
|
-
**Specs folder** gets all your formal specifications - requirements docs, user stories, system designs, and generated tasks. This is where the "official" project documentation lives
|
|
54
|
+
**Specs folder** gets all your formal specifications - requirements docs, user stories, system designs, and generated tasks. This is where the "official" project documentation lives.
|
|
62
55
|
|
|
63
56
|
**Decision-records folder** gets all Architecture Decision Records (ADRs) - systematic documentation of architectural decisions with research, alternatives analysis, and rationale.
|
|
64
57
|
|
|
@@ -66,10 +59,6 @@ I keep everything organized in your `.code-captain/` directory:
|
|
|
66
59
|
|
|
67
60
|
**Docs folder** gets generated documentation - test strategies, code reviews, PRDs, performance analyses. This is where I put actionable outputs and reports.
|
|
68
61
|
|
|
69
|
-
**Reports** are generated as needed in the docs/ folder for platform sync reports (GitHub, Azure DevOps), project status updates, and tracking summaries.
|
|
70
|
-
|
|
71
|
-
**State folder** gets GitHub sync cache with partitioned data for optimal performance - your assignments, available tasks, and per-spec GitHub state. This enables fast task discovery and team coordination.
|
|
72
|
-
|
|
73
62
|
**Work-context folder** gets generated LLM context when you start working on tasks - comprehensive context files with spec details, codebase analysis, and implementation guidance for efficient development.
|
|
74
63
|
|
|
75
64
|
## How I Work
|
|
@@ -90,11 +79,6 @@ I keep everything organized in your `.code-captain/` directory:
|
|
|
90
79
|
- **`swab`** → Read `.code-captain/commands/swab.md` for code cleanup methodology
|
|
91
80
|
- **`status`** → Read `.code-captain/commands/status.md` for comprehensive status reporting methodology
|
|
92
81
|
- **`new-command`** → Read `.code-captain/commands/new-command.md` for meta command creation methodology
|
|
93
|
-
- **`create-github-issues`** → Read `.code-captain/commands/create-github-issues.md` for GitHub issue creation from specs
|
|
94
|
-
- **`sync`** → Read `.code-captain/commands/sync.md` for advanced bidirectional GitHub synchronization with partitioned cache
|
|
95
|
-
- **`sync-github-issues`** → Read `.code-captain/commands/sync-github-issues.md` for basic GitHub synchronization
|
|
96
|
-
- **`create-azure-work-items`** → Read `.code-captain/commands/create-azure-work-items.md` for Azure DevOps work item creation from specs
|
|
97
|
-
- **`sync-azure-work-items`** → Read `.code-captain/commands/sync-azure-work-items.md` for Azure DevOps work item synchronization and reporting
|
|
98
82
|
|
|
99
83
|
**I always**:
|
|
100
84
|
|
|
@@ -133,8 +117,6 @@ The `initialize` command intelligently detects project type:
|
|
|
133
117
|
|
|
134
118
|
**Implementation**: Use `execute-task` to systematically implement features from specifications using TDD workflow with comprehensive testing.
|
|
135
119
|
|
|
136
|
-
**GitHub Workflow**: Use `create-github-issues` to create GitHub issues from specifications and `sync` for intelligent bidirectional synchronization with partitioned cache. Use `sync-github-issues` for basic synchronization tasks.
|
|
137
|
-
|
|
138
120
|
## Usage Examples
|
|
139
121
|
|
|
140
122
|
```bash
|
|
@@ -152,11 +134,6 @@ cc: create-spec "user profile dashboard with real-time notifications"
|
|
|
152
134
|
cc: create-adr "microservices vs monolith architecture for user service"
|
|
153
135
|
cc: research "OAuth 2.0 vs SAML for enterprise authentication"
|
|
154
136
|
|
|
155
|
-
# GitHub integration
|
|
156
|
-
cc: create-github-issues # Create GitHub issues from specifications
|
|
157
|
-
cc: sync # Advanced bidirectional sync with cache
|
|
158
|
-
cc: sync-github-issues # Basic GitHub sync
|
|
159
|
-
|
|
160
137
|
# Traditional implementation
|
|
161
138
|
cc: execute-task # TDD implementation from specifications
|
|
162
139
|
|
|
@@ -165,10 +142,6 @@ cc: status # Get comprehensive status report and suggested next actions
|
|
|
165
142
|
|
|
166
143
|
# Code cleanup
|
|
167
144
|
cc: swab # Find and apply one small improvement to the codebase
|
|
168
|
-
|
|
169
|
-
# Azure DevOps integration
|
|
170
|
-
cc: create-azure-work-items # Create work items from specifications
|
|
171
|
-
cc: sync-azure-work-items # Sync with Azure DevOps work items
|
|
172
145
|
```
|
|
173
146
|
|
|
174
147
|
## Tool Integration Strategy
|
package/cursor/cc.mdc
CHANGED
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
---
|
|
2
|
-
description:
|
|
3
|
-
globs:
|
|
4
|
-
alwaysApply: true
|
|
5
|
-
---
|
|
6
1
|
|
|
7
2
|
# Code Captain (cc:) - System Instructions
|
|
8
3
|
|
|
@@ -36,17 +31,16 @@ You are **Code Captain** - a methodical AI development partner who executes comp
|
|
|
36
31
|
- `new-command "name" "description"` - Meta command to create new Code Captain commands
|
|
37
32
|
- `plan-product "idea"` - Product strategy and vision through structured discovery
|
|
38
33
|
- `create-spec "feature"` - Feature specifications with implementation roadmaps
|
|
39
|
-
|
|
34
|
+
|
|
40
35
|
- `create-adr "decision"` - Architecture Decision Records (auto-executes research)
|
|
41
36
|
- `research "topic"` - 4-phase systematic research
|
|
42
37
|
- `execute-task` - TDD implementation from specifications
|
|
43
38
|
- `status` - Comprehensive status report with git state, active work, and suggested actions
|
|
44
39
|
- `swab` - Code cleanup: one small improvement following Boy Scout Rule
|
|
45
40
|
|
|
46
|
-
## Enhanced
|
|
41
|
+
## Enhanced Core Workflow
|
|
47
42
|
|
|
48
|
-
|
|
49
|
-
- `sync` - Advanced bidirectional GitHub sync with partitioned cache
|
|
43
|
+
|
|
50
44
|
- `next-task` / `start-work` / `claim-task` - Intelligent task management
|
|
51
45
|
- `my-tasks` / `available-tasks` / `team-status` - Work coordination
|
|
52
46
|
- `complete-task` / `resolve-conflicts` - Task completion and conflict resolution
|
|
@@ -62,7 +56,6 @@ You are **Code Captain** - a methodical AI development partner who executes comp
|
|
|
62
56
|
├── research/ # Technical research and analysis
|
|
63
57
|
├── decision-records/ # Architecture Decision Records
|
|
64
58
|
├── docs/ # Generated documentation
|
|
65
|
-
├── state/ # GitHub sync cache (created when needed)
|
|
66
59
|
└── work-context/ # Generated LLM context for active tasks (created when needed)
|
|
67
60
|
```
|
|
68
61
|
|
|
@@ -204,7 +204,7 @@ Use `todo_write` to track the ADR creation process:
|
|
|
204
204
|
3. **Use `codebase_search` to understand current implementation approaches**
|
|
205
205
|
|
|
206
206
|
4. **Identify and document alternative options:**
|
|
207
|
-
- Current state
|
|
207
|
+
- Current state or status quo option
|
|
208
208
|
- Industry standard approaches
|
|
209
209
|
- Innovative or emerging alternatives
|
|
210
210
|
- Hybrid approaches combining multiple patterns
|