@devobsessed/code-captain 0.0.8 → 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 (37) hide show
  1. package/README.md +35 -27
  2. package/bin/install.js +1165 -978
  3. package/claude-code/agents/code-captain.md +15 -3
  4. package/copilot/chatmodes/Code Captain.chatmode.md +30 -9
  5. package/copilot/prompts/create-adr.prompt.md +6 -4
  6. package/copilot/prompts/create-spec.prompt.md +60 -40
  7. package/copilot/prompts/explain-code.prompt.md +7 -20
  8. package/copilot/prompts/research.prompt.md +14 -27
  9. package/cursor/README.md +72 -68
  10. package/cursor/cc.mdc +13 -35
  11. package/cursor/commands/create-adr.md +6 -12
  12. package/cursor/commands/create-spec.md +66 -54
  13. package/cursor/commands/edit-spec.md +2 -15
  14. package/cursor/commands/execute-task.md +7 -15
  15. package/cursor/commands/explain-code.md +16 -32
  16. package/cursor/commands/initialize.md +18 -17
  17. package/cursor/commands/new-command.md +168 -77
  18. package/cursor/commands/plan-product.md +7 -13
  19. package/cursor/commands/research.md +4 -23
  20. package/cursor/commands/status.md +28 -28
  21. package/cursor/commands/swab.md +4 -12
  22. package/manifest.json +104 -207
  23. package/package.json +2 -3
  24. package/cursor/cc.md +0 -156
  25. package/windsurf/README.md +0 -254
  26. package/windsurf/rules/cc.md +0 -5
  27. package/windsurf/workflows/create-adr.md +0 -331
  28. package/windsurf/workflows/create-spec.md +0 -280
  29. package/windsurf/workflows/edit-spec.md +0 -273
  30. package/windsurf/workflows/execute-task.md +0 -276
  31. package/windsurf/workflows/explain-code.md +0 -288
  32. package/windsurf/workflows/initialize.md +0 -298
  33. package/windsurf/workflows/new-command.md +0 -321
  34. package/windsurf/workflows/plan-product.md +0 -330
  35. package/windsurf/workflows/research.md +0 -240
  36. package/windsurf/workflows/status.md +0 -213
  37. package/windsurf/workflows/swab.md +0 -212
package/README.md CHANGED
@@ -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,49 +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
- *Command syntax and execution varies by IDE - see platform-specific documentation*
93
+ _Command syntax and execution varies by IDE - see platform-specific documentation_
91
94
 
92
95
  ## 🔄 Workflow Examples
93
96
 
94
97
  ### Feature Development
98
+
95
99
  ```bash
96
100
  # 1. Research and plan
97
- cc: research "WebSocket vs Server-Sent Events"
98
- cc: create-adr "real-time communication strategy"
101
+ /research "WebSocket vs Server-Sent Events"
102
+ /create-adr "real-time communication strategy"
99
103
 
100
104
  # 2. Create comprehensive specification
101
- cc: create-spec "real-time chat system"
105
+ /create-spec "real-time chat system"
102
106
 
103
107
  # 3. Implement with TDD
104
- cc: execute-task
108
+ /execute-task
105
109
  ```
106
110
 
107
111
  ### Project Analysis
112
+
108
113
  ```bash
109
114
  # Analyze existing codebase
110
- cc: initialize
115
+ /initialize
111
116
 
112
117
  # Plan new features based on analysis
113
- cc: plan-product "enhanced user dashboard"
118
+ /plan-product "enhanced user dashboard"
114
119
 
115
120
  # Clean up as you go
116
- cc: swab
121
+ /swab
117
122
  ```
118
123
 
119
124
  ## 📁 Directory Structure
@@ -131,31 +136,32 @@ After installation, Code Captain creates an organized workspace:
131
136
  ```
132
137
 
133
138
  Plus IDE-specific integration files in:
139
+
134
140
  - `.cursor/rules/` (Cursor)
135
141
  - `.github/` (Copilot)
136
- - `.windsurf/` (Windsurf)
137
142
  - `.claude/` (Claude.dev)
138
143
 
139
144
  ## 🔧 Platform-Specific Setup
140
145
 
141
146
  Each development environment has its own setup process and command syntax:
142
147
 
143
- | Platform | Installation Location | Command Format | Documentation |
144
- |----------|----------------------|----------------|---------------|
145
- | **Cursor** | `.cursor/rules/` | `cc: command` | [Cursor Guide](cursor/README.md) |
146
- | **Copilot** | `.github/` | `/command` | [Copilot Guide](copilot/README.md) |
147
- | **Windsurf** | `.windsurf/` | `/command` | [Windsurf Guide](windsurf/README.md) |
148
- | **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) |
149
153
 
150
154
  ## 🚀 Key Advantages
151
155
 
152
156
  ### vs. Manual AI Prompting
157
+
153
158
  - ✅ **Systematic workflows** vs. ad-hoc requests
154
159
  - ✅ **Organized documentation** vs. scattered outputs
155
160
  - ✅ **Project management integration** vs. isolated interactions
156
161
  - ✅ **Progress tracking** vs. manual status management
157
162
 
158
163
  ### vs. Traditional Development Tools
164
+
159
165
  - ✅ **AI-powered planning** vs. manual specification creation
160
166
  - ✅ **Integrated TDD workflow** vs. separate testing processes
161
167
  - ✅ **Automatic issue creation** vs. manual project management setup
@@ -164,6 +170,7 @@ Each development environment has its own setup process and command syntax:
164
170
  ## 🛠 Development & Customization
165
171
 
166
172
  ### Local Development
173
+
167
174
  ```bash
168
175
  # Clone and test locally
169
176
  git clone https://github.com/devobsessed/code-captain.git
@@ -174,6 +181,7 @@ CC_LOCAL_SOURCE=. npx @devobsessed/code-captain
174
181
  ```
175
182
 
176
183
  ### Adding Platform Support
184
+
177
185
  1. Create `platform-name/` directory
178
186
  2. Add platform-specific commands and documentation
179
187
  3. Update installer platform detection
@@ -202,4 +210,4 @@ CC_LOCAL_SOURCE=. npx @devobsessed/code-captain
202
210
 
203
211
  1. **Install:** `npx @devobsessed/code-captain`
204
212
  2. **Choose your IDE** from the links above
205
- 3. **Begin with:** `cc: initialize`
213
+ 3. **Begin with:** `/initialize`