@devobsessed/code-captain 0.0.8 → 0.1.0
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 +35 -27
- package/bin/install.js +1165 -978
- package/claude-code/agents/code-captain.md +15 -3
- package/copilot/chatmodes/Code Captain.chatmode.md +30 -9
- package/copilot/prompts/create-adr.prompt.md +6 -4
- package/copilot/prompts/create-spec.prompt.md +60 -40
- package/copilot/prompts/explain-code.prompt.md +7 -20
- package/copilot/prompts/research.prompt.md +14 -27
- package/cursor/README.md +72 -68
- package/cursor/cc.mdc +54 -31
- package/cursor/commands/create-adr.md +6 -12
- package/cursor/commands/create-spec.md +66 -54
- package/cursor/commands/edit-spec.md +2 -15
- package/cursor/commands/execute-task.md +7 -15
- package/cursor/commands/explain-code.md +16 -32
- package/cursor/commands/initialize.md +18 -17
- package/cursor/commands/new-command.md +168 -77
- package/cursor/commands/plan-product.md +7 -13
- package/cursor/commands/research.md +4 -23
- package/cursor/commands/status.md +28 -28
- package/cursor/commands/swab.md +4 -12
- package/manifest.json +104 -207
- package/package.json +2 -3
- package/cursor/cc.md +0 -156
- package/windsurf/README.md +0 -254
- package/windsurf/rules/cc.md +0 -5
- package/windsurf/workflows/create-adr.md +0 -331
- package/windsurf/workflows/create-spec.md +0 -280
- package/windsurf/workflows/edit-spec.md +0 -273
- package/windsurf/workflows/execute-task.md +0 -276
- package/windsurf/workflows/explain-code.md +0 -288
- package/windsurf/workflows/initialize.md +0 -298
- package/windsurf/workflows/new-command.md +0 -321
- package/windsurf/workflows/plan-product.md +0 -330
- package/windsurf/workflows/research.md +0 -240
- package/windsurf/workflows/status.md +0 -213
- 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
98
|
-
|
|
101
|
+
/research "WebSocket vs Server-Sent Events"
|
|
102
|
+
/create-adr "real-time communication strategy"
|
|
99
103
|
|
|
100
104
|
# 2. Create comprehensive specification
|
|
101
|
-
|
|
105
|
+
/create-spec "real-time chat system"
|
|
102
106
|
|
|
103
107
|
# 3. Implement with TDD
|
|
104
|
-
|
|
108
|
+
/execute-task
|
|
105
109
|
```
|
|
106
110
|
|
|
107
111
|
### Project Analysis
|
|
112
|
+
|
|
108
113
|
```bash
|
|
109
114
|
# Analyze existing codebase
|
|
110
|
-
|
|
115
|
+
/initialize
|
|
111
116
|
|
|
112
117
|
# Plan new features based on analysis
|
|
113
|
-
|
|
118
|
+
/plan-product "enhanced user dashboard"
|
|
114
119
|
|
|
115
120
|
# Clean up as you go
|
|
116
|
-
|
|
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
|
|
144
|
-
|
|
145
|
-
| **Cursor**
|
|
146
|
-
| **Copilot**
|
|
147
|
-
| **
|
|
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:**
|
|
213
|
+
3. **Begin with:** `/initialize`
|