@devobsessed/code-captain 0.0.5 → 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.
Files changed (34) hide show
  1. package/README.md +1 -10
  2. package/bin/install.js +186 -187
  3. package/claude-code/agents/code-captain.md +17 -20
  4. package/copilot/README.md +26 -16
  5. package/copilot/chatmodes/Code Captain.chatmode.md +11 -16
  6. package/copilot/prompts/create-spec.prompt.md +5 -8
  7. package/copilot/prompts/explain-code.prompt.md +5 -8
  8. package/copilot/prompts/new-command.prompt.md +60 -21
  9. package/copilot/prompts/research.prompt.md +5 -8
  10. package/copilot/prompts/status.prompt.md +13 -2
  11. package/copilot/prompts/swab.prompt.md +1 -0
  12. package/cursor/README.md +8 -23
  13. package/cursor/cc.md +2 -29
  14. package/cursor/cc.mdc +3 -10
  15. package/cursor/commands/create-adr.md +1 -1
  16. package/cursor/commands/create-spec.md +9 -12
  17. package/cursor/commands/explain-code.md +5 -8
  18. package/cursor/commands/initialize.md +1 -1
  19. package/cursor/commands/new-command.md +5 -4
  20. package/cursor/commands/research.md +6 -9
  21. package/cursor/commands/status.md +13 -2
  22. package/cursor/commands/swab.md +61 -2
  23. package/manifest.json +150 -166
  24. package/package.json +12 -2
  25. package/windsurf/workflows/explain-code.md +4 -8
  26. package/windsurf/workflows/plan-product.md +330 -0
  27. package/windsurf/workflows/research.md +240 -0
  28. package/windsurf/workflows/swab.md +212 -0
  29. package/cursor/integrations/azure-devops/create-azure-work-items.md +0 -403
  30. package/cursor/integrations/azure-devops/sync-azure-work-items.md +0 -486
  31. package/cursor/integrations/github/create-github-issues.md +0 -765
  32. package/cursor/integrations/github/scripts/create-issues-batch.sh +0 -272
  33. package/cursor/integrations/github/sync-github-issues.md +0 -237
  34. 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 Commands & Capabilities
21
+ ## Core Capabilities
22
22
 
23
- ### 🚀 Project Setup
24
- - **`initialize`** - Analyze if this is a greenfield (new) or brownfield (existing) project and set up technical foundation
25
- - **`new-command "name" "description"`** - Create new Code Captain commands following established patterns
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
- ### 📋 Analysis & Requirements
28
- - **`plan-product "product idea"`** - Transform rough product ideas into comprehensive product plans
29
- - **`create-spec "feature description"`** - Create comprehensive feature specifications with technical details
30
- - **`create-adr "architectural decision"`** - Create Architecture Decision Records with systematic research
31
- - **`research "topic"`** - Conduct systematic 4-phase research using web search
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
- ### ⚙️ Implementation
34
- - **`execute-task`** - Systematically execute tasks using Test-Driven Development (TDD) workflow
35
- - **`swab`** - Make small, focused improvements following the "Boy Scout Rule"
36
- - **`status`** - Provide comprehensive status reports analyzing current state and next actions
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
- - **Platform integration** leveraging GitHub, Supabase, and other connected services
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
- - **Platform integration and workflow optimization**
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
- ### 📋 Project Setup & Analysis
68
- - **Initialize Project** - Analyze codebase and generate documentation
69
- - **Product Planning** - Comprehensive product strategy and roadmap
70
- - **Technical Research** - Systematic 4-phase research methodology
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-Driven Development** - Systematic TDD workflow
81
- - **Project Status** - Comprehensive status analysis
82
- - **Code Cleanup** - Small improvements following Boy Scout Rule
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
- ### GitHub Integration
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. **GitHub Integration** - Enhance repository templates
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
- ## Core Commands
30
-
31
- - `/initialize` - Project technical foundation setup and analysis (recommends plan-product for product strategy)
32
- - `/new-command "name" "description"` - Meta command to create new Code Captain commands
33
- - `/plan-product "idea"` - Product strategy and vision through structured discovery
34
- - `/create-spec "feature"` - Feature specifications with implementation roadmaps
35
-
36
- - `/create-adr "decision"` - Architecture Decision Records (auto-executes research)
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 report with git state, active work, and suggested actions
40
- - `/swab` - Code cleanup: one small improvement following Boy Scout Rule
38
+ - `/status` - Comprehensive project status analysis
39
+ - `/swab` - Code cleanup following Boy Scout Rule
41
40
 
42
- ## GitHub Integration
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. **CREATE** directory if not exists: `.code-captain/specs/`
123
- 2. **CREATE** temporary file: `.code-captain/specs/.date-check`
124
- 3. **READ** file creation timestamp from filesystem
125
- 4. **EXTRACT** date in YYYY-MM-DD format
126
- 5. **DELETE** temporary file
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: File System Timestamp
140
+ ### Primary Method: System Clock
141
141
 
142
- 1. **CREATE** directory if not exists: `.code-captain/explanations/`
143
- 2. **CREATE** temporary file: `.code-captain/explanations/.date-check`
144
- 3. **READ** file creation timestamp from filesystem
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 file system method fails:
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 [Setup/Analysis/Implementation/Integration] command?"
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
- **Setup/Analysis Commands:**
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
- - File generation workflows
94
- - Progress tracking workflows
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
- - Verification procedures
109
+ - Task execution procedures
100
110
 
101
- **Integration Commands:**
102
- - Platform-specific API interactions
103
- - Sync and conflict resolution
104
- - Error handling patterns
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
- - Setup/Analysis commands: Include context scanning, file generation, progress tracking
183
- - Implementation commands: Include TDD workflows, code modification, verification
184
- - Integration commands: Include API interactions, sync, error handling
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. **Setup/Analysis** (`initialize`, `research`, `explain-code`)
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
- - Progress tracking emphasis
272
+ - Research and assessment emphasis
239
273
 
240
- 2. **Planning/Specification** (`create-spec`, `create-adr`, `plan-product`)
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
- 3. **Implementation** (`execute-task`, `swab`)
279
+ 4. **Implementation** (`execute-task`)
246
280
  - Code modification workflows
247
281
  - TDD patterns
248
- - Verification steps
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
- 4. **Integration** (`sync`, `create-github-issues`)
251
- - Platform API interactions
252
- - Sync and conflict handling
253
- - Status reporting
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: File System Timestamp
126
+ ### Primary Method: System Clock
127
127
 
128
- 1. **CREATE** directory if not exists: `.code-captain/research/`
129
- 2. **CREATE** temporary file: `.code-captain/research/.date-check`
130
- 3. **READ** file creation timestamp from filesystem
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 file system method fails:
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 `/create-github-issues`
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
- # Generate project management artifacts
154
- cc: create-github-issues .code-captain/specs/2024-12-28-user-profile/
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
- | `create-github-issues` | GitHub integration | Updates spec with issue numbers |
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
- ### GitHub Integration Issues
206
- **Problem**: GitHub commands fail
207
- **Solution**: Verify repository has GitHub remote and check network connectivity
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
- **GitHub Integration:**
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, including tasks.md files that feed into GitHub issues.
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
- - `generate-tasks` - LLM-powered task generation from specs
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 GitHub Workflow
41
+ ## Enhanced Core Workflow
47
42
 
48
- - `generate-tasks` / `create-github-issues` - Spec to GitHub issues workflow
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/status quo option
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