@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.
- package/README.md +36 -37
- package/bin/install.js +1166 -983
- package/claude-code/agents/code-captain.md +31 -22
- package/copilot/README.md +26 -16
- package/copilot/chatmodes/Code Captain.chatmode.md +41 -25
- package/copilot/prompts/create-adr.prompt.md +6 -4
- package/copilot/prompts/create-spec.prompt.md +62 -45
- package/copilot/prompts/explain-code.prompt.md +7 -23
- package/copilot/prompts/new-command.prompt.md +60 -21
- package/copilot/prompts/research.prompt.md +14 -30
- package/copilot/prompts/status.prompt.md +13 -2
- package/copilot/prompts/swab.prompt.md +1 -0
- package/cursor/README.md +77 -88
- package/cursor/cc.mdc +13 -42
- package/cursor/commands/create-adr.md +7 -13
- package/cursor/commands/create-spec.md +73 -64
- package/cursor/commands/edit-spec.md +2 -15
- package/cursor/commands/execute-task.md +7 -15
- package/cursor/commands/explain-code.md +16 -35
- package/cursor/commands/initialize.md +19 -18
- package/cursor/commands/new-command.md +173 -81
- package/cursor/commands/plan-product.md +7 -13
- package/cursor/commands/research.md +5 -27
- package/cursor/commands/status.md +34 -23
- package/cursor/commands/swab.md +63 -12
- package/manifest.json +110 -229
- package/package.json +13 -4
- package/cursor/cc.md +0 -183
- 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
- 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 -292
- package/windsurf/workflows/initialize.md +0 -298
- package/windsurf/workflows/new-command.md +0 -321
- 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
|
-
- **🔍
|
|
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
|
-
|
|
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,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
|
-
|
|
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
|
-
|
|
104
|
-
|
|
101
|
+
/research "WebSocket vs Server-Sent Events"
|
|
102
|
+
/create-adr "real-time communication strategy"
|
|
105
103
|
|
|
106
104
|
# 2. Create comprehensive specification
|
|
107
|
-
|
|
105
|
+
/create-spec "real-time chat system"
|
|
108
106
|
|
|
109
107
|
# 3. Implement with TDD
|
|
110
|
-
|
|
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
|
-
|
|
115
|
+
/initialize
|
|
120
116
|
|
|
121
117
|
# Plan new features based on analysis
|
|
122
|
-
|
|
118
|
+
/plan-product "enhanced user dashboard"
|
|
123
119
|
|
|
124
120
|
# Clean up as you go
|
|
125
|
-
|
|
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
|
|
153
|
-
|
|
154
|
-
| **Cursor**
|
|
155
|
-
| **Copilot**
|
|
156
|
-
| **
|
|
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:**
|
|
213
|
+
3. **Begin with:** `/initialize`
|