@devobsessed/code-captain 0.0.6 → 0.0.9

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 (44) hide show
  1. package/README.md +36 -37
  2. package/bin/install.js +1166 -983
  3. package/claude-code/agents/code-captain.md +31 -22
  4. package/copilot/README.md +26 -16
  5. package/copilot/chatmodes/Code Captain.chatmode.md +41 -25
  6. package/copilot/prompts/create-adr.prompt.md +6 -4
  7. package/copilot/prompts/create-spec.prompt.md +62 -45
  8. package/copilot/prompts/explain-code.prompt.md +7 -23
  9. package/copilot/prompts/new-command.prompt.md +60 -21
  10. package/copilot/prompts/research.prompt.md +14 -30
  11. package/copilot/prompts/status.prompt.md +13 -2
  12. package/copilot/prompts/swab.prompt.md +1 -0
  13. package/cursor/README.md +77 -88
  14. package/cursor/cc.mdc +13 -42
  15. package/cursor/commands/create-adr.md +7 -13
  16. package/cursor/commands/create-spec.md +73 -64
  17. package/cursor/commands/edit-spec.md +2 -15
  18. package/cursor/commands/execute-task.md +7 -15
  19. package/cursor/commands/explain-code.md +16 -35
  20. package/cursor/commands/initialize.md +19 -18
  21. package/cursor/commands/new-command.md +173 -81
  22. package/cursor/commands/plan-product.md +7 -13
  23. package/cursor/commands/research.md +5 -27
  24. package/cursor/commands/status.md +34 -23
  25. package/cursor/commands/swab.md +63 -12
  26. package/manifest.json +110 -229
  27. package/package.json +13 -4
  28. package/cursor/cc.md +0 -183
  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
  35. package/windsurf/README.md +0 -254
  36. package/windsurf/rules/cc.md +0 -5
  37. package/windsurf/workflows/create-adr.md +0 -331
  38. package/windsurf/workflows/create-spec.md +0 -280
  39. package/windsurf/workflows/edit-spec.md +0 -273
  40. package/windsurf/workflows/execute-task.md +0 -276
  41. package/windsurf/workflows/explain-code.md +0 -292
  42. package/windsurf/workflows/initialize.md +0 -298
  43. package/windsurf/workflows/new-command.md +0 -321
  44. package/windsurf/workflows/status.md +0 -213
package/README.md CHANGED
@@ -10,7 +10,7 @@ Code Captain transforms how you work with AI development assistants by providing
10
10
 
11
11
  - **📋 Systematic Workflows** - Structured approaches to common development tasks
12
12
  - **🏗️ Complete Lifecycle Coverage** - From requirements to deployment
13
- - **🔍 Project Management Integration** - GitHub, Azure DevOps, and more
13
+ - **🔍 Documentation & Tracking** - Organized outputs and progress tracking
14
14
  - **📚 Organized Documentation** - Everything has its place and purpose
15
15
 
16
16
  Instead of ad-hoc AI prompting, Code Captain provides proven workflows for:
@@ -29,6 +29,7 @@ npx @devobsessed/code-captain
29
29
  ```
30
30
 
31
31
  The installer will:
32
+
32
33
  - 🔍 Auto-detect your development environment
33
34
  - 🎯 Install the appropriate Code Captain integration
34
35
  - 📦 Set up the complete workflow system
@@ -40,29 +41,28 @@ The installer will:
40
41
 
41
42
  Code Captain integrates with multiple AI-powered development environments. Choose your platform:
42
43
 
43
- ### [Cursor IDE](cursor/README.md)
44
- *AI-first development with built-in agent system*
44
+ ### [Cursor IDE](cursor/README.md)
45
+
46
+ _AI-first development with built-in agent system_
47
+
45
48
  - Native `.cursor/rules/` integration
46
49
  - Command recognition and auto-completion
47
50
  - Seamless workflow execution
48
51
  - **→ [Cursor Setup Guide](cursor/README.md)**
49
52
 
50
53
  ### [GitHub Copilot + VS Code](copilot/README.md)
51
- *Classic VS Code with Copilot Chat integration*
54
+
55
+ _Classic VS Code with Copilot Chat integration_
56
+
52
57
  - Custom chat modes and prompts
53
58
  - `.github/` repository integration
54
59
  - Team collaboration features
55
60
  - **→ [Copilot Setup Guide](copilot/README.md)**
56
61
 
57
- ### [Windsurf](windsurf/README.md)
58
- *Codeium's AI-powered development environment*
59
- - Custom workflow integration
60
- - Built-in AI coordination
61
- - Advanced context management
62
- - **→ [Windsurf Setup Guide](windsurf/README.md)**
63
-
64
62
  ### [Claude.dev](claude-code/README.md)
65
- *VS Code extension for Claude integration*
63
+
64
+ _VS Code extension for Claude integration_
65
+
66
66
  - Direct Claude API integration
67
67
  - Custom agent configurations
68
68
  - Flexible workflow execution
@@ -71,58 +71,54 @@ Code Captain integrates with multiple AI-powered development environments. Choos
71
71
  ## 🎮 Core Commands (All Platforms)
72
72
 
73
73
  ### 📋 Project Setup & Analysis
74
+
74
75
  - **`initialize`** - Analyze and set up project documentation
75
76
  - **`plan-product "idea"`** - Comprehensive product planning
76
77
  - **`research "topic"`** - Systematic technical research
77
78
  - **`new-command "name" "desc"`** - Extend Code Captain
78
79
 
79
80
  ### 📝 Requirements & Planning
81
+
80
82
  - **`create-spec "feature"`** - Feature specifications with technical details
81
83
  - **`edit-spec [id] "changes"`** - Modify existing specifications
82
84
  - **`create-adr "decision"`** - Architecture Decision Records with research
83
85
  - **`explain-code [target]`** - Code explanations with diagrams
84
86
 
85
87
  ### ⚙️ Implementation
88
+
86
89
  - **`execute-task`** - Test-driven development workflow
87
90
  - **`status`** - Comprehensive project status
88
91
  - **`swab`** - Small code improvements
89
92
 
90
- ### 🔗 Platform Integration
91
- - **`create-github-issues`** - Generate GitHub issues from specs
92
- - **`sync-github-issues`** - Sync with GitHub project management
93
- - **`create-azure-work-items`** - Generate Azure DevOps work items
94
- - **`sync-azure-work-items`** - Sync with Azure DevOps
95
-
96
- *Command syntax and execution varies by IDE - see platform-specific documentation*
93
+ _Command syntax and execution varies by IDE - see platform-specific documentation_
97
94
 
98
95
  ## 🔄 Workflow Examples
99
96
 
100
97
  ### Feature Development
98
+
101
99
  ```bash
102
100
  # 1. Research and plan
103
- cc: research "WebSocket vs Server-Sent Events"
104
- cc: create-adr "real-time communication strategy"
101
+ /research "WebSocket vs Server-Sent Events"
102
+ /create-adr "real-time communication strategy"
105
103
 
106
104
  # 2. Create comprehensive specification
107
- cc: create-spec "real-time chat system"
105
+ /create-spec "real-time chat system"
108
106
 
109
107
  # 3. Implement with TDD
110
- cc: execute-task
111
-
112
- # 4. Integrate with project management
113
- cc: create-github-issues
108
+ /execute-task
114
109
  ```
115
110
 
116
111
  ### Project Analysis
112
+
117
113
  ```bash
118
114
  # Analyze existing codebase
119
- cc: initialize
115
+ /initialize
120
116
 
121
117
  # Plan new features based on analysis
122
- cc: plan-product "enhanced user dashboard"
118
+ /plan-product "enhanced user dashboard"
123
119
 
124
120
  # Clean up as you go
125
- cc: swab
121
+ /swab
126
122
  ```
127
123
 
128
124
  ## 📁 Directory Structure
@@ -140,31 +136,32 @@ After installation, Code Captain creates an organized workspace:
140
136
  ```
141
137
 
142
138
  Plus IDE-specific integration files in:
139
+
143
140
  - `.cursor/rules/` (Cursor)
144
141
  - `.github/` (Copilot)
145
- - `.windsurf/` (Windsurf)
146
142
  - `.claude/` (Claude.dev)
147
143
 
148
144
  ## 🔧 Platform-Specific Setup
149
145
 
150
146
  Each development environment has its own setup process and command syntax:
151
147
 
152
- | Platform | Installation Location | Command Format | Documentation |
153
- |----------|----------------------|----------------|---------------|
154
- | **Cursor** | `.cursor/rules/` | `cc: command` | [Cursor Guide](cursor/README.md) |
155
- | **Copilot** | `.github/` | `/command` | [Copilot Guide](copilot/README.md) |
156
- | **Windsurf** | `.windsurf/` | `/command` | [Windsurf Guide](windsurf/README.md) |
157
- | **Claude.dev** | `.claude/` | `/command` | [Claude.dev Guide](claude-code/README.md) |
148
+ | Platform | Installation Location | Command Format | Documentation |
149
+ | -------------- | --------------------- | -------------- | ----------------------------------------- |
150
+ | **Cursor** | `.cursor/commands/` | `/command` | [Cursor Guide](cursor/README.md) |
151
+ | **Copilot** | `.github/` | `/command` | [Copilot Guide](copilot/README.md) |
152
+ | **Claude.dev** | `.claude/` | `/command` | [Claude.dev Guide](claude-code/README.md) |
158
153
 
159
154
  ## 🚀 Key Advantages
160
155
 
161
156
  ### vs. Manual AI Prompting
157
+
162
158
  - ✅ **Systematic workflows** vs. ad-hoc requests
163
159
  - ✅ **Organized documentation** vs. scattered outputs
164
160
  - ✅ **Project management integration** vs. isolated interactions
165
161
  - ✅ **Progress tracking** vs. manual status management
166
162
 
167
163
  ### vs. Traditional Development Tools
164
+
168
165
  - ✅ **AI-powered planning** vs. manual specification creation
169
166
  - ✅ **Integrated TDD workflow** vs. separate testing processes
170
167
  - ✅ **Automatic issue creation** vs. manual project management setup
@@ -173,6 +170,7 @@ Each development environment has its own setup process and command syntax:
173
170
  ## 🛠 Development & Customization
174
171
 
175
172
  ### Local Development
173
+
176
174
  ```bash
177
175
  # Clone and test locally
178
176
  git clone https://github.com/devobsessed/code-captain.git
@@ -183,6 +181,7 @@ CC_LOCAL_SOURCE=. npx @devobsessed/code-captain
183
181
  ```
184
182
 
185
183
  ### Adding Platform Support
184
+
186
185
  1. Create `platform-name/` directory
187
186
  2. Add platform-specific commands and documentation
188
187
  3. Update installer platform detection
@@ -211,4 +210,4 @@ CC_LOCAL_SOURCE=. npx @devobsessed/code-captain
211
210
 
212
211
  1. **Install:** `npx @devobsessed/code-captain`
213
212
  2. **Choose your IDE** from the links above
214
- 3. **Begin with:** `cc: initialize`
213
+ 3. **Begin with:** `/initialize`