codingbuddy-rules 2.1.0 → 2.2.1
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/.ai-rules/adapters/antigravity.md +83 -3
- package/.ai-rules/adapters/claude-code.md +139 -13
- package/.ai-rules/adapters/codex.md +57 -0
- package/.ai-rules/adapters/cursor.md +56 -0
- package/.ai-rules/adapters/kiro.md +70 -4
- package/.ai-rules/adapters/opencode-skills.md +16 -16
- package/.ai-rules/adapters/opencode.md +107 -16
- package/.ai-rules/adapters/q.md +61 -4
- package/.ai-rules/agents/accessibility-specialist.json +1 -1
- package/.ai-rules/agents/act-mode.json +34 -34
- package/.ai-rules/agents/agent-architect.json +2 -2
- package/.ai-rules/agents/architecture-specialist.json +1 -1
- package/.ai-rules/agents/backend-developer.json +1 -1
- package/.ai-rules/agents/code-quality-specialist.json +1 -1
- package/.ai-rules/agents/code-reviewer.json +70 -0
- package/.ai-rules/agents/data-engineer.json +1 -1
- package/.ai-rules/agents/devops-engineer.json +6 -6
- package/.ai-rules/agents/documentation-specialist.json +1 -1
- package/.ai-rules/agents/eval-mode.json +52 -33
- package/.ai-rules/agents/frontend-developer.json +1 -1
- package/.ai-rules/agents/i18n-specialist.json +1 -1
- package/.ai-rules/agents/mobile-developer.json +1 -1
- package/.ai-rules/agents/performance-specialist.json +1 -1
- package/.ai-rules/agents/plan-mode.json +25 -25
- package/.ai-rules/agents/security-specialist.json +1 -1
- package/.ai-rules/agents/seo-specialist.json +1 -1
- package/.ai-rules/agents/solution-architect.json +2 -2
- package/.ai-rules/agents/technical-planner.json +2 -2
- package/.ai-rules/agents/test-strategy-specialist.json +1 -1
- package/.ai-rules/agents/tooling-engineer.json +18 -0
- package/.ai-rules/agents/ui-ux-designer.json +1 -1
- package/.ai-rules/checklists/conventions.json +201 -0
- package/.ai-rules/rules/core.md +200 -2
- package/package.json +1 -1
|
@@ -50,7 +50,7 @@ See full workflow details in `.ai-rules/rules/core.md`
|
|
|
50
50
|
|
|
51
51
|
#### Tech Stack
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
See project `package.json`.
|
|
54
54
|
|
|
55
55
|
#### Project Structure
|
|
56
56
|
```
|
|
@@ -126,7 +126,7 @@ Antigravity uses artifact files for:
|
|
|
126
126
|
|
|
127
127
|
### Communication
|
|
128
128
|
|
|
129
|
-
- **
|
|
129
|
+
- **Follow project's configured language setting**
|
|
130
130
|
- Use structured markdown formatting
|
|
131
131
|
- Provide clear, actionable feedback
|
|
132
132
|
|
|
@@ -161,7 +161,7 @@ When working with Antigravity, it automatically has access to:
|
|
|
161
161
|
### Workflow Example
|
|
162
162
|
|
|
163
163
|
```
|
|
164
|
-
User:
|
|
164
|
+
User: Build a new newsletter feature
|
|
165
165
|
|
|
166
166
|
AI: # Mode: PLAN
|
|
167
167
|
## 📋 Plan Overview
|
|
@@ -187,6 +187,86 @@ AI: # Mode: EVAL
|
|
|
187
187
|
- ✅ Access to all specialist agent knowledge
|
|
188
188
|
- ✅ Easy to update: change `.ai-rules/` once, all tools benefit
|
|
189
189
|
|
|
190
|
+
## AUTO Mode
|
|
191
|
+
|
|
192
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
193
|
+
|
|
194
|
+
### Triggering AUTO Mode
|
|
195
|
+
|
|
196
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
197
|
+
|
|
198
|
+
| Language | Keyword |
|
|
199
|
+
|----------|---------|
|
|
200
|
+
| English | `AUTO` |
|
|
201
|
+
| Korean | `자동` |
|
|
202
|
+
| Japanese | `自動` |
|
|
203
|
+
| Chinese | `自动` |
|
|
204
|
+
| Spanish | `AUTOMATICO` |
|
|
205
|
+
|
|
206
|
+
### Example Usage
|
|
207
|
+
|
|
208
|
+
```
|
|
209
|
+
User: AUTO Build a new payment system feature
|
|
210
|
+
|
|
211
|
+
AI: # Mode: AUTO (Iteration 1/3)
|
|
212
|
+
## Phase: PLAN
|
|
213
|
+
[Following .ai-rules/rules/core.md workflow]
|
|
214
|
+
|
|
215
|
+
## Phase: ACT
|
|
216
|
+
[Execute with .ai-rules guidelines]
|
|
217
|
+
|
|
218
|
+
## Phase: EVAL
|
|
219
|
+
[Evaluate with quality criteria]
|
|
220
|
+
|
|
221
|
+
### Quality Status
|
|
222
|
+
- Critical: 0
|
|
223
|
+
- High: 0
|
|
224
|
+
|
|
225
|
+
✅ AUTO mode completed successfully!
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
### Workflow
|
|
229
|
+
|
|
230
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria
|
|
231
|
+
2. **ACT Phase**: Executes implementation following TDD workflow
|
|
232
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria
|
|
233
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
234
|
+
- Success: `Critical = 0 AND High = 0`
|
|
235
|
+
- Failure: Max iterations reached (default: 3)
|
|
236
|
+
|
|
237
|
+
### Antigravity-Specific Integration
|
|
238
|
+
|
|
239
|
+
AUTO mode works with Antigravity's task boundary tracking:
|
|
240
|
+
|
|
241
|
+
```python
|
|
242
|
+
task_boundary(
|
|
243
|
+
TaskName="AUTO: Feature Implementation",
|
|
244
|
+
Mode="AUTO_ITERATION",
|
|
245
|
+
TaskSummary="Iteration 1/3 - PLAN phase completed",
|
|
246
|
+
TaskStatus="Executing ACT phase",
|
|
247
|
+
PredictedTaskSize=30
|
|
248
|
+
)
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
### Configuration
|
|
252
|
+
|
|
253
|
+
Configure in `codingbuddy.config.js`:
|
|
254
|
+
|
|
255
|
+
```javascript
|
|
256
|
+
module.exports = {
|
|
257
|
+
auto: {
|
|
258
|
+
maxIterations: 3
|
|
259
|
+
}
|
|
260
|
+
};
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
### When to Use
|
|
264
|
+
|
|
265
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
266
|
+
- Complex refactoring with quality verification
|
|
267
|
+
- Bug fixes needing comprehensive testing
|
|
268
|
+
- Code quality improvements with measurable criteria
|
|
269
|
+
|
|
190
270
|
## Maintenance
|
|
191
271
|
|
|
192
272
|
When updating rules:
|
|
@@ -6,6 +6,42 @@ This guide explains how to use the common AI rules (`.ai-rules/`) in Claude Code
|
|
|
6
6
|
|
|
7
7
|
Claude Code uses the `.claude/` directory for project-specific custom instructions, referencing the common rules from `.ai-rules/`.
|
|
8
8
|
|
|
9
|
+
## 🆕 Code Conventions Support
|
|
10
|
+
|
|
11
|
+
CodingBuddy now automatically enforces project code conventions from config files:
|
|
12
|
+
|
|
13
|
+
### Available MCP Tool
|
|
14
|
+
|
|
15
|
+
**`get_code_conventions`**: Parses and exposes project conventions from:
|
|
16
|
+
- `tsconfig.json` - TypeScript strict mode, compiler options
|
|
17
|
+
- `eslint.config.js` / `.eslintrc.json` - Linting rules
|
|
18
|
+
- `.prettierrc` - Formatting rules (quotes, semicolons, indentation)
|
|
19
|
+
- `.editorconfig` - Editor settings (indent style/size, line endings, charset)
|
|
20
|
+
- `.markdownlint.json` - Markdown linting rules
|
|
21
|
+
|
|
22
|
+
### When to Use
|
|
23
|
+
|
|
24
|
+
**ACT Mode**: Call `get_code_conventions` before implementing to verify code follows project conventions.
|
|
25
|
+
|
|
26
|
+
**EVAL Mode**: The `conventions` checklist domain is automatically included in code reviews.
|
|
27
|
+
|
|
28
|
+
### Example Usage
|
|
29
|
+
|
|
30
|
+
```typescript
|
|
31
|
+
// In ACT mode
|
|
32
|
+
const conventions = await get_code_conventions();
|
|
33
|
+
|
|
34
|
+
// Verify TypeScript strict mode
|
|
35
|
+
if (conventions.typescript.strict) {
|
|
36
|
+
// Ensure no implicit any types
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// Check Prettier formatting
|
|
40
|
+
if (conventions.prettier.singleQuote) {
|
|
41
|
+
// Use single quotes
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
9
45
|
## Integration Method
|
|
10
46
|
|
|
11
47
|
### 1. Create Claude Configuration
|
|
@@ -27,7 +63,7 @@ See `.ai-rules/rules/core.md` for:
|
|
|
27
63
|
|
|
28
64
|
### Project Context
|
|
29
65
|
See `.ai-rules/rules/project.md` for:
|
|
30
|
-
- Tech stack (
|
|
66
|
+
- Tech stack (see project package.json)
|
|
31
67
|
- Project structure (app → widgets → features → entities → shared)
|
|
32
68
|
- Development rules and file naming conventions
|
|
33
69
|
- Domain knowledge
|
|
@@ -44,7 +80,7 @@ See `.ai-rules/agents/README.md` for available specialist agents and their exper
|
|
|
44
80
|
|
|
45
81
|
## Claude Code Specific
|
|
46
82
|
|
|
47
|
-
-
|
|
83
|
+
- Follow project's configured language setting
|
|
48
84
|
- Use structured markdown formatting
|
|
49
85
|
- Provide clear, actionable feedback
|
|
50
86
|
- Reference project context from `.ai-rules/rules/project.md`
|
|
@@ -85,7 +121,7 @@ See `.ai-rules/agents/README.md` for available specialist agents and their exper
|
|
|
85
121
|
### In Claude Chat
|
|
86
122
|
|
|
87
123
|
```
|
|
88
|
-
User:
|
|
124
|
+
User: Build a new feature
|
|
89
125
|
|
|
90
126
|
Claude: # Mode: PLAN
|
|
91
127
|
[Following .ai-rules/rules/core.md workflow]
|
|
@@ -198,7 +234,7 @@ Specialist agents can be invoked by any Primary Agent as needed:
|
|
|
198
234
|
|
|
199
235
|
1. **PLAN mode**: Always uses `solution-architect` or `technical-planner` based on prompt analysis
|
|
200
236
|
2. **ACT mode**: Resolution priority:
|
|
201
|
-
1. Explicit agent request in prompt (e.g., "backend-developer
|
|
237
|
+
1. Explicit agent request in prompt (e.g., "work with backend-developer")
|
|
202
238
|
2. `recommended_agent` parameter (from PLAN mode recommendation)
|
|
203
239
|
3. Tooling pattern matching (config files, build tools → `tooling-engineer`)
|
|
204
240
|
4. Project configuration (`primaryAgent` setting)
|
|
@@ -321,22 +357,22 @@ The `parse_mode` MCP tool returns this field to recommend parallel specialist ex
|
|
|
321
357
|
### Parallel Execution Workflow
|
|
322
358
|
|
|
323
359
|
```
|
|
324
|
-
parse_mode
|
|
360
|
+
Call parse_mode
|
|
325
361
|
↓
|
|
326
|
-
parallelAgentsRecommendation
|
|
327
|
-
↓ (
|
|
328
|
-
|
|
362
|
+
Check parallelAgentsRecommendation
|
|
363
|
+
↓ (if exists)
|
|
364
|
+
Display start message to user
|
|
329
365
|
↓
|
|
330
|
-
prepare_parallel_agents MCP
|
|
366
|
+
Call prepare_parallel_agents MCP
|
|
331
367
|
↓
|
|
332
|
-
|
|
368
|
+
Call each agent.taskPrompt via Task tool in parallel:
|
|
333
369
|
- subagent_type: "general-purpose"
|
|
334
370
|
- run_in_background: true
|
|
335
371
|
- prompt: agent.taskPrompt
|
|
336
372
|
↓
|
|
337
|
-
|
|
373
|
+
Collect results with TaskOutput
|
|
338
374
|
↓
|
|
339
|
-
|
|
375
|
+
Display consolidated results to user
|
|
340
376
|
```
|
|
341
377
|
|
|
342
378
|
### Code Example
|
|
@@ -368,7 +404,7 @@ if (parseModeResult.parallelAgentsRecommendation) {
|
|
|
368
404
|
prompt: agent.taskPrompt,
|
|
369
405
|
description: agent.description,
|
|
370
406
|
run_in_background: true,
|
|
371
|
-
model: "
|
|
407
|
+
model: "opus" // Use opus for thorough analysis
|
|
372
408
|
})
|
|
373
409
|
);
|
|
374
410
|
|
|
@@ -450,3 +486,93 @@ Each workflow mode activates different specialist agents:
|
|
|
450
486
|
- **EVAL mode**: Security, accessibility, performance, and code quality specialists provide comprehensive review
|
|
451
487
|
|
|
452
488
|
**Important:** Specialists from one mode do NOT carry over to the next mode. Each mode has its own recommended specialist set.
|
|
489
|
+
|
|
490
|
+
## AUTO Mode
|
|
491
|
+
|
|
492
|
+
AUTO mode enables autonomous iteration through PLAN -> ACT -> EVAL cycles until quality criteria are met.
|
|
493
|
+
|
|
494
|
+
### Triggering AUTO Mode
|
|
495
|
+
|
|
496
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
497
|
+
|
|
498
|
+
| Language | Keyword |
|
|
499
|
+
|----------|---------|
|
|
500
|
+
| English | `AUTO` |
|
|
501
|
+
| Korean | `자동` |
|
|
502
|
+
| Japanese | `自動` |
|
|
503
|
+
| Chinese | `自动` |
|
|
504
|
+
| Spanish | `AUTOMATICO` |
|
|
505
|
+
|
|
506
|
+
### Example Usage
|
|
507
|
+
|
|
508
|
+
```
|
|
509
|
+
AUTO implement user authentication with JWT tokens
|
|
510
|
+
```
|
|
511
|
+
|
|
512
|
+
```
|
|
513
|
+
자동 사용자 인증 기능을 JWT로 구현해줘
|
|
514
|
+
```
|
|
515
|
+
|
|
516
|
+
### Expected Behavior
|
|
517
|
+
|
|
518
|
+
1. **Initial PLAN**: Creates implementation plan with quality criteria
|
|
519
|
+
2. **ACT Iteration**: Executes implementation following TDD workflow
|
|
520
|
+
3. **EVAL Check**: Evaluates quality against exit criteria
|
|
521
|
+
4. **Loop or Exit**:
|
|
522
|
+
- If quality met (Critical=0, High=0): Exits with success summary
|
|
523
|
+
- If max iterations reached: Exits with failure summary and remaining issues
|
|
524
|
+
- Otherwise: Returns to PLAN with improvement focus
|
|
525
|
+
|
|
526
|
+
### Exit Criteria
|
|
527
|
+
|
|
528
|
+
- **Success**: `Critical = 0 AND High = 0` severity issues
|
|
529
|
+
- **Failure**: Max iterations reached (default: 3, configurable via `auto.maxIterations`)
|
|
530
|
+
|
|
531
|
+
### Configuration
|
|
532
|
+
|
|
533
|
+
Configure AUTO mode in `codingbuddy.config.js`:
|
|
534
|
+
|
|
535
|
+
```javascript
|
|
536
|
+
module.exports = {
|
|
537
|
+
auto: {
|
|
538
|
+
maxIterations: 3 // Default: 3
|
|
539
|
+
}
|
|
540
|
+
};
|
|
541
|
+
```
|
|
542
|
+
|
|
543
|
+
### AUTO Mode Output Format
|
|
544
|
+
|
|
545
|
+
```
|
|
546
|
+
# Mode: AUTO (Iteration 1/3)
|
|
547
|
+
|
|
548
|
+
## Phase: PLAN
|
|
549
|
+
[Planning content...]
|
|
550
|
+
|
|
551
|
+
## Phase: ACT
|
|
552
|
+
[Implementation content...]
|
|
553
|
+
|
|
554
|
+
## Phase: EVAL
|
|
555
|
+
[Evaluation content...]
|
|
556
|
+
|
|
557
|
+
### Quality Status
|
|
558
|
+
- Critical: 0
|
|
559
|
+
- High: 0
|
|
560
|
+
|
|
561
|
+
✅ AUTO mode completed successfully!
|
|
562
|
+
```
|
|
563
|
+
|
|
564
|
+
### When to Use AUTO Mode
|
|
565
|
+
|
|
566
|
+
- **Large feature implementations** that require multiple refinement cycles
|
|
567
|
+
- **Complex refactoring** where quality verification is critical
|
|
568
|
+
- **Bug fixes** that need comprehensive testing and validation
|
|
569
|
+
- **Code quality improvements** with measurable success criteria
|
|
570
|
+
|
|
571
|
+
### Differences from Manual Mode Flow
|
|
572
|
+
|
|
573
|
+
| Aspect | Manual Mode | AUTO Mode |
|
|
574
|
+
|--------|-------------|-----------|
|
|
575
|
+
| Transition | User triggers each mode | Automatic cycling |
|
|
576
|
+
| Iterations | Single pass per mode | Multiple cycles until quality met |
|
|
577
|
+
| Exit | User decides completion | Quality criteria or max iterations |
|
|
578
|
+
| Intervention | Required for each step | Only when requested or on failure |
|
|
@@ -147,3 +147,60 @@ Skills are located in `.ai-rules/skills/`. To use a skill:
|
|
|
147
147
|
- `subagent-driven-development` - In-session plan execution
|
|
148
148
|
- `dispatching-parallel-agents` - Handle parallel tasks
|
|
149
149
|
- `frontend-design` - Build production-grade UI
|
|
150
|
+
|
|
151
|
+
## AUTO Mode
|
|
152
|
+
|
|
153
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
154
|
+
|
|
155
|
+
### Triggering AUTO Mode
|
|
156
|
+
|
|
157
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
158
|
+
|
|
159
|
+
| Language | Keyword |
|
|
160
|
+
|----------|---------|
|
|
161
|
+
| English | `AUTO` |
|
|
162
|
+
| Korean | `자동` |
|
|
163
|
+
| Japanese | `自動` |
|
|
164
|
+
| Chinese | `自动` |
|
|
165
|
+
| Spanish | `AUTOMATICO` |
|
|
166
|
+
|
|
167
|
+
### Example Usage
|
|
168
|
+
|
|
169
|
+
```
|
|
170
|
+
AUTO implement user authentication with JWT
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### Workflow
|
|
174
|
+
|
|
175
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria
|
|
176
|
+
2. **ACT Phase**: Executes implementation following TDD workflow
|
|
177
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria
|
|
178
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
179
|
+
- Success: `Critical = 0 AND High = 0`
|
|
180
|
+
- Failure: Max iterations reached (default: 3)
|
|
181
|
+
|
|
182
|
+
### Copilot Integration
|
|
183
|
+
|
|
184
|
+
When using GitHub Copilot Chat with AUTO mode:
|
|
185
|
+
- Copilot references `.ai-rules/rules/core.md` for workflow
|
|
186
|
+
- Applies `.ai-rules/rules/augmented-coding.md` TDD principles
|
|
187
|
+
- Uses project structure from `.ai-rules/rules/project.md`
|
|
188
|
+
|
|
189
|
+
### Configuration
|
|
190
|
+
|
|
191
|
+
Configure in `codingbuddy.config.js`:
|
|
192
|
+
|
|
193
|
+
```javascript
|
|
194
|
+
module.exports = {
|
|
195
|
+
auto: {
|
|
196
|
+
maxIterations: 3
|
|
197
|
+
}
|
|
198
|
+
};
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### When to Use
|
|
202
|
+
|
|
203
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
204
|
+
- Complex refactoring with quality verification
|
|
205
|
+
- Bug fixes needing comprehensive testing
|
|
206
|
+
- Code quality improvements with measurable criteria
|
|
@@ -166,6 +166,62 @@ This project uses codingbuddy MCP server to manage AI Agents.
|
|
|
166
166
|
|
|
167
167
|
See `AGENTS.md` in project root for details.
|
|
168
168
|
|
|
169
|
+
## AUTO Mode
|
|
170
|
+
|
|
171
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
172
|
+
|
|
173
|
+
### Triggering AUTO Mode
|
|
174
|
+
|
|
175
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
176
|
+
|
|
177
|
+
| Language | Keyword |
|
|
178
|
+
|----------|---------|
|
|
179
|
+
| English | `AUTO` |
|
|
180
|
+
| Korean | `자동` |
|
|
181
|
+
| Japanese | `自動` |
|
|
182
|
+
| Chinese | `自动` |
|
|
183
|
+
| Spanish | `AUTOMATICO` |
|
|
184
|
+
|
|
185
|
+
### Example Usage
|
|
186
|
+
|
|
187
|
+
```
|
|
188
|
+
AUTO implement user authentication feature
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
```
|
|
192
|
+
자동 사용자 인증 기능 구현해줘
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
When AUTO keyword is detected, Cursor calls `parse_mode` MCP tool which returns AUTO mode instructions.
|
|
196
|
+
|
|
197
|
+
### Workflow
|
|
198
|
+
|
|
199
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria
|
|
200
|
+
2. **ACT Phase**: Executes implementation following TDD workflow
|
|
201
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria
|
|
202
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
203
|
+
- Success: `Critical = 0 AND High = 0`
|
|
204
|
+
- Failure: Max iterations reached (default: 3)
|
|
205
|
+
|
|
206
|
+
### Configuration
|
|
207
|
+
|
|
208
|
+
Configure in `codingbuddy.config.js`:
|
|
209
|
+
|
|
210
|
+
```javascript
|
|
211
|
+
module.exports = {
|
|
212
|
+
auto: {
|
|
213
|
+
maxIterations: 3
|
|
214
|
+
}
|
|
215
|
+
};
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### When to Use
|
|
219
|
+
|
|
220
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
221
|
+
- Complex refactoring with quality verification
|
|
222
|
+
- Bug fixes needing comprehensive testing
|
|
223
|
+
- Code quality improvements with measurable criteria
|
|
224
|
+
|
|
169
225
|
## Reference
|
|
170
226
|
|
|
171
227
|
- [AGENTS.md Official Spec](https://agents.md)
|
|
@@ -29,7 +29,7 @@ See `.ai-rules/rules/core.md` for:
|
|
|
29
29
|
### Project Context
|
|
30
30
|
|
|
31
31
|
See `.ai-rules/rules/project.md` for:
|
|
32
|
-
- **Tech Stack**:
|
|
32
|
+
- **Tech Stack**: See project package.json
|
|
33
33
|
- **Architecture**: Layered structure (app → widgets → features → entities → shared)
|
|
34
34
|
- **Conventions**: File naming, import/export rules, pure/impure function separation
|
|
35
35
|
|
|
@@ -56,7 +56,7 @@ See `.ai-rules/agents/` for domain expertise:
|
|
|
56
56
|
[Add Kiro-specific customizations here]
|
|
57
57
|
|
|
58
58
|
### Communication
|
|
59
|
-
-
|
|
59
|
+
- Follow project's configured language setting
|
|
60
60
|
- Use clear, structured markdown formatting
|
|
61
61
|
- Provide actionable, specific feedback
|
|
62
62
|
```
|
|
@@ -85,7 +85,7 @@ See `.ai-rules/agents/` for domain expertise:
|
|
|
85
85
|
### In Kiro Session
|
|
86
86
|
|
|
87
87
|
```
|
|
88
|
-
User:
|
|
88
|
+
User: Build a new component
|
|
89
89
|
|
|
90
90
|
Kiro: # Mode: PLAN
|
|
91
91
|
[Follows .ai-rules/rules/core.md workflow]
|
|
@@ -122,9 +122,75 @@ Kiro will generate code following:
|
|
|
122
122
|
2. Update `.kiro/rules/guidelines.md` only for Kiro-specific features
|
|
123
123
|
3. Common rules propagate automatically to all Kiro sessions
|
|
124
124
|
|
|
125
|
+
## AUTO Mode
|
|
126
|
+
|
|
127
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
128
|
+
|
|
129
|
+
### Triggering AUTO Mode
|
|
130
|
+
|
|
131
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
132
|
+
|
|
133
|
+
| Language | Keyword |
|
|
134
|
+
|----------|---------|
|
|
135
|
+
| English | `AUTO` |
|
|
136
|
+
| Korean | `자동` |
|
|
137
|
+
| Japanese | `自動` |
|
|
138
|
+
| Chinese | `自动` |
|
|
139
|
+
| Spanish | `AUTOMATICO` |
|
|
140
|
+
|
|
141
|
+
### Example Usage
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
User: AUTO 새로운 컴포넌트 구현해줘
|
|
145
|
+
|
|
146
|
+
Kiro: # Mode: AUTO (Iteration 1/3)
|
|
147
|
+
## Phase: PLAN
|
|
148
|
+
[Follows .ai-rules/rules/core.md workflow]
|
|
149
|
+
|
|
150
|
+
## Phase: ACT
|
|
151
|
+
[Executes with quality standards from .ai-rules]
|
|
152
|
+
|
|
153
|
+
## Phase: EVAL
|
|
154
|
+
[Evaluates against quality criteria]
|
|
155
|
+
|
|
156
|
+
### Quality Status
|
|
157
|
+
- Critical: 0
|
|
158
|
+
- High: 0
|
|
159
|
+
|
|
160
|
+
✅ AUTO mode completed successfully!
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Workflow
|
|
164
|
+
|
|
165
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria
|
|
166
|
+
2. **ACT Phase**: Executes implementation following TDD workflow
|
|
167
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria
|
|
168
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
169
|
+
- Success: `Critical = 0 AND High = 0`
|
|
170
|
+
- Failure: Max iterations reached (default: 3)
|
|
171
|
+
|
|
172
|
+
### Configuration
|
|
173
|
+
|
|
174
|
+
Configure in `codingbuddy.config.js`:
|
|
175
|
+
|
|
176
|
+
```javascript
|
|
177
|
+
module.exports = {
|
|
178
|
+
auto: {
|
|
179
|
+
maxIterations: 3
|
|
180
|
+
}
|
|
181
|
+
};
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### When to Use
|
|
185
|
+
|
|
186
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
187
|
+
- Complex refactoring with quality verification
|
|
188
|
+
- Bug fixes needing comprehensive testing
|
|
189
|
+
- Code quality improvements with measurable criteria
|
|
190
|
+
|
|
125
191
|
## Getting Started
|
|
126
192
|
|
|
127
193
|
1. Ensure `.ai-rules/` directory exists with all common rules
|
|
128
194
|
2. Create `.kiro/rules/guidelines.md` with content above
|
|
129
195
|
3. Start a Kiro session - it will automatically reference common rules
|
|
130
|
-
4. Use PLAN/ACT/EVAL workflow as defined in `.ai-rules/rules/core.md`
|
|
196
|
+
4. Use PLAN/ACT/EVAL/AUTO workflow as defined in `.ai-rules/rules/core.md`
|
|
@@ -50,24 +50,24 @@ OpenCode/Crush supports Agent Skills standard for structured AI capabilities. Th
|
|
|
50
50
|
### 1. Direct Skill Invocation
|
|
51
51
|
```bash
|
|
52
52
|
# In OpenCode CLI
|
|
53
|
-
/skill brainstorming "
|
|
54
|
-
/skill tdd "
|
|
55
|
-
/skill debug "
|
|
53
|
+
/skill brainstorming "new feature ideas"
|
|
54
|
+
/skill tdd "user authentication implementation"
|
|
55
|
+
/skill debug "fix login bug"
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
### 2. Agent + Skill Combination
|
|
59
59
|
```bash
|
|
60
60
|
# Planning with brainstorming skill
|
|
61
61
|
/agent plan
|
|
62
|
-
/skill brainstorming "
|
|
62
|
+
/skill brainstorming "improve dashboard UI"
|
|
63
63
|
|
|
64
|
-
# Implementation with TDD skill
|
|
64
|
+
# Implementation with TDD skill
|
|
65
65
|
/agent build
|
|
66
|
-
/skill tdd "API
|
|
66
|
+
/skill tdd "implement API integration"
|
|
67
67
|
|
|
68
68
|
# Review with debugging skill
|
|
69
69
|
/agent reviewer
|
|
70
|
-
/skill debug "
|
|
70
|
+
/skill debug "analyze performance issues"
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
### 3. Automatic Skill Recommendation
|
|
@@ -76,9 +76,9 @@ OpenCode can automatically recommend skills based on prompts using the `recommen
|
|
|
76
76
|
|
|
77
77
|
```typescript
|
|
78
78
|
// Auto-triggered when user enters certain keywords
|
|
79
|
-
"
|
|
80
|
-
"
|
|
81
|
-
"UI
|
|
79
|
+
"there's a bug" → recommends: systematic-debugging
|
|
80
|
+
"create a plan" → recommends: writing-plans
|
|
81
|
+
"build the UI" → recommends: frontend-design
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
## Skill Conversion Process
|
|
@@ -201,20 +201,20 @@ The MCP server handles Korean→English skill name mapping automatically.
|
|
|
201
201
|
/agent plan
|
|
202
202
|
|
|
203
203
|
# Use brainstorming skill
|
|
204
|
-
/skill brainstorming "
|
|
204
|
+
/skill brainstorming "improve user dashboard"
|
|
205
205
|
|
|
206
206
|
# Generate implementation plan
|
|
207
|
-
|
|
207
|
+
Create a plan for me
|
|
208
208
|
```
|
|
209
209
|
|
|
210
210
|
### Implementing with TDD
|
|
211
211
|
|
|
212
|
-
```bash
|
|
212
|
+
```bash
|
|
213
213
|
# Switch to build agent
|
|
214
214
|
/agent build
|
|
215
215
|
|
|
216
216
|
# Load TDD skill
|
|
217
|
-
/skill test-driven-development "
|
|
217
|
+
/skill test-driven-development "implement login API"
|
|
218
218
|
|
|
219
219
|
# Start TDD cycle
|
|
220
220
|
ACT
|
|
@@ -224,10 +224,10 @@ ACT
|
|
|
224
224
|
|
|
225
225
|
```bash
|
|
226
226
|
# Use systematic debugging
|
|
227
|
-
/skill systematic-debugging "
|
|
227
|
+
/skill systematic-debugging "screen not showing after login"
|
|
228
228
|
|
|
229
229
|
# Apply debugging methodology
|
|
230
|
-
|
|
230
|
+
Debug this for me
|
|
231
231
|
```
|
|
232
232
|
|
|
233
233
|
## Benefits
|