codingbuddy-rules 0.0.0-canary.20260106162449.5ea2cce → 0.0.0-canary.20260107011541.g12891ae
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 +80 -0
- package/.ai-rules/adapters/claude-code.md +90 -0
- package/.ai-rules/adapters/codex.md +57 -0
- package/.ai-rules/adapters/cursor.md +56 -0
- package/.ai-rules/adapters/kiro.md +67 -1
- package/.ai-rules/adapters/opencode.md +91 -0
- package/.ai-rules/adapters/q.md +57 -0
- package/.ai-rules/rules/core.md +186 -2
- package/package.json +1 -1
|
@@ -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 새로운 결제 시스템 기능 만들어줘
|
|
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:
|
|
@@ -450,3 +450,93 @@ Each workflow mode activates different specialist agents:
|
|
|
450
450
|
- **EVAL mode**: Security, accessibility, performance, and code quality specialists provide comprehensive review
|
|
451
451
|
|
|
452
452
|
**Important:** Specialists from one mode do NOT carry over to the next mode. Each mode has its own recommended specialist set.
|
|
453
|
+
|
|
454
|
+
## AUTO Mode
|
|
455
|
+
|
|
456
|
+
AUTO mode enables autonomous iteration through PLAN -> ACT -> EVAL cycles until quality criteria are met.
|
|
457
|
+
|
|
458
|
+
### Triggering AUTO Mode
|
|
459
|
+
|
|
460
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
461
|
+
|
|
462
|
+
| Language | Keyword |
|
|
463
|
+
|----------|---------|
|
|
464
|
+
| English | `AUTO` |
|
|
465
|
+
| Korean | `자동` |
|
|
466
|
+
| Japanese | `自動` |
|
|
467
|
+
| Chinese | `自动` |
|
|
468
|
+
| Spanish | `AUTOMATICO` |
|
|
469
|
+
|
|
470
|
+
### Example Usage
|
|
471
|
+
|
|
472
|
+
```
|
|
473
|
+
AUTO implement user authentication with JWT tokens
|
|
474
|
+
```
|
|
475
|
+
|
|
476
|
+
```
|
|
477
|
+
자동 사용자 인증 기능을 JWT로 구현해줘
|
|
478
|
+
```
|
|
479
|
+
|
|
480
|
+
### Expected Behavior
|
|
481
|
+
|
|
482
|
+
1. **Initial PLAN**: Creates implementation plan with quality criteria
|
|
483
|
+
2. **ACT Iteration**: Executes implementation following TDD workflow
|
|
484
|
+
3. **EVAL Check**: Evaluates quality against exit criteria
|
|
485
|
+
4. **Loop or Exit**:
|
|
486
|
+
- If quality met (Critical=0, High=0): Exits with success summary
|
|
487
|
+
- If max iterations reached: Exits with failure summary and remaining issues
|
|
488
|
+
- Otherwise: Returns to PLAN with improvement focus
|
|
489
|
+
|
|
490
|
+
### Exit Criteria
|
|
491
|
+
|
|
492
|
+
- **Success**: `Critical = 0 AND High = 0` severity issues
|
|
493
|
+
- **Failure**: Max iterations reached (default: 3, configurable via `auto.maxIterations`)
|
|
494
|
+
|
|
495
|
+
### Configuration
|
|
496
|
+
|
|
497
|
+
Configure AUTO mode in `codingbuddy.config.js`:
|
|
498
|
+
|
|
499
|
+
```javascript
|
|
500
|
+
module.exports = {
|
|
501
|
+
auto: {
|
|
502
|
+
maxIterations: 3 // Default: 3
|
|
503
|
+
}
|
|
504
|
+
};
|
|
505
|
+
```
|
|
506
|
+
|
|
507
|
+
### AUTO Mode Output Format
|
|
508
|
+
|
|
509
|
+
```
|
|
510
|
+
# Mode: AUTO (Iteration 1/3)
|
|
511
|
+
|
|
512
|
+
## Phase: PLAN
|
|
513
|
+
[Planning content...]
|
|
514
|
+
|
|
515
|
+
## Phase: ACT
|
|
516
|
+
[Implementation content...]
|
|
517
|
+
|
|
518
|
+
## Phase: EVAL
|
|
519
|
+
[Evaluation content...]
|
|
520
|
+
|
|
521
|
+
### Quality Status
|
|
522
|
+
- Critical: 0
|
|
523
|
+
- High: 0
|
|
524
|
+
|
|
525
|
+
✅ AUTO mode completed successfully!
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
### When to Use AUTO Mode
|
|
529
|
+
|
|
530
|
+
- **Large feature implementations** that require multiple refinement cycles
|
|
531
|
+
- **Complex refactoring** where quality verification is critical
|
|
532
|
+
- **Bug fixes** that need comprehensive testing and validation
|
|
533
|
+
- **Code quality improvements** with measurable success criteria
|
|
534
|
+
|
|
535
|
+
### Differences from Manual Mode Flow
|
|
536
|
+
|
|
537
|
+
| Aspect | Manual Mode | AUTO Mode |
|
|
538
|
+
|--------|-------------|-----------|
|
|
539
|
+
| Transition | User triggers each mode | Automatic cycling |
|
|
540
|
+
| Iterations | Single pass per mode | Multiple cycles until quality met |
|
|
541
|
+
| Exit | User decides completion | Quality criteria or max iterations |
|
|
542
|
+
| 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)
|
|
@@ -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`
|
|
@@ -545,6 +545,97 @@ API 엔드포인트 구현
|
|
|
545
545
|
보안 취약점 검사
|
|
546
546
|
```
|
|
547
547
|
|
|
548
|
+
## AUTO Mode
|
|
549
|
+
|
|
550
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
551
|
+
|
|
552
|
+
### Triggering AUTO Mode
|
|
553
|
+
|
|
554
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
555
|
+
|
|
556
|
+
| Language | Keyword |
|
|
557
|
+
|----------|---------|
|
|
558
|
+
| English | `AUTO` |
|
|
559
|
+
| Korean | `자동` |
|
|
560
|
+
| Japanese | `自動` |
|
|
561
|
+
| Chinese | `自动` |
|
|
562
|
+
| Spanish | `AUTOMATICO` |
|
|
563
|
+
|
|
564
|
+
### Example Usage
|
|
565
|
+
|
|
566
|
+
```bash
|
|
567
|
+
# Start AUTO mode
|
|
568
|
+
/agent plan-mode
|
|
569
|
+
AUTO 새로운 사용자 인증 기능을 만들어줘
|
|
570
|
+
```
|
|
571
|
+
|
|
572
|
+
### Workflow
|
|
573
|
+
|
|
574
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria (read-only)
|
|
575
|
+
2. **ACT Phase**: Executes implementation following TDD workflow (full permissions)
|
|
576
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria (read-only)
|
|
577
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
578
|
+
- Success: `Critical = 0 AND High = 0`
|
|
579
|
+
- Failure: Max iterations reached (default: 3)
|
|
580
|
+
|
|
581
|
+
### OpenCode Agent Integration
|
|
582
|
+
|
|
583
|
+
AUTO mode automatically switches between agents:
|
|
584
|
+
|
|
585
|
+
```
|
|
586
|
+
AUTO detected
|
|
587
|
+
↓
|
|
588
|
+
plan-mode agent (PLAN phase)
|
|
589
|
+
↓
|
|
590
|
+
act-mode agent (ACT phase)
|
|
591
|
+
↓
|
|
592
|
+
eval-mode agent (EVAL phase)
|
|
593
|
+
↓
|
|
594
|
+
[Check quality criteria]
|
|
595
|
+
↓
|
|
596
|
+
Loop or Exit
|
|
597
|
+
```
|
|
598
|
+
|
|
599
|
+
### Configuration
|
|
600
|
+
|
|
601
|
+
Configure in `codingbuddy.config.js`:
|
|
602
|
+
|
|
603
|
+
```javascript
|
|
604
|
+
module.exports = {
|
|
605
|
+
auto: {
|
|
606
|
+
maxIterations: 3
|
|
607
|
+
}
|
|
608
|
+
};
|
|
609
|
+
```
|
|
610
|
+
|
|
611
|
+
### AUTO Mode Output Format
|
|
612
|
+
|
|
613
|
+
```
|
|
614
|
+
# Mode: AUTO (Iteration 1/3)
|
|
615
|
+
|
|
616
|
+
## Phase: PLAN
|
|
617
|
+
[Planning with plan-mode agent...]
|
|
618
|
+
|
|
619
|
+
## Phase: ACT
|
|
620
|
+
[Implementation with act-mode agent...]
|
|
621
|
+
|
|
622
|
+
## Phase: EVAL
|
|
623
|
+
[Evaluation with eval-mode agent...]
|
|
624
|
+
|
|
625
|
+
### Quality Status
|
|
626
|
+
- Critical: 0
|
|
627
|
+
- High: 0
|
|
628
|
+
|
|
629
|
+
✅ AUTO mode completed successfully!
|
|
630
|
+
```
|
|
631
|
+
|
|
632
|
+
### When to Use
|
|
633
|
+
|
|
634
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
635
|
+
- Complex refactoring with quality verification
|
|
636
|
+
- Bug fixes needing comprehensive testing
|
|
637
|
+
- Code quality improvements with measurable criteria
|
|
638
|
+
|
|
548
639
|
---
|
|
549
640
|
|
|
550
641
|
This guide ensures consistent, high-quality AI-assisted development using OpenCode/Crush with the `.ai-rules` system. All agents follow the same standards while leveraging OpenCode's powerful terminal-based interface.
|
package/.ai-rules/adapters/q.md
CHANGED
|
@@ -119,6 +119,63 @@ Combine Q's AWS expertise with project rules:
|
|
|
119
119
|
- Let Q provide AWS-specific security guidance
|
|
120
120
|
- Apply `.ai-rules/agents/devops-engineer.json` for deployment patterns
|
|
121
121
|
|
|
122
|
+
## AUTO Mode
|
|
123
|
+
|
|
124
|
+
AUTO mode enables autonomous PLAN -> ACT -> EVAL cycling until quality criteria are met.
|
|
125
|
+
|
|
126
|
+
### Triggering AUTO Mode
|
|
127
|
+
|
|
128
|
+
Use the `AUTO` keyword (or localized versions) at the start of your message:
|
|
129
|
+
|
|
130
|
+
| Language | Keyword |
|
|
131
|
+
|----------|---------|
|
|
132
|
+
| English | `AUTO` |
|
|
133
|
+
| Korean | `자동` |
|
|
134
|
+
| Japanese | `自動` |
|
|
135
|
+
| Chinese | `自动` |
|
|
136
|
+
| Spanish | `AUTOMATICO` |
|
|
137
|
+
|
|
138
|
+
### Example Usage
|
|
139
|
+
|
|
140
|
+
```
|
|
141
|
+
AUTO 새로운 Lambda 함수 만들어줘
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### Workflow
|
|
145
|
+
|
|
146
|
+
1. **PLAN Phase**: Creates implementation plan with quality criteria
|
|
147
|
+
2. **ACT Phase**: Executes implementation following TDD workflow
|
|
148
|
+
3. **EVAL Phase**: Evaluates quality against exit criteria
|
|
149
|
+
4. **Loop/Exit**: Continues cycling until:
|
|
150
|
+
- Success: `Critical = 0 AND High = 0`
|
|
151
|
+
- Failure: Max iterations reached (default: 3)
|
|
152
|
+
|
|
153
|
+
### AWS Integration with AUTO Mode
|
|
154
|
+
|
|
155
|
+
Amazon Q's AWS expertise complements AUTO mode:
|
|
156
|
+
- Leverages Q's security scanning during EVAL phase
|
|
157
|
+
- Applies AWS best practices during ACT phase
|
|
158
|
+
- Uses Q's cost optimization suggestions in planning
|
|
159
|
+
|
|
160
|
+
### Configuration
|
|
161
|
+
|
|
162
|
+
Configure in `codingbuddy.config.js`:
|
|
163
|
+
|
|
164
|
+
```javascript
|
|
165
|
+
module.exports = {
|
|
166
|
+
auto: {
|
|
167
|
+
maxIterations: 3
|
|
168
|
+
}
|
|
169
|
+
};
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
### When to Use
|
|
173
|
+
|
|
174
|
+
- Large feature implementations requiring multiple refinement cycles
|
|
175
|
+
- Complex refactoring with quality verification
|
|
176
|
+
- AWS service integrations needing thorough testing
|
|
177
|
+
- Infrastructure as Code development with validation cycles
|
|
178
|
+
|
|
122
179
|
## Maintenance
|
|
123
180
|
|
|
124
181
|
1. Update `.ai-rules/rules/*.md` for universal changes
|
package/.ai-rules/rules/core.md
CHANGED
|
@@ -2,11 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
### Work Modes
|
|
4
4
|
|
|
5
|
-
You have
|
|
5
|
+
You have four modes of operation:
|
|
6
6
|
|
|
7
7
|
1. **Plan mode** - Define a plan without making changes
|
|
8
8
|
2. **Act mode** - Execute the plan and make changes
|
|
9
9
|
3. **Eval mode** - Analyze results and propose improvements
|
|
10
|
+
4. **Auto mode** - Autonomous execution cycling PLAN → ACT → EVAL until quality achieved
|
|
10
11
|
|
|
11
12
|
**Mode Rules:**
|
|
12
13
|
- Start in PLAN mode by default
|
|
@@ -16,6 +17,8 @@ You have three modes of operation:
|
|
|
16
17
|
- EVAL mode analyzes ACT results and proposes improved PLAN
|
|
17
18
|
- After EVAL completes, return to PLAN mode with improvement suggestions
|
|
18
19
|
- User can repeat ACT → EVAL → PLAN cycle until satisfied
|
|
20
|
+
- Move to AUTO mode when user types `AUTO` (or localized: 자동, 自動, 自动, AUTOMÁTICO)
|
|
21
|
+
- AUTO mode autonomously cycles through PLAN → ACT → EVAL until quality targets met
|
|
19
22
|
- When in plan mode always output the full updated plan in every response
|
|
20
23
|
|
|
21
24
|
**Default Flow:**
|
|
@@ -28,12 +31,18 @@ PLAN → (user: ACT) → ACT → PLAN (automatic return)
|
|
|
28
31
|
PLAN → (user: ACT) → ACT → PLAN → (user: EVAL) → EVAL → Improved PLAN
|
|
29
32
|
```
|
|
30
33
|
|
|
31
|
-
**
|
|
34
|
+
**Autonomous Flow:**
|
|
35
|
+
```
|
|
36
|
+
(user: AUTO) → AUTO [PLAN → ACT → EVAL → repeat until Critical=0 AND High=0]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**Key Point:** EVAL is opt-in, not automatic. User must explicitly request evaluation. AUTO mode handles the entire cycle automatically.
|
|
32
40
|
|
|
33
41
|
**Mode Indicators:**
|
|
34
42
|
- Print `# Mode: PLAN` in plan mode
|
|
35
43
|
- Print `# Mode: ACT` in act mode
|
|
36
44
|
- Print `# Mode: EVAL` in eval mode
|
|
45
|
+
- Print `# Mode: AUTO` in auto mode (with iteration number)
|
|
37
46
|
|
|
38
47
|
---
|
|
39
48
|
|
|
@@ -672,6 +681,181 @@ Self-improvement through iterative refinement
|
|
|
672
681
|
- Already meeting all standards
|
|
673
682
|
- Time-sensitive quick fixes
|
|
674
683
|
|
|
684
|
+
---
|
|
685
|
+
|
|
686
|
+
### Auto Mode
|
|
687
|
+
|
|
688
|
+
**Important:**
|
|
689
|
+
- AUTO mode is an **autonomous execution mode** that cycles through PLAN → ACT → EVAL automatically
|
|
690
|
+
- User initiates with `AUTO` keyword and the system handles the entire workflow
|
|
691
|
+
- Continues iterating until quality targets are achieved or maximum iterations reached
|
|
692
|
+
- Best for tasks where iterative refinement is expected
|
|
693
|
+
|
|
694
|
+
**Trigger:**
|
|
695
|
+
- Type `AUTO` to start autonomous execution
|
|
696
|
+
- Korean: `자동`
|
|
697
|
+
- Japanese: `自動`
|
|
698
|
+
- Chinese: `自动`
|
|
699
|
+
- Spanish: `AUTOMÁTICO`
|
|
700
|
+
|
|
701
|
+
**Purpose:**
|
|
702
|
+
Autonomous iterative development - automatically cycling through planning, implementation, and evaluation until quality standards are met.
|
|
703
|
+
|
|
704
|
+
**How AUTO Works:**
|
|
705
|
+
|
|
706
|
+
1. **Initial Phase: PLAN**
|
|
707
|
+
- Creates implementation plan following TDD and augmented coding principles
|
|
708
|
+
- Activates Primary Developer Agent automatically
|
|
709
|
+
- Outputs structured plan with todo items
|
|
710
|
+
|
|
711
|
+
2. **Execution Phase: ACT**
|
|
712
|
+
- Executes the plan created in PLAN phase
|
|
713
|
+
- Follows TDD cycle for core logic, Test-After for UI
|
|
714
|
+
- Maintains quality standards throughout
|
|
715
|
+
|
|
716
|
+
3. **Evaluation Phase: EVAL**
|
|
717
|
+
- Automatically evaluates the implementation (no user prompt required)
|
|
718
|
+
- Activates Code Reviewer Agent
|
|
719
|
+
- Assesses quality across all mandatory perspectives
|
|
720
|
+
- Categorizes issues by severity: Critical, High, Medium, Low
|
|
721
|
+
|
|
722
|
+
4. **Iteration Decision:**
|
|
723
|
+
- **Success (Exit):** Critical = 0 AND High = 0 → Complete with success summary
|
|
724
|
+
- **Continue:** Critical > 0 OR High > 0 → Return to PLAN with improvements
|
|
725
|
+
- **Failure (Exit):** Max iterations reached → Transition to PLAN mode with suggestions
|
|
726
|
+
|
|
727
|
+
**Exit Conditions:**
|
|
728
|
+
|
|
729
|
+
| Condition | Result | Next Action |
|
|
730
|
+
|-----------|--------|-------------|
|
|
731
|
+
| Critical = 0 AND High = 0 | Success | Display completion summary |
|
|
732
|
+
| Max iterations reached | Failure | Transition to PLAN with remaining issues |
|
|
733
|
+
| User interruption | Stopped | Return control to user |
|
|
734
|
+
|
|
735
|
+
**Configuration:**
|
|
736
|
+
|
|
737
|
+
| Parameter | Default | Range | Description |
|
|
738
|
+
|-----------|---------|-------|-------------|
|
|
739
|
+
| `auto.maxIterations` | 3 | 1-10 | Maximum PLAN→ACT→EVAL cycles before forced exit |
|
|
740
|
+
|
|
741
|
+
**🔴 Agent Activation (STRICT):**
|
|
742
|
+
- When AUTO mode is triggered, **Primary Developer Agent** (e.g., `.ai-rules/agents/frontend-developer.json`) **MUST** be automatically activated for PLAN and ACT phases
|
|
743
|
+
- During EVAL phase, **Code Reviewer Agent** (`.ai-rules/agents/code-reviewer.json`) **MUST** be automatically activated
|
|
744
|
+
- The respective Agent's workflow framework and all mandatory requirements MUST be followed
|
|
745
|
+
- See `.ai-rules/agents/` for complete agent frameworks
|
|
746
|
+
|
|
747
|
+
**Output Format:**
|
|
748
|
+
```
|
|
749
|
+
# Mode: AUTO
|
|
750
|
+
## Autonomous Execution Started
|
|
751
|
+
|
|
752
|
+
Task: [Task description]
|
|
753
|
+
Max Iterations: [maxIterations]
|
|
754
|
+
|
|
755
|
+
---
|
|
756
|
+
|
|
757
|
+
## Iteration 1/[maxIterations] - PLAN Phase
|
|
758
|
+
[Standard PLAN mode output]
|
|
759
|
+
|
|
760
|
+
---
|
|
761
|
+
## Iteration 1/[maxIterations] - ACT Phase
|
|
762
|
+
[Standard ACT mode output]
|
|
763
|
+
|
|
764
|
+
---
|
|
765
|
+
## Iteration 1/[maxIterations] - EVAL Phase
|
|
766
|
+
[Standard EVAL mode output]
|
|
767
|
+
|
|
768
|
+
Issues Found:
|
|
769
|
+
- Critical: [N]
|
|
770
|
+
- High: [N] <- 반복 필요 (if Critical > 0 OR High > 0)
|
|
771
|
+
- Medium: [N]
|
|
772
|
+
- Low: [N]
|
|
773
|
+
|
|
774
|
+
[If continue iteration: proceed to next iteration]
|
|
775
|
+
[If success: display completion format]
|
|
776
|
+
[If max iterations: display failure format]
|
|
777
|
+
```
|
|
778
|
+
|
|
779
|
+
**Success Completion Format:**
|
|
780
|
+
```
|
|
781
|
+
---
|
|
782
|
+
# Mode: AUTO - COMPLETED
|
|
783
|
+
|
|
784
|
+
Task completed successfully!
|
|
785
|
+
Final Stats:
|
|
786
|
+
- Iterations: [N]/[maxIterations]
|
|
787
|
+
- Critical: 0, High: 0
|
|
788
|
+
- Medium: [N], Low: [N]
|
|
789
|
+
|
|
790
|
+
Modified Files:
|
|
791
|
+
- [file1]
|
|
792
|
+
- [file2]
|
|
793
|
+
```
|
|
794
|
+
|
|
795
|
+
**Failure (Max Iterations) Format:**
|
|
796
|
+
```
|
|
797
|
+
---
|
|
798
|
+
# Mode: AUTO - MAX ITERATIONS REACHED
|
|
799
|
+
|
|
800
|
+
[maxIterations]회 시도했지만 일부 이슈가 남아있습니다.
|
|
801
|
+
|
|
802
|
+
Remaining Issues:
|
|
803
|
+
- [CRITICAL] [Issue description]
|
|
804
|
+
- [HIGH] [Issue description]
|
|
805
|
+
|
|
806
|
+
시도한 접근:
|
|
807
|
+
- Iteration 1: [approach]
|
|
808
|
+
- Iteration 2: [approach]
|
|
809
|
+
- Iteration 3: [approach]
|
|
810
|
+
|
|
811
|
+
---
|
|
812
|
+
# Mode: PLAN
|
|
813
|
+
```
|
|
814
|
+
|
|
815
|
+
**When to use AUTO:**
|
|
816
|
+
- Complex features requiring multiple refinement cycles
|
|
817
|
+
- Tasks where iterative improvement is expected
|
|
818
|
+
- When you want hands-off development until quality is achieved
|
|
819
|
+
- Production-critical code requiring thorough quality assurance
|
|
820
|
+
- Large implementations that benefit from systematic iteration
|
|
821
|
+
|
|
822
|
+
**When to use manual workflow instead:**
|
|
823
|
+
- Simple, single-step implementations
|
|
824
|
+
- When you want fine-grained control over each phase
|
|
825
|
+
- Exploratory development where direction may change
|
|
826
|
+
- Time-sensitive tasks that shouldn't iterate
|
|
827
|
+
- When specific phase customization is needed
|
|
828
|
+
|
|
829
|
+
**AUTO vs Manual Comparison:**
|
|
830
|
+
|
|
831
|
+
| Aspect | AUTO Mode | Manual (PLAN/ACT/EVAL) |
|
|
832
|
+
|--------|-----------|------------------------|
|
|
833
|
+
| User intervention | Minimal (start only) | Required for each phase |
|
|
834
|
+
| Iteration control | Automatic | User-controlled |
|
|
835
|
+
| Best for | Complex, iterative tasks | Simple or exploratory tasks |
|
|
836
|
+
| Quality guarantee | Enforced (exit conditions) | User judgment |
|
|
837
|
+
| Time efficiency | Optimized for quality | Optimized for control |
|
|
838
|
+
|
|
839
|
+
**🔴 Required:**
|
|
840
|
+
- All PLAN phases must follow the Primary Developer Agent's workflow framework
|
|
841
|
+
- All ACT phases must follow the Primary Developer Agent's code quality checklist
|
|
842
|
+
- All EVAL phases must follow the Code Reviewer Agent's evaluation framework
|
|
843
|
+
- Respond in the language specified in the agent's communication.language setting
|
|
844
|
+
- Continue iterating automatically until exit conditions are met (Critical = 0 AND High = 0)
|
|
845
|
+
- Transition to PLAN mode with remaining issues when max iterations reached
|
|
846
|
+
|
|
847
|
+
**Verification:**
|
|
848
|
+
- Mode indicator `# Mode: AUTO` should be first line at start
|
|
849
|
+
- Task description and max iterations should be displayed in start header
|
|
850
|
+
- Each iteration should display phase indicator: `## Iteration N/[maxIterations] - [Phase] Phase`
|
|
851
|
+
- EVAL phase must include issues summary with Critical, High, Medium, Low counts
|
|
852
|
+
- Success completion should display `# Mode: AUTO - COMPLETED`
|
|
853
|
+
- Failure completion should display `# Mode: AUTO - MAX ITERATIONS REACHED`
|
|
854
|
+
- Exit conditions should be evaluated after each EVAL phase
|
|
855
|
+
- Agent activation rules from PLAN, ACT, EVAL modes apply to respective phases within AUTO mode
|
|
856
|
+
|
|
857
|
+
---
|
|
858
|
+
|
|
675
859
|
### Communication Rules
|
|
676
860
|
|
|
677
861
|
- **Respond in the language specified in the agent's communication.language setting**
|
package/package.json
CHANGED