template-instructions 1.1.3 → 2.0.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/.cursorrules +48 -0
- package/.gemini/instructions/global.md +58 -4
- package/.gemini/instructions/ide-integration/README.md +298 -0
- package/.gemini/instructions/ide-integration/aider-commands.md +40 -0
- package/.gemini/instructions/ide-integration/cline-config.json +108 -0
- package/.gemini/instructions/ide-integration/cursor-rules.md +63 -0
- package/.gemini/instructions/ide-integration/github-copilot-instructions.md +75 -0
- package/.gemini/instructions/ide-integration/vscode-commands.json +190 -0
- package/.gemini/instructions/ide-integration/windsurf-cascade.md +125 -0
- package/.gemini/instructions/knowledge-base/README.md +202 -0
- package/.gemini/instructions/knowledge-base/architecture/.gitkeep +1 -0
- package/.gemini/instructions/knowledge-base/bugs/.gitkeep +1 -0
- package/.gemini/instructions/knowledge-base/features/.gitkeep +1 -0
- package/.gemini/instructions/knowledge-base/index.md +202 -0
- package/.gemini/instructions/knowledge-base/performance/.gitkeep +1 -0
- package/.gemini/instructions/knowledge-base/platform-specific/.gitkeep +1 -0
- package/.gemini/instructions/knowledge-base/security/.gitkeep +1 -0
- package/.gemini/instructions/roles/designer.md +10 -8
- package/.gemini/instructions/roles/dev.md +7 -4
- package/.gemini/instructions/roles/devops.md +12 -6
- package/.gemini/instructions/roles/orchestrator.md +339 -0
- package/.gemini/instructions/roles/pm.md +7 -5
- package/.gemini/instructions/roles/po.md +1 -1
- package/.gemini/instructions/roles/qa.md +12 -9
- package/.gemini/instructions/roles/sa.md +11 -5
- package/.gemini/instructions/roles/seca.md +12 -7
- package/.gemini/instructions/roles/stakeholder.md +10 -4
- package/.gemini/instructions/roles/tester.md +10 -7
- package/.gemini/instructions/templates/Final-Project-Report-Template.md +280 -0
- package/.gemini/instructions/templates/Knowledge-Entry-Template.md +164 -0
- package/.gemini/instructions/templates/Master-Documentation-Template.md +269 -0
- package/.gemini/instructions/templates/System-Design-Spec-Template.md +170 -0
- package/.gemini/instructions/templates/UIUX-Design-Spec-Template.md +280 -0
- package/.gemini/instructions/usage.md +445 -66
- package/.github/copilot-instructions.md +60 -0
- package/CLI-EXAMPLES.md +649 -0
- package/INTEGRATION-GUIDE.md +709 -0
- package/QUICK-START.md +104 -0
- package/README.md +105 -102
- package/bin/cli.js +104 -22
- package/bin/commands/create.js +96 -0
- package/bin/commands/help.js +69 -0
- package/bin/commands/ide.js +116 -0
- package/bin/commands/init-kb.js +74 -0
- package/bin/commands/install.js +68 -0
- package/bin/commands/list.js +35 -0
- package/bin/utils/args-parser.js +33 -0
- package/bin/utils/colors.js +21 -0
- package/package.json +1 -1
- package/.gemini/instructions/templates/Backend-Design-Spec-Template.md +0 -92
package/.cursorrules
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# TeamLifecycle SDLC Roles
|
|
2
|
+
|
|
3
|
+
You have access to specialized SDLC roles. When user types a slash command, interpret it as the corresponding role tag:
|
|
4
|
+
|
|
5
|
+
## Role Commands
|
|
6
|
+
|
|
7
|
+
- `/pm` → @PM - Project Manager (planning, scope management)
|
|
8
|
+
- `/orchestrator` → @ORCHESTRATOR - Workflow automation
|
|
9
|
+
- `/po` → @PO - Product Owner (backlog, prioritization)
|
|
10
|
+
- `/sa` → @SA - System Analyst (architecture, API design)
|
|
11
|
+
- `/uiux` → @UIUX - UI/UX Designer (interface, user experience)
|
|
12
|
+
- `/qa` → @QA - Quality Assurance (design review, testing strategy)
|
|
13
|
+
- `/seca` → @SECA - Security Analyst (security assessment)
|
|
14
|
+
- `/dev` → @DEV - Developer (implementation)
|
|
15
|
+
- `/devops` → @DEVOPS - DevOps Engineer (CI/CD, deployment)
|
|
16
|
+
- `/tester` → @TESTER - Tester (functional testing, bug detection)
|
|
17
|
+
- `/reporter` → @REPORTER - Reporter (documentation, progress reports)
|
|
18
|
+
- `/stakeholder` → @STAKEHOLDER - Stakeholder (final approval)
|
|
19
|
+
|
|
20
|
+
## Quick Start Commands
|
|
21
|
+
|
|
22
|
+
- `/auto [requirements]` → Start project with full automation (@PM --mode=full-auto)
|
|
23
|
+
- `/semi-auto [requirements]` → Start project with semi-automation (@PM --mode=semi-auto)
|
|
24
|
+
|
|
25
|
+
## Knowledge Base Commands
|
|
26
|
+
|
|
27
|
+
- `/kb-search [query]` → Search knowledge base for solutions
|
|
28
|
+
- `/kb-add [topic]` → Add entry to knowledge base
|
|
29
|
+
|
|
30
|
+
## Usage Examples
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
/pm Build a todo app with authentication and real-time sync
|
|
34
|
+
/auto Create a mobile fitness tracking app for iOS and Android
|
|
35
|
+
/dev Implement OAuth2 authentication flow
|
|
36
|
+
/kb-search React hydration error
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Instructions Location
|
|
40
|
+
|
|
41
|
+
All role definitions and templates are in `.gemini/instructions/`:
|
|
42
|
+
- Roles: `.gemini/instructions/roles/`
|
|
43
|
+
- Templates: `.gemini/instructions/templates/`
|
|
44
|
+
- Knowledge Base: `.gemini/instructions/knowledge-base/`
|
|
45
|
+
- Global Rules: `.gemini/instructions/global.md`
|
|
46
|
+
- Usage Guide: `.gemini/instructions/usage.md`
|
|
47
|
+
|
|
48
|
+
When a slash command is used, load the corresponding role file and execute according to TeamLifecycle workflow.
|
|
@@ -102,6 +102,50 @@ It ensures strict compliance, full traceability, auto-communication, and profess
|
|
|
102
102
|
|
|
103
103
|
---
|
|
104
104
|
|
|
105
|
+
## 📚 Knowledge Base System
|
|
106
|
+
|
|
107
|
+
### Purpose
|
|
108
|
+
The Knowledge Base stores lessons learned, bug patterns, difficult features, and solutions that required multiple attempts. This serves as project memory for future reference.
|
|
109
|
+
|
|
110
|
+
### When to Create Entry
|
|
111
|
+
Create a knowledge entry when:
|
|
112
|
+
- Bug required 3+ attempts to fix
|
|
113
|
+
- Feature implementation was particularly challenging
|
|
114
|
+
- Solution was non-obvious or counter-intuitive
|
|
115
|
+
- Issue is likely to recur in similar projects
|
|
116
|
+
- Root cause analysis revealed important insights
|
|
117
|
+
|
|
118
|
+
### Entry Naming
|
|
119
|
+
**Format:** `KB-[YYYY-MM-DD]-[###]-[short-title].md`
|
|
120
|
+
|
|
121
|
+
**Location:** `.gemini/instructions/knowledge-base/[category]/[severity]/`
|
|
122
|
+
|
|
123
|
+
### Categories
|
|
124
|
+
| Category | Folder | Description |
|
|
125
|
+
|----------|--------|-------------|
|
|
126
|
+
| Bugs | `knowledge-base/bugs/[severity]/` | Bug patterns and fixes |
|
|
127
|
+
| Features | `knowledge-base/features/[type]/` | Complex feature implementations |
|
|
128
|
+
| Architecture | `knowledge-base/architecture/` | Architecture decisions |
|
|
129
|
+
| Security | `knowledge-base/security/` | Security issues and solutions |
|
|
130
|
+
| Performance | `knowledge-base/performance/` | Performance optimizations |
|
|
131
|
+
| Platform | `knowledge-base/platform-specific/[platform]/` | Platform-specific issues |
|
|
132
|
+
|
|
133
|
+
### Workflow
|
|
134
|
+
1. **Create Entry:** Use `Knowledge-Entry-Template.md`
|
|
135
|
+
2. **Document:** Include problem, root cause, solution, prevention
|
|
136
|
+
3. **Tag:** Add appropriate tags for searchability
|
|
137
|
+
4. **Update Index:** Add to `knowledge-base/index.md`
|
|
138
|
+
5. **Notify:** Tag @REPORTER for review
|
|
139
|
+
|
|
140
|
+
### Search Before Starting
|
|
141
|
+
Before implementing complex features or fixing bugs:
|
|
142
|
+
1. Check `knowledge-base/index.md`
|
|
143
|
+
2. Search by keywords, technology, or error messages
|
|
144
|
+
3. Review similar entries
|
|
145
|
+
4. Adapt solutions to current context
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
105
149
|
## Core Rules Every Agent MUST Obey
|
|
106
150
|
|
|
107
151
|
### 1. Approval Gates
|
|
@@ -114,8 +158,9 @@ Critical phases require explicit approval:
|
|
|
114
158
|
|
|
115
159
|
### 2. Auto-Communication via @Tags
|
|
116
160
|
Always use @role tags to notify next agents.
|
|
117
|
-
- **Available roles:** @PM, @PO, @SA, @UIUX, @QA, @SECA, @DEV, @DEVOPS, @TESTER, @REPORTER, @STAKEHOLDER
|
|
161
|
+
- **Available roles:** @ORCHESTRATOR, @PM, @PO, @SA, @UIUX, @QA, @SECA, @DEV, @DEVOPS, @TESTER, @REPORTER, @STAKEHOLDER
|
|
118
162
|
- Example: `### Next Step: @SA - Start designing` or `@TESTER - Please test`
|
|
163
|
+
- **Orchestrator mode:** Add `--mode=full-auto` or `--mode=semi-auto` to enable automation
|
|
119
164
|
|
|
120
165
|
### 3. Mandatory Documentation Tags
|
|
121
166
|
Every action must be tagged with appropriate hashtags:
|
|
@@ -132,6 +177,7 @@ Every action must be tagged with appropriate hashtags:
|
|
|
132
177
|
| **Deployment** | `#deployed-staging`, `#deployed-production` |
|
|
133
178
|
| **Research** | `#searching` |
|
|
134
179
|
| **Reporting** | `#reporting`, `#stakeholder-review` |
|
|
180
|
+
| **Knowledge** | `#knowledge-base`, `#lessons-learned` |
|
|
135
181
|
|
|
136
182
|
### 4. No Scope Creep
|
|
137
183
|
- No new features or changes outside approved Project Plan
|
|
@@ -144,7 +190,7 @@ Use versioned names attached to the current Sprint:
|
|
|
144
190
|
| `Project-Plan-Sprint-[N]-v*.md` | PM |
|
|
145
191
|
| `Product-Backlog-Sprint-[N]-v*.md` | PO |
|
|
146
192
|
| `UIUX-Design-Spec-Sprint-[N]-v*.md` | UIUX |
|
|
147
|
-
| `
|
|
193
|
+
| `System-Design-Spec-Sprint-[N]-v*.md` | SA |
|
|
148
194
|
| `Design-Verification-Report-Sprint-[N]-v*.md` | QA |
|
|
149
195
|
| `Security-Review-Report-Sprint-[N]-v*.md` | SecA |
|
|
150
196
|
| `Development-Log-Sprint-[N]-v*.md` | DEV |
|
|
@@ -163,7 +209,7 @@ ALL project artifacts MUST be created in the project workspace with organized st
|
|
|
163
209
|
| Category | Folder Path | Content Example | Owner |
|
|
164
210
|
|----------|-------------|-----------------|-------|
|
|
165
211
|
| Plans | `docs/sprints/sprint-[N]/plans/` | `Project-Plan-Sprint-[N]-v*.md`, `Product-Backlog-Sprint-[N]-v*.md` | PM, PO |
|
|
166
|
-
| Designs | `docs/sprints/sprint-[N]/designs/` | `
|
|
212
|
+
| Designs | `docs/sprints/sprint-[N]/designs/` | `System-Design-Spec-Sprint-[N]-v*.md`, `UIUX-Design-Spec-Sprint-[N]-v*.md` | SA, UIUX |
|
|
167
213
|
| Reviews | `docs/sprints/sprint-[N]/reviews/` | `Design-Verification-Report-Sprint-[N]-v*.md`, `Security-Review-Report-Sprint-[N]-v*.md` | QA, SecA |
|
|
168
214
|
| Logs | `docs/sprints/sprint-[N]/logs/` | `Development-Log-Sprint-[N]-v*.md`, `DevOps-Plan-and-Log-Sprint-[N]-v*.md` | DEV, DevOps |
|
|
169
215
|
| Tests | `docs/sprints/sprint-[N]/tests/` | `Test-Report-Sprint-[N]-v*.md` | TESTER |
|
|
@@ -201,7 +247,15 @@ After completing any task or phase, the role **MUST** create the corresponding r
|
|
|
201
247
|
- Artifacts must be placed in the exact folder structure: `docs/sprints/sprint-[N]/[category]/`
|
|
202
248
|
- Use version numbers (v1, v2, etc.) for revisions.
|
|
203
249
|
|
|
204
|
-
### 11.
|
|
250
|
+
### 11. Knowledge Base Contribution
|
|
251
|
+
When encountering difficult bugs or features:
|
|
252
|
+
- **Document in Knowledge Base** if bug required 3+ attempts or feature was particularly challenging
|
|
253
|
+
- Use `Knowledge-Entry-Template.md` template
|
|
254
|
+
- Update `knowledge-base/index.md`
|
|
255
|
+
- Tag @REPORTER for review
|
|
256
|
+
- **Search Knowledge Base first** before starting complex work
|
|
257
|
+
|
|
258
|
+
### 12. Completion Criteria
|
|
205
259
|
- ✅ STAKEHOLDER approves
|
|
206
260
|
- ✅ No critical/high bugs remain
|
|
207
261
|
- ✅ All Must-Have features delivered and verified
|
|
@@ -0,0 +1,298 @@
|
|
|
1
|
+
# IDE Integration Guide
|
|
2
|
+
|
|
3
|
+
This folder contains configuration files to integrate TeamLifecycle roles as slash commands in various IDE agent chats.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 📁 Files
|
|
8
|
+
|
|
9
|
+
| File | IDE | Description |
|
|
10
|
+
|------|-----|-------------|
|
|
11
|
+
| `vscode-commands.json` | VS Code | Command definitions for VS Code extensions |
|
|
12
|
+
| `cursor-rules.md` | Cursor | Custom instructions for Cursor IDE |
|
|
13
|
+
| `github-copilot-instructions.md` | GitHub Copilot | Instructions for Copilot Chat |
|
|
14
|
+
| `windsurf-cascade.md` | Windsurf | Configuration for Cascade multi-agent |
|
|
15
|
+
| `cline-config.json` | Cline | Slash commands for Cline extension |
|
|
16
|
+
| `aider-commands.md` | Aider | Command aliases for Aider CLI |
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 🚀 Quick Setup by IDE
|
|
21
|
+
|
|
22
|
+
### 1. Cursor IDE
|
|
23
|
+
|
|
24
|
+
**Installation:**
|
|
25
|
+
```bash
|
|
26
|
+
# Copy to project root
|
|
27
|
+
cp .gemini/instructions/ide-integration/cursor-rules.md .cursorrules
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**Usage:**
|
|
31
|
+
```
|
|
32
|
+
/pm Build a todo app
|
|
33
|
+
/auto Create mobile fitness app
|
|
34
|
+
/dev Implement authentication
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
### 2. GitHub Copilot (VS Code/JetBrains)
|
|
40
|
+
|
|
41
|
+
**Installation:**
|
|
42
|
+
```bash
|
|
43
|
+
# Create .github folder if not exists
|
|
44
|
+
mkdir -p .github
|
|
45
|
+
|
|
46
|
+
# Copy instructions
|
|
47
|
+
cp .gemini/instructions/ide-integration/github-copilot-instructions.md .github/copilot-instructions.md
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**Usage:**
|
|
51
|
+
```
|
|
52
|
+
/pm Design a REST API
|
|
53
|
+
/sa Create database schema
|
|
54
|
+
/kb-search React hooks
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### 3. Windsurf Cascade
|
|
60
|
+
|
|
61
|
+
**Installation:**
|
|
62
|
+
```bash
|
|
63
|
+
# Copy to project root
|
|
64
|
+
cp .gemini/instructions/ide-integration/windsurf-cascade.md .windsurfrules
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Usage:**
|
|
68
|
+
```
|
|
69
|
+
/orchestrator Enable full-auto mode
|
|
70
|
+
/pm Build SaaS platform
|
|
71
|
+
/dev Implement payment gateway
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**Cascade Multi-Agent:**
|
|
75
|
+
Windsurf's Cascade will automatically spawn multiple agents in parallel for roles like SA + UIUX + PO.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
### 4. Cline (VS Code Extension)
|
|
80
|
+
|
|
81
|
+
**Installation:**
|
|
82
|
+
1. Install Cline extension in VS Code
|
|
83
|
+
2. Open Cline settings
|
|
84
|
+
3. Import `cline-config.json`
|
|
85
|
+
|
|
86
|
+
**Usage:**
|
|
87
|
+
```
|
|
88
|
+
/pm Create project plan
|
|
89
|
+
/dev Fix authentication bug
|
|
90
|
+
/tester Run E2E tests
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
### 5. Aider (CLI)
|
|
96
|
+
|
|
97
|
+
**Installation:**
|
|
98
|
+
```bash
|
|
99
|
+
# Add to ~/.aider.conf.yml or project .aider.conf.yml
|
|
100
|
+
cat .gemini/instructions/ide-integration/aider-commands.md >> .aider.conf.yml
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
**Usage:**
|
|
104
|
+
```bash
|
|
105
|
+
aider
|
|
106
|
+
> /pm Build a CLI tool for file conversion
|
|
107
|
+
> /dev Implement JSON to YAML converter
|
|
108
|
+
> /kb-search command line parsing
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 🎯 Available Slash Commands
|
|
114
|
+
|
|
115
|
+
### Core Roles
|
|
116
|
+
| Command | Role | Description |
|
|
117
|
+
|---------|------|-------------|
|
|
118
|
+
| `/pm` | Project Manager | Planning, scope management |
|
|
119
|
+
| `/orchestrator` | Orchestrator | Workflow automation |
|
|
120
|
+
| `/po` | Product Owner | Backlog, prioritization |
|
|
121
|
+
| `/sa` | System Analyst | Architecture, API design |
|
|
122
|
+
| `/uiux` | UI/UX Designer | Interface, user experience |
|
|
123
|
+
| `/qa` | Quality Assurance | Design review, testing |
|
|
124
|
+
| `/seca` | Security Analyst | Security assessment |
|
|
125
|
+
| `/dev` | Developer | Implementation |
|
|
126
|
+
| `/devops` | DevOps | CI/CD, deployment |
|
|
127
|
+
| `/tester` | Tester | Testing, bug detection |
|
|
128
|
+
| `/reporter` | Reporter | Documentation, reports |
|
|
129
|
+
| `/stakeholder` | Stakeholder | Final approval |
|
|
130
|
+
|
|
131
|
+
### Quick Actions
|
|
132
|
+
| Command | Description |
|
|
133
|
+
|---------|-------------|
|
|
134
|
+
| `/auto [requirements]` | Start with full automation |
|
|
135
|
+
| `/semi-auto [requirements]` | Start with semi-automation |
|
|
136
|
+
| `/kb-search [query]` | Search knowledge base |
|
|
137
|
+
| `/kb-add [topic]` | Add knowledge entry |
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 🔧 Custom Configuration
|
|
142
|
+
|
|
143
|
+
### Adding New Commands
|
|
144
|
+
|
|
145
|
+
Edit the appropriate config file and add:
|
|
146
|
+
|
|
147
|
+
**For JSON configs (VS Code, Cline):**
|
|
148
|
+
```json
|
|
149
|
+
{
|
|
150
|
+
"command": "/custom",
|
|
151
|
+
"description": "Custom command",
|
|
152
|
+
"prompt": "@ROLE - ",
|
|
153
|
+
"category": "TeamLifecycle"
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
**For Markdown configs (Cursor, Copilot, Windsurf):**
|
|
158
|
+
```markdown
|
|
159
|
+
- `/custom` → @ROLE - Custom command description
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### Modifying Existing Commands
|
|
163
|
+
|
|
164
|
+
1. Open the config file for your IDE
|
|
165
|
+
2. Find the command definition
|
|
166
|
+
3. Update description or prompt
|
|
167
|
+
4. Restart IDE or reload configuration
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## 💡 Usage Examples
|
|
172
|
+
|
|
173
|
+
### Starting a New Project
|
|
174
|
+
```
|
|
175
|
+
/pm Build a wedding website with:
|
|
176
|
+
- Photo gallery
|
|
177
|
+
- RSVP form
|
|
178
|
+
- Countdown timer
|
|
179
|
+
Platform: Web (Next.js)
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
### Full Automation
|
|
183
|
+
```
|
|
184
|
+
/auto Create a mobile expense tracking app for iOS and Android with:
|
|
185
|
+
- Receipt scanning
|
|
186
|
+
- Category management
|
|
187
|
+
- Budget alerts
|
|
188
|
+
- Export to CSV
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
### Development Tasks
|
|
192
|
+
```
|
|
193
|
+
/dev Implement OAuth2 authentication with Google and GitHub providers
|
|
194
|
+
/devops Setup CI/CD pipeline with GitHub Actions
|
|
195
|
+
/tester Create E2E tests for authentication flow
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### Knowledge Base
|
|
199
|
+
```
|
|
200
|
+
/kb-search React hydration mismatch
|
|
201
|
+
/kb-add Solution for Next.js API route caching issue
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 🔄 Workflow Integration
|
|
207
|
+
|
|
208
|
+
### Manual Mode
|
|
209
|
+
```
|
|
210
|
+
/pm [requirements]
|
|
211
|
+
[Review plan]
|
|
212
|
+
"Approved"
|
|
213
|
+
/sa Begin backend design
|
|
214
|
+
/uiux Design UI
|
|
215
|
+
/qa Review designs
|
|
216
|
+
...
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
### Semi-Auto Mode
|
|
220
|
+
```
|
|
221
|
+
/semi-auto [requirements]
|
|
222
|
+
[Review plan]
|
|
223
|
+
"Approved"
|
|
224
|
+
→ Auto-executes design phase
|
|
225
|
+
[Review results]
|
|
226
|
+
/orchestrator Continue to development
|
|
227
|
+
→ Auto-executes development
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### Full-Auto Mode
|
|
231
|
+
```
|
|
232
|
+
/auto [requirements]
|
|
233
|
+
[Review plan]
|
|
234
|
+
"Approved"
|
|
235
|
+
→ Auto-executes entire workflow
|
|
236
|
+
→ Stops only for critical decisions
|
|
237
|
+
[Make decisions when prompted]
|
|
238
|
+
"✅ Project complete"
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## 🐛 Troubleshooting
|
|
244
|
+
|
|
245
|
+
### Commands Not Working
|
|
246
|
+
|
|
247
|
+
**Cursor:**
|
|
248
|
+
- Ensure `.cursorrules` is in project root
|
|
249
|
+
- Restart Cursor IDE
|
|
250
|
+
- Check file is not ignored by `.gitignore`
|
|
251
|
+
|
|
252
|
+
**GitHub Copilot:**
|
|
253
|
+
- Ensure `.github/copilot-instructions.md` exists
|
|
254
|
+
- Restart VS Code
|
|
255
|
+
- Check Copilot is enabled
|
|
256
|
+
|
|
257
|
+
**Windsurf:**
|
|
258
|
+
- Ensure `.windsurfrules` is in project root
|
|
259
|
+
- Restart Windsurf
|
|
260
|
+
- Check Cascade is enabled
|
|
261
|
+
|
|
262
|
+
### Commands Not Autocompleting
|
|
263
|
+
|
|
264
|
+
- Type `/` and wait for suggestions
|
|
265
|
+
- Check IDE agent chat is active
|
|
266
|
+
- Verify config file syntax is correct
|
|
267
|
+
|
|
268
|
+
### Role Not Loading
|
|
269
|
+
|
|
270
|
+
- Check role file exists: `.gemini/instructions/roles/[role].md`
|
|
271
|
+
- Verify file permissions
|
|
272
|
+
- Check IDE has access to project files
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## 📚 Additional Resources
|
|
277
|
+
|
|
278
|
+
- **Global Rules:** `.gemini/instructions/global.md`
|
|
279
|
+
- **Usage Guide:** `.gemini/instructions/usage.md`
|
|
280
|
+
- **Role Definitions:** `.gemini/instructions/roles/`
|
|
281
|
+
- **Templates:** `.gemini/instructions/templates/`
|
|
282
|
+
- **Knowledge Base:** `.gemini/instructions/knowledge-base/`
|
|
283
|
+
|
|
284
|
+
---
|
|
285
|
+
|
|
286
|
+
## 🤝 Contributing
|
|
287
|
+
|
|
288
|
+
To add support for a new IDE:
|
|
289
|
+
|
|
290
|
+
1. Create config file: `[ide-name]-config.[ext]`
|
|
291
|
+
2. Define slash commands mapping to roles
|
|
292
|
+
3. Add installation instructions to this README
|
|
293
|
+
4. Test commands in the IDE
|
|
294
|
+
5. Submit PR with examples
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
#ide-integration #slash-commands #automation
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Aider CLI - TeamLifecycle Integration
|
|
2
|
+
|
|
3
|
+
## Configuration for Aider
|
|
4
|
+
|
|
5
|
+
Add this to your `.aider.conf.yml` file:
|
|
6
|
+
|
|
7
|
+
```yaml
|
|
8
|
+
# TeamLifecycle SDLC Roles
|
|
9
|
+
|
|
10
|
+
# Custom commands for Aider
|
|
11
|
+
commands:
|
|
12
|
+
pm: "@PM - {message}"
|
|
13
|
+
orchestrator: "@ORCHESTRATOR - {message}"
|
|
14
|
+
po: "@PO - {message}"
|
|
15
|
+
sa: "@SA - {message}"
|
|
16
|
+
uiux: "@UIUX - {message}"
|
|
17
|
+
qa: "@QA - {message}"
|
|
18
|
+
seca: "@SECA - {message}"
|
|
19
|
+
dev: "@DEV - {message}"
|
|
20
|
+
devops: "@DEVOPS - {message}"
|
|
21
|
+
tester: "@TESTER - {message}"
|
|
22
|
+
reporter: "@REPORTER - {message}"
|
|
23
|
+
stakeholder: "@STAKEHOLDER - {message}"
|
|
24
|
+
auto: "@PM - {message} --mode=full-auto"
|
|
25
|
+
semi-auto: "@PM - {message} --mode=semi-auto"
|
|
26
|
+
|
|
27
|
+
# Context files to always include
|
|
28
|
+
read:
|
|
29
|
+
- .gemini/instructions/global.md
|
|
30
|
+
- .gemini/instructions/usage.md
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Usage
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
aider
|
|
37
|
+
> /pm Build a CLI tool for file conversion
|
|
38
|
+
> /dev Implement JSON to YAML converter
|
|
39
|
+
> /kb-search command parsing
|
|
40
|
+
```
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "TeamLifecycle SDLC",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Structured SDLC workflow with specialized roles",
|
|
5
|
+
"slashCommands": [
|
|
6
|
+
{
|
|
7
|
+
"name": "pm",
|
|
8
|
+
"description": "Project Manager - Planning and scope management",
|
|
9
|
+
"systemPrompt": "You are the Project Manager (@PM). Load instructions from .gemini/instructions/roles/pm.md and follow the TeamLifecycle workflow.",
|
|
10
|
+
"userMessageTemplate": "@PM - {{input}}"
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"name": "orchestrator",
|
|
14
|
+
"description": "Orchestrator - Workflow automation",
|
|
15
|
+
"systemPrompt": "You are the Orchestrator (@ORCHESTRATOR). Load instructions from .gemini/instructions/roles/orchestrator.md and automate the workflow.",
|
|
16
|
+
"userMessageTemplate": "@ORCHESTRATOR - {{input}}"
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"name": "po",
|
|
20
|
+
"description": "Product Owner - Backlog and prioritization",
|
|
21
|
+
"systemPrompt": "You are the Product Owner (@PO). Load instructions from .gemini/instructions/roles/po.md.",
|
|
22
|
+
"userMessageTemplate": "@PO - {{input}}"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"name": "sa",
|
|
26
|
+
"description": "System Analyst - Architecture and API design",
|
|
27
|
+
"systemPrompt": "You are the System Analyst (@SA). Load instructions from .gemini/instructions/roles/sa.md.",
|
|
28
|
+
"userMessageTemplate": "@SA - {{input}}"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"name": "uiux",
|
|
32
|
+
"description": "UI/UX Designer - Interface and user experience",
|
|
33
|
+
"systemPrompt": "You are the UI/UX Designer (@UIUX). Load instructions from .gemini/instructions/roles/designer.md.",
|
|
34
|
+
"userMessageTemplate": "@UIUX - {{input}}"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"name": "qa",
|
|
38
|
+
"description": "QA Analyst - Design review and quality assurance",
|
|
39
|
+
"systemPrompt": "You are the QA Analyst (@QA). Load instructions from .gemini/instructions/roles/qa.md.",
|
|
40
|
+
"userMessageTemplate": "@QA - {{input}}"
|
|
41
|
+
},
|
|
42
|
+
{
|
|
43
|
+
"name": "seca",
|
|
44
|
+
"description": "Security Analyst - Security assessment",
|
|
45
|
+
"systemPrompt": "You are the Security Analyst (@SECA). Load instructions from .gemini/instructions/roles/seca.md.",
|
|
46
|
+
"userMessageTemplate": "@SECA - {{input}}"
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"name": "dev",
|
|
50
|
+
"description": "Developer - Code implementation",
|
|
51
|
+
"systemPrompt": "You are the Developer (@DEV). Load instructions from .gemini/instructions/roles/dev.md.",
|
|
52
|
+
"userMessageTemplate": "@DEV - {{input}}"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "devops",
|
|
56
|
+
"description": "DevOps Engineer - CI/CD and deployment",
|
|
57
|
+
"systemPrompt": "You are the DevOps Engineer (@DEVOPS). Load instructions from .gemini/instructions/roles/devops.md.",
|
|
58
|
+
"userMessageTemplate": "@DEVOPS - {{input}}"
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"name": "tester",
|
|
62
|
+
"description": "Tester - Functional testing and bug detection",
|
|
63
|
+
"systemPrompt": "You are the Tester (@TESTER). Load instructions from .gemini/instructions/roles/tester.md.",
|
|
64
|
+
"userMessageTemplate": "@TESTER - {{input}}"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"name": "reporter",
|
|
68
|
+
"description": "Reporter - Documentation and progress reports",
|
|
69
|
+
"systemPrompt": "You are the Reporter (@REPORTER). Load instructions from .gemini/instructions/roles/reporter.md.",
|
|
70
|
+
"userMessageTemplate": "@REPORTER - {{input}}"
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"name": "stakeholder",
|
|
74
|
+
"description": "Stakeholder - Final approval",
|
|
75
|
+
"systemPrompt": "You are the Stakeholder (@STAKEHOLDER). Load instructions from .gemini/instructions/roles/stakeholder.md.",
|
|
76
|
+
"userMessageTemplate": "@STAKEHOLDER - {{input}}"
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"name": "auto",
|
|
80
|
+
"description": "Start project with full automation",
|
|
81
|
+
"systemPrompt": "You are the Project Manager (@PM) with full automation enabled. Load instructions from .gemini/instructions/roles/pm.md and .gemini/instructions/roles/orchestrator.md.",
|
|
82
|
+
"userMessageTemplate": "@PM - {{input}} --mode=full-auto"
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"name": "semi-auto",
|
|
86
|
+
"description": "Start project with semi-automation",
|
|
87
|
+
"systemPrompt": "You are the Project Manager (@PM) with semi-automation enabled. Load instructions from .gemini/instructions/roles/pm.md and .gemini/instructions/roles/orchestrator.md.",
|
|
88
|
+
"userMessageTemplate": "@PM - {{input}} --mode=semi-auto"
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"name": "kb-search",
|
|
92
|
+
"description": "Search knowledge base",
|
|
93
|
+
"systemPrompt": "Search the knowledge base at .gemini/instructions/knowledge-base/ for relevant entries. Check index.md first, then search by category, technology, and keywords.",
|
|
94
|
+
"userMessageTemplate": "Search knowledge base for: {{input}}"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"name": "kb-add",
|
|
98
|
+
"description": "Add entry to knowledge base",
|
|
99
|
+
"systemPrompt": "Create a new knowledge base entry using the template at .gemini/instructions/templates/Knowledge-Entry-Template.md. Save to appropriate category folder and update index.md.",
|
|
100
|
+
"userMessageTemplate": "Create knowledge base entry for: {{input}}"
|
|
101
|
+
}
|
|
102
|
+
],
|
|
103
|
+
"contextFiles": [
|
|
104
|
+
".gemini/instructions/global.md",
|
|
105
|
+
".gemini/instructions/usage.md"
|
|
106
|
+
],
|
|
107
|
+
"customInstructions": "This project uses TeamLifecycle SDLC workflow. All role definitions are in .gemini/instructions/roles/. Follow global rules from .gemini/instructions/global.md. Create artifacts in docs/sprints/sprint-[N]/ structure. Use templates from .gemini/instructions/templates/. Search knowledge base before starting complex work."
|
|
108
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Cursor IDE - TeamLifecycle Integration
|
|
2
|
+
|
|
3
|
+
## Custom Instructions for Cursor
|
|
4
|
+
|
|
5
|
+
Add this to your `.cursorrules` file in the project root:
|
|
6
|
+
|
|
7
|
+
```markdown
|
|
8
|
+
# TeamLifecycle SDLC Roles
|
|
9
|
+
|
|
10
|
+
You have access to specialized SDLC roles. When user types a slash command, interpret it as the corresponding role tag:
|
|
11
|
+
|
|
12
|
+
## Role Commands
|
|
13
|
+
|
|
14
|
+
- `/pm` → @PM - Project Manager (planning, scope management)
|
|
15
|
+
- `/orchestrator` → @ORCHESTRATOR - Workflow automation
|
|
16
|
+
- `/po` → @PO - Product Owner (backlog, prioritization)
|
|
17
|
+
- `/sa` → @SA - System Analyst (architecture, API design)
|
|
18
|
+
- `/uiux` → @UIUX - UI/UX Designer (interface, user experience)
|
|
19
|
+
- `/qa` → @QA - Quality Assurance (design review, testing strategy)
|
|
20
|
+
- `/seca` → @SECA - Security Analyst (security assessment)
|
|
21
|
+
- `/dev` → @DEV - Developer (implementation)
|
|
22
|
+
- `/devops` → @DEVOPS - DevOps Engineer (CI/CD, deployment)
|
|
23
|
+
- `/tester` → @TESTER - Tester (functional testing, bug detection)
|
|
24
|
+
- `/reporter` → @REPORTER - Reporter (documentation, progress reports)
|
|
25
|
+
- `/stakeholder` → @STAKEHOLDER - Stakeholder (final approval)
|
|
26
|
+
|
|
27
|
+
## Quick Start Commands
|
|
28
|
+
|
|
29
|
+
- `/auto [requirements]` → Start project with full automation (@PM --mode=full-auto)
|
|
30
|
+
- `/semi-auto [requirements]` → Start project with semi-automation (@PM --mode=semi-auto)
|
|
31
|
+
|
|
32
|
+
## Knowledge Base Commands
|
|
33
|
+
|
|
34
|
+
- `/kb-search [query]` → Search knowledge base for solutions
|
|
35
|
+
- `/kb-add [topic]` → Add entry to knowledge base
|
|
36
|
+
|
|
37
|
+
## Usage Examples
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
/pm Build a todo app with authentication and real-time sync
|
|
41
|
+
/auto Create a mobile fitness tracking app for iOS and Android
|
|
42
|
+
/dev Implement OAuth2 authentication flow
|
|
43
|
+
/kb-search React hydration error
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Instructions Location
|
|
47
|
+
|
|
48
|
+
All role definitions and templates are in `.gemini/instructions/`:
|
|
49
|
+
- Roles: `.gemini/instructions/roles/`
|
|
50
|
+
- Templates: `.gemini/instructions/templates/`
|
|
51
|
+
- Knowledge Base: `.gemini/instructions/knowledge-base/`
|
|
52
|
+
- Global Rules: `.gemini/instructions/global.md`
|
|
53
|
+
- Usage Guide: `.gemini/instructions/usage.md`
|
|
54
|
+
|
|
55
|
+
When a slash command is used, load the corresponding role file and execute according to TeamLifecycle workflow.
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Installation
|
|
59
|
+
|
|
60
|
+
1. Create `.cursorrules` file in your project root
|
|
61
|
+
2. Copy the content above into the file
|
|
62
|
+
3. Restart Cursor IDE
|
|
63
|
+
4. Type `/` in chat to see available commands
|