@damphuquy/agent-init 2.0.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/README.vi.md +2 -0
- package/dist/scaffolder.d.ts.map +1 -1
- package/dist/scaffolder.js +4 -4
- package/dist/scaffolder.js.map +1 -1
- package/dist/ui.d.ts.map +1 -1
- package/dist/ui.js +5 -5
- package/dist/ui.js.map +1 -1
- package/package.json +1 -1
- package/templates/en/.agents/behavior.md +66 -2
- package/templates/en/.agents/guardrails.md +2 -1
- package/templates/en/AGENTS.md +21 -8
- package/templates/en/process/README.md +23 -11
- package/templates/en/process/_seeds/_GUIDE.md +18 -7
- package/templates/en/process/_seeds/decision-template.md.seed +7 -6
- package/templates/en/process/_seeds/plan-template.md.seed +2 -2
- package/templates/en/process/_seeds/review-template.md.seed +1 -1
- package/templates/en/process/_seeds/task-template.md.seed +9 -8
- package/templates/vi/.agents/behavior.md +66 -2
- package/templates/vi/.agents/guardrails.md +2 -1
- package/templates/vi/AGENTS.md +21 -8
- package/templates/vi/process/README.md +22 -10
- package/templates/vi/process/_seeds/_GUIDE.md +18 -7
- package/templates/vi/process/_seeds/decision-template.md.seed +7 -6
- package/templates/vi/process/_seeds/plan-template.md.seed +2 -2
- package/templates/vi/process/_seeds/review-template.md.seed +1 -1
- package/templates/vi/process/_seeds/task-template.md.seed +9 -8
package/README.md
CHANGED
|
@@ -57,7 +57,7 @@ Designed for minimal overhead, practical focus, and zero fluff:
|
|
|
57
57
|
## NPX CLI Commands
|
|
58
58
|
|
|
59
59
|
```bash
|
|
60
|
-
#
|
|
60
|
+
# Interactive setup in current directory (prompts for Language: English or Tiếng Việt)
|
|
61
61
|
npx @damphuquy/agent-init .
|
|
62
62
|
|
|
63
63
|
# Bootstrap directly with Vietnamese templates
|
|
@@ -73,6 +73,8 @@ npx @damphuquy/agent-init ./services/billing --lang vi
|
|
|
73
73
|
npx @damphuquy/agent-init . --force
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
+
> 💡 **Quick Task Tip**: Once installed, you can trigger automatic task creation directly via prompt pseudo-slash commands (e.g., `/feature <name>`, `/task <name>`, `/hotfix <name>`) without manual copying!
|
|
77
|
+
|
|
76
78
|
---
|
|
77
79
|
|
|
78
80
|
## License
|
package/README.vi.md
CHANGED
|
@@ -73,6 +73,8 @@ npx @damphuquy/agent-init ./services/billing --lang vi
|
|
|
73
73
|
npx @damphuquy/agent-init . --force
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
+
> 💡 **Mẹo Tạo Task Nhanh**: Sau khi cài đặt, bạn có thể kích hoạt tạo task tự động trực tiếp bằng câu lệnh giả lập (pseudo-slash commands) trong prompt (ví dụ: `/feature <tên>`, `/task <tên>`, `/hotfix <tên>`) mà không cần sao chép file thủ công!
|
|
77
|
+
|
|
76
78
|
---
|
|
77
79
|
|
|
78
80
|
## 📄 Giấy phép
|
package/dist/scaffolder.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAuB,eAAe,EAAE,cAAc,EAAiB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAoD,EAC7D,IAAI,GAAE,iBAAwB,GAC7B,MAAM,CAMR;
|
|
1
|
+
{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAuB,eAAe,EAAE,cAAc,EAAiB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAoD,EAC7D,IAAI,GAAE,iBAAwB,GAC7B,MAAM,CAMR;AAuJD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAoDjE"}
|
package/dist/scaffolder.js
CHANGED
|
@@ -94,8 +94,8 @@ function printNextSteps(targetDir, lang) {
|
|
|
94
94
|
` Mở ${colors.green(agentsPath)} và điền các lệnh test/lint/typecheck của dự án bạn.`,
|
|
95
95
|
'',
|
|
96
96
|
`${colors.cyan(colors.bold('2. Khởi Tạo Task Đầu Tiên:'))}`,
|
|
97
|
-
` ${colors.yellow(
|
|
98
|
-
`
|
|
97
|
+
` Prompt AI trực tiếp: ${colors.yellow('"small task: <mô tả>..."')} hoặc ${colors.yellow('"big task: <mô tả>..."')}`,
|
|
98
|
+
` (hoặc sao chép thủ công: ${colors.dim(`cp ${seedTaskPath} ${activePlanPath}`)})`,
|
|
99
99
|
'',
|
|
100
100
|
`${colors.cyan(colors.bold('3. Kích Hoạt AI Coding Agent:'))}`,
|
|
101
101
|
` Chỉ định Agent đọc ${colors.green(agentsPath)} và bắt đầu thực thi.`,
|
|
@@ -109,8 +109,8 @@ function printNextSteps(targetDir, lang) {
|
|
|
109
109
|
` Edit ${colors.green(agentsPath)} and specify your project test/lint/typecheck commands.`,
|
|
110
110
|
'',
|
|
111
111
|
`${colors.cyan(colors.bold('2. Instantiate Your First Active Task:'))}`,
|
|
112
|
-
` ${colors.yellow(
|
|
113
|
-
`
|
|
112
|
+
` Prompt AI directly: ${colors.yellow('"small task: <desc>..."')} or ${colors.yellow('"big task: <desc>..."')}`,
|
|
113
|
+
` (or copy manually: ${colors.dim(`cp ${seedTaskPath} ${activePlanPath}`)})`,
|
|
114
114
|
'',
|
|
115
115
|
`${colors.cyan(colors.bold('3. Activate AI Coding Agent:'))}`,
|
|
116
116
|
` Direct your agent to read ${colors.green(agentsPath)} and begin execution.`,
|
package/dist/scaffolder.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scaffolder.js","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGlD,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,WAAW,CAAC,EAC7D,IAAI,GAAsB,IAAI;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,
|
|
1
|
+
{"version":3,"file":"scaffolder.js","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"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"}
|
package/dist/ui.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,UAAe,GACvB,MAAM,CAwCR;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAS5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC1D;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoCpF;
|
|
1
|
+
{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,UAAe,GACvB,MAAM,CAwCR;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAS5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC1D;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoCpF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA+BxE"}
|
package/dist/ui.js
CHANGED
|
@@ -126,13 +126,13 @@ export function showHelp(pkgInfo, colors) {
|
|
|
126
126
|
console.log(` ${colors.cyan('target_directory')} Destination path for workspace ${colors.comment('(default: .)')}`);
|
|
127
127
|
console.log();
|
|
128
128
|
console.log(colors.purple(colors.bold(' OPTIONS')));
|
|
129
|
-
console.log(` ${colors.yellow('-l, --lang <en|vi>')}
|
|
130
|
-
console.log(` ${colors.yellow('-f, --force')}
|
|
131
|
-
console.log(` ${colors.yellow('-h, --help')}
|
|
132
|
-
console.log(` ${colors.yellow('-v, --version')}
|
|
129
|
+
console.log(` ${colors.yellow('-l, --lang <en|vi>')} Template language: 'en' / 'eng' (English) or 'vi' (Tiếng Việt)`);
|
|
130
|
+
console.log(` ${colors.yellow('-f, --force')} Overwrite existing files if already present`);
|
|
131
|
+
console.log(` ${colors.yellow('-h, --help')} Display this help documentation`);
|
|
132
|
+
console.log(` ${colors.yellow('-v, --version')} Display version number`);
|
|
133
133
|
console.log();
|
|
134
134
|
console.log(colors.purple(colors.bold(' EXAMPLES')));
|
|
135
|
-
console.log(` ${colors.comment('# Interactive mode (prompts for
|
|
135
|
+
console.log(` ${colors.comment('# Interactive mode (prompts for Language):')}`);
|
|
136
136
|
console.log(` ${colors.cyan('$')} npx @damphuquy/agent-init .`);
|
|
137
137
|
console.log();
|
|
138
138
|
console.log(` ${colors.comment('# Bootstrap directly with Vietnamese templates:')}`);
|
package/dist/ui.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -25,9 +25,73 @@ first line. The declared mode must match the current phase recorded in `task.md`
|
|
|
25
25
|
Omit the mode declaration only for pure conversational exchanges that do not
|
|
26
26
|
advance a task (e.g., answering a factual question, clarifying scope).
|
|
27
27
|
|
|
28
|
+
In continuous autonomous execution (DELEGATED / Fast-Track), the agent opens with the starting phase's mode. When transitioning across phases within a single turn, emit an explicit transition marker:
|
|
29
|
+
`>>> [PHASE TRANSITION: <OLD_PHASE> -> <NEW_PHASE>]` and proceed under the new mode immediately without pausing.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. Working Modes & Phase Transition Protocol
|
|
34
|
+
|
|
35
|
+
<working_modes_protocol>
|
|
36
|
+
Execution posture is determined by `<working_mode>` in `task.md` or user prompt instruction:
|
|
37
|
+
|
|
38
|
+
### PAIR Mode (Default — Step-by-Step Collaboration):
|
|
39
|
+
- The agent works on one phase at a time.
|
|
40
|
+
- Upon completing a phase, it updates the corresponding artifact and **HALTS** to let the human engineer inspect, discuss, and sign off the Gate (G1, G2, G3).
|
|
41
|
+
- Waits for user prompt (e.g., "Start next phase") before updating `<current_phase>` in `task.md` and continuing.
|
|
42
|
+
|
|
43
|
+
### DELEGATED Mode (Autonomous / Fast-Track / Skip Permissions):
|
|
44
|
+
- **Activation:** `<working_mode>DELEGATED</working_mode>` in `task.md` OR explicit prompt directive ("fast-track", "skip permissions", "run automatically", "auto-advance", "autonomous").
|
|
45
|
+
- **Core Rule:** **DO NOT HALT AFTER EACH PHASE TO WAIT FOR USER PROMPT "NEXT".**
|
|
46
|
+
- **Continuous Transition Workflow:**
|
|
47
|
+
1. When the current phase meets its exit criteria/checklist, the agent checks `- [x]`.
|
|
48
|
+
2. Populates auto-approval into the artifact: `approved_by: [AUTO: DELEGATED]` with timestamp and technical rationale (in INNOVATE: adopts the optimal Recommendation; in PLAN: locks the scope contract).
|
|
49
|
+
3. Immediately updates `<current_phase>` in `task.md` to the next phase (`RESEARCH` → `INNOVATE` → `PLAN` → `EXECUTE` → `REVIEW`).
|
|
50
|
+
4. Instantiates the next phase seed artifact (Copy-On-Demand) and **CONTINUES EXECUTION IMMEDIATELY** within the same session/turn.
|
|
51
|
+
- **Sole Stop Conditions in DELEGATED:**
|
|
52
|
+
- Task is 100% COMPLETE (Gate 3 PASS, housekeeping cleaned, `handoff.md` generated, moved to `completed/`).
|
|
53
|
+
- OR a true Escalation Trigger is tripped (retry budget exhausted after 3 attempts, destructive command, or unresolvable invariant conflict).
|
|
54
|
+
|
|
55
|
+
### MANUAL & DIAGNOSE-ONLY Modes:
|
|
56
|
+
- `MANUAL`: Human leads command-by-command; agent provides scoped assistance.
|
|
57
|
+
- `DIAGNOSE-ONLY`: Runs Research & Review for root-cause audit without mutating source code.
|
|
58
|
+
</working_modes_protocol>
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 3. Prompt-Driven Task Initialization Protocol
|
|
63
|
+
|
|
64
|
+
<prompt_task_initialization>
|
|
65
|
+
When the user requests a new task via prompt (without an existing task folder or `task.md` in `active/`), the Agent **MUST NOT** ask the user to run terminal commands or manually copy seed files. Instead, the Agent automatically recognizes prompt keywords, routes the directory, and initializes `task.md`:
|
|
66
|
+
|
|
67
|
+
### Keyword & Pseudo-Slash Command Routing Table:
|
|
68
|
+
|
|
69
|
+
Users may specify tasks using natural language keywords OR handy prefix commands (**Pseudo-Slash Commands**) at the start of the prompt:
|
|
70
|
+
|
|
71
|
+
| Target Directory | Slash Command (Recommended) | Natural Keywords | Scope & Working Mode |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| **`process/features/active/{task-slug}/`** | `/feature`<br>`/big-task`<br>`/epic` | `big task`, `feature`, `big changes`, `epic` | Major features, domain subsystems, architectural refactors (≥ 5 files, multiple phases). Default mode: **PAIR**. |
|
|
74
|
+
| **`process/general-plans/active/{task-slug}/`** | `/task`<br>`/small-task`<br>`/bug`<br>`/quick-fix` | `small task`, `general changes`, `small changes`, `bug fix`, `quick fix` | Standalone tasks, quick bug fixes, general adjustments (< 5 files). Default mode: **PAIR**. |
|
|
75
|
+
| **`process/general-plans/active/{task-slug}/`** | `/hotfix` | `hotfix`, `emergency fix`, `production bug` | Emergency production fix. Auto-activates **DELEGATED / Fast-Track** mode (auto-certifies G0–G2, pauses only at G3). |
|
|
76
|
+
| *(Scope-derived)* | `/fast-track`<br>`/delegated`<br>`/auto` | `fast-track`, `autonomous`, `auto-advance`, `skip permissions` | Full autonomous execution. Sets `<working_mode>DELEGATED</working_mode>` and runs continuously through all phases. |
|
|
77
|
+
|
|
78
|
+
*Fallback Rule:* If no explicit keyword or slash command is found in the prompt, infer from scope (< 5 files or localized fix $\rightarrow$ `general-plans/`; new capability or multi-module impact $\rightarrow$ `features/`).
|
|
79
|
+
|
|
80
|
+
### Automated Scaffolding & Activation Steps:
|
|
81
|
+
1. **Derive Slug:** Generate a concise, kebab-case `{task-slug}` from the prompt (e.g., `CHG-001-change-password`, `AUTH-002-rate-limiting`, or `{TICKET-ID}-{slug}`).
|
|
82
|
+
2. **Create Directory:** Create `process/features/active/{task-slug}` or `process/general-plans/active/{task-slug}`.
|
|
83
|
+
3. **Instantiate Seed:** Copy `process/_seeds/task-template.md.seed` to `{task-dir}/task.md`.
|
|
84
|
+
4. **Hydrate Specification:**
|
|
85
|
+
- Extract task goal into `<goal>`.
|
|
86
|
+
- Convert user criteria and requirements into actionable markdown checkboxes `- [ ]` under `<acceptance_criteria>`.
|
|
87
|
+
- Set `<working_mode>` (`PAIR` by default, or `DELEGATED` if prompt indicates fast-track / autonomous execution).
|
|
88
|
+
- Set `<status>ACTIVE</status>` and `<current_phase>RESEARCH</current_phase>`.
|
|
89
|
+
5. **Declare Mode & Execute Immediately:** Output `[MODE: RESEARCH]`, announce the initialized `task.md` path, and immediately proceed with the RESEARCH phase without requiring manual user setup.
|
|
90
|
+
</prompt_task_initialization>
|
|
91
|
+
|
|
28
92
|
---
|
|
29
93
|
|
|
30
|
-
##
|
|
94
|
+
## 4. Session Startup Protocol
|
|
31
95
|
|
|
32
96
|
Before continuing any in-progress task, reload persistent state in this order:
|
|
33
97
|
|
|
@@ -45,7 +109,7 @@ file-based artifacts listed above.
|
|
|
45
109
|
|
|
46
110
|
---
|
|
47
111
|
|
|
48
|
-
##
|
|
112
|
+
## 5. Context Navigation Rules
|
|
49
113
|
|
|
50
114
|
<context_rules>
|
|
51
115
|
<rule id="minimum_context">
|
|
@@ -39,10 +39,11 @@
|
|
|
39
39
|
not declared in the approved plan.
|
|
40
40
|
3. Required change touches a file outside the scope defined in `plan.md`.
|
|
41
41
|
4. A business or policy decision is needed that is not in `<approved_decisions>`.
|
|
42
|
+
(Exception: Under DELEGATED / Fast-Track mode, the agent is authorized to select the recommended technical option evaluated in `decision.md` without triggering escalation, provided it preserves `<invariants>` and `<out_of_scope>`).
|
|
42
43
|
5. Scope expansion is needed beyond `<out_of_scope>` in `task.md`.
|
|
43
44
|
|
|
44
45
|
Exception: Do NOT halt if the change was explicitly authorized by the user
|
|
45
|
-
in the prompt/spec, or if it is a mandatory accompanying test or import update.
|
|
46
|
+
in the prompt/spec (under DELEGATED, fast-track, or skip permissions), or if it is a mandatory accompanying test or import update.
|
|
46
47
|
</escalation_triggers>
|
|
47
48
|
|
|
48
49
|
---
|
package/templates/en/AGENTS.md
CHANGED
|
@@ -36,6 +36,12 @@
|
|
|
36
36
|
<!-- Pillar 1: Task & Specification -->
|
|
37
37
|
<pillar id="task_spec" title="Task & Specification">
|
|
38
38
|
<rule>Single Source of Truth: Active task file in [`process/features/active/{feature}/task.md`](process/features/) or [`process/general-plans/active/{task}/task.md`](process/general-plans/) (instantiated from [`process/_seeds/task-template.md.seed`](process/_seeds/task-template.md.seed)).</rule>
|
|
39
|
+
<rule>Prompt & Slash Command Initialization: Users can request and run tasks directly via prompt or pseudo-slash command prefixes. The Agent automatically routes the folder and instantiates `task.md` from [`process/_seeds/task-template.md.seed`](process/_seeds/task-template.md.seed):
|
|
40
|
+
- Commands `/feature`, `/big-task`, `/epic` or keywords `big task`, `feature`, `big changes`: routes to `process/features/active/{task-slug}/task.md` (PAIR mode).
|
|
41
|
+
- Commands `/task`, `/small-task`, `/bug` or keywords `small task`, `general changes`, `small changes`: routes to `process/general-plans/active/{task-slug}/task.md` (PAIR mode).
|
|
42
|
+
- Command `/hotfix`: routes to `process/general-plans/active/{task-slug}/task.md` and runs in DELEGATED mode.
|
|
43
|
+
- Commands `/fast-track`, `/delegated`: executes autonomously through all phases.
|
|
44
|
+
The Agent creates the directory, hydrates `<goal>` and `<acceptance_criteria>` from the prompt, and initiates the RESEARCH phase immediately.</rule>
|
|
39
45
|
<rule>Define changes via Goal, Current Behavior, Expected Behavior, Invariants, and `<out_of_scope>`.</rule>
|
|
40
46
|
<rule>Acceptance Criteria (AC) must be unambiguous, verifiable markdown checkboxes (`- [ ]`).</rule>
|
|
41
47
|
<rule>Every task has a master contract (`task.md`) and a full artifact chain: `research.md → decision.md → plan.md → state.md → review.md → handoff.md`.</rule>
|
|
@@ -69,6 +75,12 @@
|
|
|
69
75
|
|
|
70
76
|
<riper5_protocol>
|
|
71
77
|
|
|
78
|
+
<!-- ─────────────────── WORKING MODES ─────────────────── -->
|
|
79
|
+
<working_modes>
|
|
80
|
+
<mode id="PAIR" default="true">Step-by-step collaboration. Halts after each phase for human engineer review and gate sign-off.</mode>
|
|
81
|
+
<mode id="DELEGATED" alias="fast-track,autonomous,skip-permissions">Autonomous delegation. When task.md has working_mode=DELEGATED or the user specifies fast-track / skip permissions, the agent auto-certifies qualifying gates ([AUTO: DELEGATED]), advances task.md current_phase, and executes continuously without pausing for "next phase" prompts.</mode>
|
|
82
|
+
</working_modes>
|
|
83
|
+
|
|
72
84
|
<!-- ─────────────────── PHASE CONSTRAINTS ─────────────────── -->
|
|
73
85
|
|
|
74
86
|
<phase name="RESEARCH" order="1">
|
|
@@ -76,15 +88,16 @@
|
|
|
76
88
|
<constraint>No implementation decisions.</constraint>
|
|
77
89
|
<constraint>No architectural choices.</constraint>
|
|
78
90
|
<output>Produce/update `research.md`. Classify evidence as Confirmed / Observed / Hypothesized.</output>
|
|
79
|
-
<gate id="G0">All Research Exit Criteria in `research.md` checked before advancing.</gate>
|
|
91
|
+
<gate id="G0">All Research Exit Criteria in `research.md` checked before advancing. In DELEGATED / Fast-Track, the agent auto-certifies and advances to INNOVATE immediately.</gate>
|
|
80
92
|
</phase>
|
|
81
93
|
|
|
82
94
|
<phase name="INNOVATE" order="2">
|
|
83
95
|
<constraint>READ-ONLY. No source-code modifications.</constraint>
|
|
84
|
-
<constraint>Present 2–3 viable options with trade-off matrix
|
|
85
|
-
<constraint>
|
|
86
|
-
<
|
|
87
|
-
<
|
|
96
|
+
<constraint>Present 2–3 viable options with trade-off matrix.</constraint>
|
|
97
|
+
<constraint>PAIR mode: Leave `<engineer_decision>` blank for the human engineer to review and complete.</constraint>
|
|
98
|
+
<constraint>DELEGATED / Fast-Track mode: Automatically adopt the optimal Recommendation, record rationale with `[AUTO: DELEGATED]`, sign Gate 1, and immediately advance to PLAN.</constraint>
|
|
99
|
+
<output>Produce `decision.md`.</output>
|
|
100
|
+
<gate id="G1">Gate 1 in `decision.md` signed by engineer (PAIR) or auto-certified by agent with `[AUTO: DELEGATED]` (DELEGATED/Fast-Track) before advancing to Plan.</gate>
|
|
88
101
|
</phase>
|
|
89
102
|
|
|
90
103
|
<phase name="PLAN" order="3">
|
|
@@ -92,7 +105,7 @@
|
|
|
92
105
|
<constraint>Every slice must have a defined verifier, expected evidence, and rollback point.</constraint>
|
|
93
106
|
<constraint>Scope contract (allowed / forbidden files) must be explicit.</constraint>
|
|
94
107
|
<output>Produce `plan.md`. Populate Verification Matrix headers.</output>
|
|
95
|
-
<gate id="G2">Gate 2 in `plan.md`
|
|
108
|
+
<gate id="G2">Gate 2 in `plan.md` signed by engineer (PAIR) or auto-certified by agent with `[AUTO: DELEGATED]` (DELEGATED/Fast-Track) before advancing to Execute.</gate>
|
|
96
109
|
</phase>
|
|
97
110
|
|
|
98
111
|
<phase name="EXECUTE" order="4">
|
|
@@ -100,7 +113,7 @@
|
|
|
100
113
|
<constraint>One slice at a time. Run verifier after each slice. Inspect diff after each slice.</constraint>
|
|
101
114
|
<constraint>No unrelated refactoring. No changes to forbidden files.</constraint>
|
|
102
115
|
<constraint>Update `state.md` after every slice.</constraint>
|
|
103
|
-
<output>Source code + tests + updated `state.md` with verification evidence.</output>
|
|
116
|
+
<output>Source code + tests + updated `state.md` with verification evidence. When all slices pass, advance directly to REVIEW.</output>
|
|
104
117
|
</phase>
|
|
105
118
|
|
|
106
119
|
<phase name="REVIEW" order="5">
|
|
@@ -108,7 +121,7 @@
|
|
|
108
121
|
<constraint>No code fixes during review. Log findings in `review.md` instead.</constraint>
|
|
109
122
|
<constraint>Cover: behavior, architecture, data, security, regression.</constraint>
|
|
110
123
|
<output>Produce `review.md` with findings classified by category/severity/type and Gate 3 checklist.</output>
|
|
111
|
-
<gate id="G3">Gate 3 in `review.md`
|
|
124
|
+
<gate id="G3">Gate 3 in `review.md` must PASS before handoff. In DELEGATED mode, the agent performs full audit, creates `handoff.md`, moves task to `completed/`, and reports completion.</gate>
|
|
112
125
|
</phase>
|
|
113
126
|
|
|
114
127
|
<!-- Behavior rules (mode declaration, retry, escalation, completion gate) →
|
|
@@ -36,6 +36,7 @@ process/
|
|
|
36
36
|
│ ├── orchestration.md # Subagent delegation rules
|
|
37
37
|
│ └── implementation-standards.md # Typing, linting, and testing standards
|
|
38
38
|
├── features/ # Domain features (≥5 files / ≥3 phases)
|
|
39
|
+
│ # Prompt keywords: "big task", "feature", "big changes", "epic"...
|
|
39
40
|
│ ├── active/ # Active task workspaces: {CHG-ID}-{task-slug}/
|
|
40
41
|
│ │ └── CHG-XXX-example/ # One folder per task
|
|
41
42
|
│ │ ├── task.md # Master contract & state record
|
|
@@ -50,7 +51,8 @@ process/
|
|
|
50
51
|
│ │ └── cancelled.md # (If aborted) Cancellation findings & rollback status
|
|
51
52
|
│ ├── completed/ # Archived task workspaces
|
|
52
53
|
│ └── backlog/ # Backlog notes: {note_slug}_NOTE_{dd-mm-yy}.md
|
|
53
|
-
└── general-plans/ # Cross-cutting & standalone tasks
|
|
54
|
+
└── general-plans/ # Cross-cutting & standalone tasks (<5 files)
|
|
55
|
+
# Prompt keywords: "small task", "general changes", "small changes", "bug fix"...
|
|
54
56
|
├── active/
|
|
55
57
|
├── completed/
|
|
56
58
|
└── backlog/
|
|
@@ -71,16 +73,16 @@ flowchart TD
|
|
|
71
73
|
Task --> Res["research.md"] --> G0{"Gate G0 (Auto)"}
|
|
72
74
|
end
|
|
73
75
|
subgraph I2["2. INNOVATE (Read-Only)"]
|
|
74
|
-
G0 --> Dec["decision.md (2-3 Options)"] --> G1{"Gate G1 (
|
|
76
|
+
G0 --> Dec["decision.md (2-3 Options)"] --> G1{"Gate G1 (Engineer or Auto-DELEGATED)"}
|
|
75
77
|
end
|
|
76
78
|
subgraph P3["3. PLAN (Plan-Only)"]
|
|
77
|
-
G1 --> Plan["plan.md (Vertical Slices)"] --> G2{"Gate G2 (
|
|
79
|
+
G1 --> Plan["plan.md (Vertical Slices)"] --> G2{"Gate G2 (Engineer or Auto-DELEGATED)"}
|
|
78
80
|
end
|
|
79
81
|
subgraph E4["4. EXECUTE (Scoped R/W)"]
|
|
80
82
|
G2 --> Code["Implement Slice"] --> Test["Run Verifiers"] --> State["state.md (Memory)"]
|
|
81
83
|
end
|
|
82
84
|
subgraph R5["5. REVIEW (Read-Only)"]
|
|
83
|
-
State --> Rev["review.md (Audit)"] --> G3{"Gate G3 (
|
|
85
|
+
State --> Rev["review.md (Audit)"] --> G3{"Gate G3 (Engineer or Auto-DELEGATED)"}
|
|
84
86
|
end
|
|
85
87
|
subgraph Done["6. COMPLETE"]
|
|
86
88
|
G3 --> Arch["Move to completed/"] --> Handoff["handoff.md"]
|
|
@@ -90,13 +92,22 @@ flowchart TD
|
|
|
90
92
|
```text
|
|
91
93
|
task.md ← (always) Master contract, RIPER phase/gate state, AC, decisions
|
|
92
94
|
research.md ← (Research) Execution flow, evidence, boundaries
|
|
93
|
-
decision.md ← (Innovate) Options, trade-offs, Gate 1
|
|
94
|
-
plan.md ← (Plan) Slices, verifiers, scope contract, Gate 2
|
|
95
|
+
decision.md ← (Innovate) Options, trade-offs, Gate 1 (Engineer approval or Auto-DELEGATED)
|
|
96
|
+
plan.md ← (Plan) Slices, verifiers, scope contract, Gate 2 (Engineer sign-off or Auto-DELEGATED)
|
|
95
97
|
state.md ← (Execute) Per-slice progress, failure memory, retry budget
|
|
96
|
-
review.md ← (Review) Findings, verification matrix, Gate 3
|
|
98
|
+
review.md ← (Review) Findings, verification matrix, Gate 3 (PASS)
|
|
97
99
|
handoff.md ← (Complete) Short final projection
|
|
98
100
|
```
|
|
99
101
|
|
|
102
|
+
### Task Initialization: Prompt-Driven vs Manual
|
|
103
|
+
|
|
104
|
+
Users can initiate tasks through two methods:
|
|
105
|
+
1. **Prompt & Slash Command Initialization (Recommended):** Provide your task requirements directly in the prompt using pseudo-slash commands or natural keywords. The Agent automatically scaffolds the workspace under `active/`, instantiates `task-template.md.seed` $\rightarrow$ `task.md`, hydrates specification tags, and immediately kicks off `RESEARCH`:
|
|
106
|
+
- **`process/features/active/{task-slug}/`**: Triggered by commands `/feature`, `/big-task`, `/epic` or keywords `big task`, `feature`, `big changes`. For large, domain-specific features (≥5 files, multiple phases).
|
|
107
|
+
- **`process/general-plans/active/{task-slug}/`**: Triggered by commands `/task`, `/small-task`, `/bug`, `/quick-fix` or keywords `small task`, `general changes`, `small changes`. For standalone tasks and quick fixes (<5 files).
|
|
108
|
+
- **Special Commands**: `/hotfix` (emergency bugfix, runs in DELEGATED mode), `/fast-track` (runs autonomously across all phases).
|
|
109
|
+
2. **Manual Terminal Setup:** Manually run `mkdir -p process/.../active/{slug}` and `cp process/_seeds/task-template.md.seed process/.../active/{slug}/task.md` before prompting the Agent.
|
|
110
|
+
|
|
100
111
|
### Concept → Artifact mapping
|
|
101
112
|
|
|
102
113
|
| Concept | Artifact |
|
|
@@ -130,14 +141,14 @@ handoff.md ← (Complete) Short final projection
|
|
|
130
141
|
</phase>
|
|
131
142
|
|
|
132
143
|
<phase order="2" name="Innovate">
|
|
133
|
-
READ-ONLY. Present 2–3 options with trade-off matrix.
|
|
134
|
-
Produce `decision.md`. Engineer approves
|
|
144
|
+
READ-ONLY. Present 2–3 options with trade-off matrix.
|
|
145
|
+
Produce `decision.md`. Gate 1: Engineer approves (PAIR mode) or Agent auto-certifies optimal recommendation [AUTO: DELEGATED] (DELEGATED/Fast-Track mode).
|
|
135
146
|
</phase>
|
|
136
147
|
|
|
137
148
|
<phase order="3" name="Plan">
|
|
138
149
|
Plan artifacts only — no source changes.
|
|
139
150
|
Decompose into vertical slices with verifiers, rollback points, and scope contract.
|
|
140
|
-
Produce `plan.md`. Engineer approves
|
|
151
|
+
Produce `plan.md`. Gate 2: Engineer approves (PAIR mode) or Agent auto-certifies scope contract [AUTO: DELEGATED] (DELEGATED/Fast-Track mode).
|
|
141
152
|
</phase>
|
|
142
153
|
|
|
143
154
|
<phase order="4" name="Execute">
|
|
@@ -147,7 +158,7 @@ handoff.md ← (Complete) Short final projection
|
|
|
147
158
|
|
|
148
159
|
<phase order="5" name="Review">
|
|
149
160
|
READ-ONLY. May run verification commands. No code fixes.
|
|
150
|
-
Produce `review.md` with findings. Gate 3 must pass before handoff.
|
|
161
|
+
Produce `review.md` with findings. Gate 3 must pass before handoff. Under DELEGATED mode, Agent auto-completes housekeeping and creates `handoff.md`.
|
|
151
162
|
</phase>
|
|
152
163
|
</operational_phases>
|
|
153
164
|
|
|
@@ -170,6 +181,7 @@ To prevent mechanical, cargo-cult usage of the framework, the template architect
|
|
|
170
181
|
* Machine-Readable Contract: Enforces unambiguous semantic boundaries that LLMs parse reliably, strictly constraining AI write access.
|
|
171
182
|
|
|
172
183
|
### 2. The Operational "HOW" — Execution Principles
|
|
184
|
+
* **Prompt-Driven Task Initialization:** Eliminates the friction of running terminal commands or manual file copies. Users simply specify task prompts with keywords (`big task`, `feature`, `big changes` for `features/active/`; `small task`, `general changes`, `small changes` for `general-plans/active/`). The Agent detects the scope, scaffolds the folder, instantiates `task-template.md.seed`, populates `task.md`, and initiates execution immediately.
|
|
173
185
|
* **Copy-On-Demand:** Never bulk-copy all seeds into a task folder upfront. Start with `task.md`, then instantiate `research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md` sequentially as phases advance.
|
|
174
186
|
* **Stateless Chat, Stateful Workspace:** Sessions can reset and chats can close. All operational progress and error memory (`<failure_memory>`) are recorded on disk (`state.md`), allowing any new session to resume with 100% fidelity.
|
|
175
187
|
* **Selective Knowledge Crystallization:** Upon completion, summarize the task in `handoff.md`. Only promote reusable architectural standards or schema contracts into `process/context/` and `all-context.md`.
|
|
@@ -12,7 +12,8 @@
|
|
|
12
12
|
### Seeds Architectural Rationale: Understanding "Why" & "How"
|
|
13
13
|
* **Why the `.seed` extension? (Why):** The `.seed` suffix acts as an immutable boundary. It prevents automated AI discovery tools (`find`, `grep`) from confusing archetype templates with active `*.md` task files. This guarantees agents will never accidentally overwrite master blueprints during execution.
|
|
14
14
|
* **Why separate seeds per phase? (Why):** Each phase of RIPER-5 requires a distinct cognitive posture and permission boundary (Research vs Innovate vs Plan vs Execute vs Review). Splitting archetypes prevents context window bloat (Anti-Context Saturation), avoids hallucinations, and anchors each Quality Gate (G1–G3) to an auditable physical artifact.
|
|
15
|
-
* **Copy-On-Demand Protocol (How):** Never bulk-copy all seeds into a task directory. Start exclusively with `task.md`. Sequentially instantiate subsequent artifacts (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`) only as the task progresses into each phase.
|
|
15
|
+
* **Copy-On-Demand Protocol (How):** Never bulk-copy all seeds into a task directory. Start exclusively with `task.md`. Sequentially instantiate subsequent artifacts (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`) only as the task progresses into each phase. In PAIR mode, the agent pauses for human gate approvals; in DELEGATED / Fast-Track mode, the agent auto-instantiates subsequent seeds, auto-certifies gates, and executes continuously without interruptions.
|
|
16
|
+
* **Prompt-Driven Task Initialization (How):** Eliminates the friction of manual terminal commands. Users simply issue a prompt containing routing keywords: `big task`, `feature`, `big changes` (for `features/active/`) or `small task`, `general changes`, `small changes` (for `general-plans/active/`). The Agent automatically creates the directory, copies the seed blueprint, hydrates `<goal>` and criteria, and kicks off execution.
|
|
16
17
|
</architectural_rationale>
|
|
17
18
|
|
|
18
19
|
---
|
|
@@ -23,7 +24,7 @@
|
|
|
23
24
|
|
|
24
25
|
<seed type="task" path="task-template.md.seed">
|
|
25
26
|
Master contract and state record for the full RIPER-5 lifecycle.
|
|
26
|
-
Contains: Task Control metadata, Spec, Context Boundaries, Verification Strategy,
|
|
27
|
+
Contains: Task Control metadata (working_mode PAIR/DELEGATED), Spec, Context Boundaries, Verification Strategy,
|
|
27
28
|
Decisions, RIPER-5 Execution Plan (with Gates G0–G3), and Guardrails.
|
|
28
29
|
</seed>
|
|
29
30
|
|
|
@@ -38,7 +39,7 @@
|
|
|
38
39
|
<seed type="decision" path="decision-template.md.seed">
|
|
39
40
|
Innovate phase artifact. Gate 1 memory.
|
|
40
41
|
Contains: Decision question, Options (A/B/C) with trade-off matrix,
|
|
41
|
-
Recommendation,
|
|
42
|
+
Recommendation, Implementation Decision (filled by engineer in PAIR, or auto-selected in DELEGATED), Constraints Created,
|
|
42
43
|
Evidence Still Required, and Gate 1 checklist.
|
|
43
44
|
</seed>
|
|
44
45
|
|
|
@@ -125,9 +126,9 @@ handoff.md ← Final projection (short)
|
|
|
125
126
|
| Cancellation | `cancelled.md` (knowledge preservation upon abort) |
|
|
126
127
|
| Benchmark / Metrics | `results.tsv` (performance and eval metrics) |
|
|
127
128
|
| Program | `program.md` (multi-phase umbrella epic blueprint) |
|
|
128
|
-
| Gate 1 | `decision.md` approval |
|
|
129
|
-
| Gate 2 | `plan.md` approval |
|
|
130
|
-
| Gate 3 | `review.md` approval |
|
|
129
|
+
| Gate 1 | `decision.md` approval (Engineer or Auto-DELEGATED) |
|
|
130
|
+
| Gate 2 | `plan.md` approval (Engineer or Auto-DELEGATED) |
|
|
131
|
+
| Gate 3 | `review.md` approval (Engineer or Auto-DELEGATED) |
|
|
131
132
|
|
|
132
133
|
---
|
|
133
134
|
|
|
@@ -162,7 +163,17 @@ Not all artifacts are required at start. Create them progressively as the task a
|
|
|
162
163
|
|
|
163
164
|
---
|
|
164
165
|
|
|
165
|
-
## 4. Instantiation Commands
|
|
166
|
+
## 4. Instantiation Methods: Prompt-Driven vs Manual Commands
|
|
167
|
+
|
|
168
|
+
### Method 1: Prompt & Slash Command Initialization (Recommended)
|
|
169
|
+
Instead of manually executing terminal commands, you can initiate a task directly through your prompt using convenient slash prefixes (**Pseudo-Slash Commands**) or natural keywords:
|
|
170
|
+
- **`process/features/active/{task-slug}/`**: Use commands `/feature`, `/big-task`, `/epic` or keywords `big task`, `feature`, `big changes`, `epic`.
|
|
171
|
+
- **`process/general-plans/active/{task-slug}/`**: Use commands `/task`, `/small-task`, `/bug`, `/quick-fix` or keywords `small task`, `general changes`, `small changes`.
|
|
172
|
+
- **Special Command**: `/hotfix` (emergency production bugfix, automatically triggers DELEGATED mode).
|
|
173
|
+
|
|
174
|
+
The Agent will automatically create the required directory, copy `task-template.md.seed` $\rightarrow$ `task.md`, hydrate `<goal>` and `<acceptance_criteria>` from your prompt, and begin the Research phase immediately.
|
|
175
|
+
|
|
176
|
+
### Method 2: Manual Terminal Commands (Copy Commands)
|
|
166
177
|
|
|
167
178
|
```bash
|
|
168
179
|
# Create a new task workspace
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
<technical_decision task_id="[TASK-ID]" dec_id="[DEC-ID]" version="1.0" framework="RIPER-5">
|
|
4
4
|
|
|
5
|
-
<!-- READ-ONLY PHASE. Present options.
|
|
5
|
+
<!-- READ-ONLY PHASE. Present options. PAIR: engineer decides. DELEGATED: agent auto-selects optimal recommendation and advances. -->
|
|
6
6
|
<decision_status>
|
|
7
7
|
<phase>INNOVATE</phase>
|
|
8
8
|
<mode>READ-ONLY</mode>
|
|
@@ -98,9 +98,11 @@
|
|
|
98
98
|
|
|
99
99
|
---
|
|
100
100
|
|
|
101
|
-
## 6.
|
|
101
|
+
## 6. Implementation Decision
|
|
102
102
|
|
|
103
|
-
<!--
|
|
103
|
+
<!-- PAIR mode: Completed by engineer before Gate 1 passes.
|
|
104
|
+
DELEGATED / Fast-Track mode: Agent automatically populates Recommendation
|
|
105
|
+
into <selected_option>, documents rationale, signs Gate 1 with [AUTO: DELEGATED], and proceeds. -->
|
|
104
106
|
<engineer_decision>
|
|
105
107
|
<selected_option></selected_option>
|
|
106
108
|
<rationale></rationale>
|
|
@@ -133,10 +135,9 @@
|
|
|
133
135
|
|
|
134
136
|
<gate id="G1">
|
|
135
137
|
- [ ] All options presented and trade-offs analyzed.
|
|
136
|
-
- [ ]
|
|
137
|
-
- [ ] Engineer selected option recorded above.
|
|
138
|
+
- [ ] Selected option recorded above.
|
|
138
139
|
- [ ] No blocking business / schema / security decision remains open.
|
|
139
|
-
<approved_by></approved_by>
|
|
140
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
140
141
|
<approved_date></approved_date>
|
|
141
142
|
</gate>
|
|
142
143
|
|
|
@@ -127,8 +127,8 @@
|
|
|
127
127
|
- [ ] Stop conditions defined per slice.
|
|
128
128
|
- [ ] Rollback point defined per slice.
|
|
129
129
|
- [ ] Allowed commands listed.
|
|
130
|
-
- [ ]
|
|
131
|
-
<approved_by></approved_by>
|
|
130
|
+
- [ ] Plan approved.
|
|
131
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
132
132
|
<approved_date></approved_date>
|
|
133
133
|
</gate>
|
|
134
134
|
|
|
@@ -142,7 +142,7 @@
|
|
|
142
142
|
- [ ] Residual risk explicitly accepted.
|
|
143
143
|
- [ ] Review decision: PASS.
|
|
144
144
|
- [ ] Ready for handoff.
|
|
145
|
-
<approved_by></approved_by>
|
|
145
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
146
146
|
<approved_date></approved_date>
|
|
147
147
|
</gate>
|
|
148
148
|
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
<priority>P2</priority> <!-- P0=urgent | P1=high | P2=normal | P3=low -->
|
|
12
12
|
<risk>MEDIUM</risk> <!-- LOW | MEDIUM | HIGH -->
|
|
13
13
|
<estimated_story_points>2</estimated_story_points> <!-- 1 SP ≈ 2-4 focused engineering hours -->
|
|
14
|
-
<working_mode>PAIR</working_mode> <!--
|
|
14
|
+
<working_mode>PAIR</working_mode> <!-- PAIR (default: halts at each gate for review) | DELEGATED (fast-track: continuous autonomous run) | MANUAL | DIAGNOSE-ONLY -->
|
|
15
15
|
<current_phase>RESEARCH</current_phase> <!-- RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW -->
|
|
16
16
|
<owner>@engineer</owner>
|
|
17
17
|
<decision_owner>@engineer</decision_owner>
|
|
@@ -124,18 +124,19 @@
|
|
|
124
124
|
- [ ] Current behavior understood and documented.
|
|
125
125
|
- [ ] Execution flow traced.
|
|
126
126
|
- [ ] No unresolved research blocker.
|
|
127
|
+
<!-- In DELEGATED / Fast-Track mode: Agent auto-certifies and advances to Innovate immediately -->
|
|
127
128
|
</gate>
|
|
128
129
|
</phase>
|
|
129
130
|
|
|
130
131
|
<phase name="Innovate" order="2">
|
|
131
|
-
<!-- READ-ONLY. Present 2-3 viable options.
|
|
132
|
+
<!-- READ-ONLY. Present 2-3 viable options. PAIR: engineer selects. DELEGATED: agent auto-selects optimal option. -->
|
|
132
133
|
- [ ] Generate 2–3 alternative approaches with trade-off matrix.
|
|
133
134
|
- [ ] Produce `decision.md` artifact.
|
|
134
135
|
<gate id="G1" label="Gate 1 — Decision Approved">
|
|
135
|
-
- [ ] Options reviewed
|
|
136
|
+
- [ ] Options reviewed and trade-offs analyzed.
|
|
136
137
|
- [ ] Selected option recorded in `decision.md`.
|
|
137
138
|
- [ ] No blocking business/schema/security decision remains open.
|
|
138
|
-
<approved_by></approved_by>
|
|
139
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
139
140
|
<approved_date></approved_date>
|
|
140
141
|
</gate>
|
|
141
142
|
</phase>
|
|
@@ -149,8 +150,8 @@
|
|
|
149
150
|
- [ ] Allowed/forbidden file scope is defined.
|
|
150
151
|
- [ ] Rollback point defined per slice.
|
|
151
152
|
- [ ] Stop conditions defined.
|
|
152
|
-
- [ ]
|
|
153
|
-
<approved_by></approved_by>
|
|
153
|
+
- [ ] Plan approved.
|
|
154
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
154
155
|
<approved_date></approved_date>
|
|
155
156
|
</gate>
|
|
156
157
|
</phase>
|
|
@@ -171,9 +172,9 @@
|
|
|
171
172
|
<gate id="G3" label="Gate 3 — Review Passed">
|
|
172
173
|
- [ ] All AC verified with evidence.
|
|
173
174
|
- [ ] Residual risk accepted.
|
|
174
|
-
- [ ] Review decision: PASS
|
|
175
|
+
- [ ] Review decision: PASS.
|
|
175
176
|
- [ ] Ready for handoff.
|
|
176
|
-
<approved_by></approved_by>
|
|
177
|
+
<approved_by></approved_by> <!-- Engineer name (PAIR) or [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
177
178
|
<approved_date></approved_date>
|
|
178
179
|
</gate>
|
|
179
180
|
</phase>
|
|
@@ -25,9 +25,73 @@ Mọi phản hồi thúc đẩy tiến độ task BẮT BUỘC phải mở đầ
|
|
|
25
25
|
Chỉ lược bỏ khai báo mode đối với các trao đổi mang tính đàm thoại thuần túy không
|
|
26
26
|
làm thay đổi tiến độ task (ví dụ: giải đáp câu hỏi kỹ thuật, làm rõ phạm vi yêu cầu).
|
|
27
27
|
|
|
28
|
+
Trong chế độ chạy liên tục (DELEGATED / Fast-Track), Agent mở đầu bằng mode của phase khởi động. Khi hoàn tất một phase và tự động chuyển sang phase tiếp theo trong cùng lượt phản hồi, Agent chèn phân cách chuyển mode rõ ràng:
|
|
29
|
+
`>>> [PHASE TRANSITION: <PHASE_CŨ> -> <PHASE_MỚI>]` và tiếp tục thực thi dưới mode mới ngay lập tức mà không dừng lại.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. Chế Độ Làm Việc & Giao Thức Chuyển Giai Đoạn (Working Modes & Transitions)
|
|
34
|
+
|
|
35
|
+
<working_modes_protocol>
|
|
36
|
+
Phương thức làm việc được quy định tại thẻ `<working_mode>` trong `task.md` hoặc qua chỉ thị của người dùng trong prompt:
|
|
37
|
+
|
|
38
|
+
### Chế độ PAIR (Mặc định — Hợp tác từng bước):
|
|
39
|
+
- Agent thực hiện từng phase một.
|
|
40
|
+
- Khi hoàn thành phase, cập nhật artifact tương ứng và **DỪNG LẠI** để kỹ sư con người kiểm tra, thảo luận và ký duyệt Gate (G1, G2, G3).
|
|
41
|
+
- Chờ người dùng ra lệnh "Bắt đầu phase tiếp theo" mới chuyển `<current_phase>` trong `task.md` và tiếp tục.
|
|
42
|
+
|
|
43
|
+
### Chế độ DELEGATED (Tự trị / Fast-Track / Skip Permissions):
|
|
44
|
+
- **Điều kiện kích hoạt:** `<working_mode>DELEGATED</working_mode>` trong `task.md` HOẶC người dùng chỉ thị rõ: "fast-track", "skip permissions", "tự động chạy", "chạy hết các phase", "autonomous".
|
|
45
|
+
- **Quy tắc vàng:** **TUYỆT ĐỐI KHÔNG DỪNG LẠI GIỮA CÁC PHASE ĐỂ ĐỢI PROMPT "TIẾP THEO".**
|
|
46
|
+
- **Quy trình tự động chuyển tiếp liên tục:**
|
|
47
|
+
1. Khi phase hiện tại hoàn thành đủ tiêu chuẩn thoát (exit criteria/checklist), Agent tự động tích chọn `- [x]`.
|
|
48
|
+
2. Điền thông tin tự động phê duyệt vào artifact: `approved_by: [AUTO: DELEGATED]` kèm ngày giờ và căn cứ kỹ thuật (ở INNOVATE: tự chọn phương án Recommendation tối ưu; ở PLAN: tự khóa hợp đồng phạm vi file).
|
|
49
|
+
3. Cập nhật ngay `<current_phase>` trong `task.md` sang phase kế tiếp (`RESEARCH` → `INNOVATE` → `PLAN` → `EXECUTE` → `REVIEW`).
|
|
50
|
+
4. Khởi tạo artifact seed của phase kế tiếp (Copy-On-Demand) và **TIẾP TỤC THỰC THI NGAY LẬP TỨC** trong cùng phiên làm việc.
|
|
51
|
+
- **Điều kiện dừng duy nhất trong DELEGATED:**
|
|
52
|
+
- Task đã hoàn thành 100% (Gate 3 PASS, dọn dẹp housekeeping sạch sẽ, tạo `handoff.md`, chuyển sang `completed/`).
|
|
53
|
+
- HOẶC chạm một trong các Điều Kiện Dừng Khẩn Cấp thực sự (Escalation Triggers trong `guardrails.md`: hết retry budget 3 lần cho cùng 1 lỗi, lệnh phá hủy nguy hiểm, hoặc mâu thuẫn trực tiếp ngoài phạm vi task).
|
|
54
|
+
|
|
55
|
+
### Chế độ MANUAL & DIAGNOSE-ONLY:
|
|
56
|
+
- `MANUAL`: Người dùng trực tiếp dẫn dắt từng lệnh, Agent chỉ đóng vai trò hỗ trợ cục bộ.
|
|
57
|
+
- `DIAGNOSE-ONLY`: Chỉ chạy Research & Review để chẩn đoán/kiểm toán lỗi mà không chỉnh sửa mã nguồn.
|
|
58
|
+
</working_modes_protocol>
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 3. Giao Thức Khởi Tạo Task Qua Prompt (Prompt-Driven Task Initialization)
|
|
63
|
+
|
|
64
|
+
<prompt_task_initialization>
|
|
65
|
+
Khi người dùng yêu cầu thực hiện một task mới thông qua prompt (chưa có sẵn thư mục task hay `task.md` trong `active/`), Agent **KHÔNG** yêu cầu người dùng phải gõ lệnh terminal hay sao chép tệp seed thủ công. Thay vào đó, Agent tự động nhận diện từ khóa trong prompt, định tuyến thư mục và khởi tạo `task.md`:
|
|
66
|
+
|
|
67
|
+
### Bảng Điều Hướng Thư Mục Qua Từ Khóa & Cú Pháp Pseudo-Slash Commands:
|
|
68
|
+
|
|
69
|
+
Người dùng có thể gõ bằng ngôn ngữ tự nhiên HOẶC dùng cú pháp lệnh gạch chéo tiện lợi (**Pseudo-Slash Commands**) ở ngay đầu prompt:
|
|
70
|
+
|
|
71
|
+
| Thư mục đích | Lệnh Slash (Khuyến nghị) | Từ khóa tự nhiên (Keywords) | Tiêu chí phạm vi & Chế độ |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| **`process/features/active/{task-slug}/`** | `/feature`<br>`/big-task`<br>`/epic` | `big task`, `feature`, `big changes`, `epic` (hoặc: `task lớn`, `tính năng`, `thay đổi lớn`, `chức năng mới`) | Tính năng lớn, theo domain, thay đổi kiến trúc (≥ 5 files, nhiều phase). Chế độ mặc định: **PAIR**. |
|
|
74
|
+
| **`process/general-plans/active/{task-slug}/`** | `/task`<br>`/small-task`<br>`/bug`<br>`/quick-fix` | `small task`, `general changes`, `small changes`, `bug fix`, `quick fix` (hoặc: `task nhỏ`, `thay đổi chung`, `thay đổi nhỏ`, `sửa lỗi`) | Tác vụ độc lập, sửa bug nhanh, thay đổi nhỏ (< 5 files). Chế độ mặc định: **PAIR**. |
|
|
75
|
+
| **`process/general-plans/active/{task-slug}/`** | `/hotfix` | `hotfix`, `khẩn cấp`, `emergency fix` | Sửa lỗi khẩn cấp production. Tự động kích hoạt chế độ **DELEGATED / Fast-Track** (vượt tự động G0–G2, dừng ở G3). |
|
|
76
|
+
| *(Theo phạm vi)* | `/fast-track`<br>`/delegated`<br>`/auto` | `fast-track`, `autonomous`, `tự động chạy`, `skip permissions` | Chạy tự trị hoàn toàn. Tự động đặt `<working_mode>DELEGATED</working_mode>` và thực thi liên tục qua toàn bộ chu trình. |
|
|
77
|
+
|
|
78
|
+
*Quy tắc suy luận dự phòng (Fallback):* Nếu prompt không chứa từ khóa hay slash command rõ ràng, Agent tự động ước lượng quy mô công việc (< 5 files hoặc sửa lỗi cục bộ $\rightarrow$ `general-plans/`; tính năng mới hoặc ảnh hưởng diện rộng $\rightarrow$ `features/`).
|
|
79
|
+
|
|
80
|
+
### Quy Trình Khởi Tạo & Kích Hoạt Tự Động:
|
|
81
|
+
1. **Đặt tên slug:** Đặt `{task-slug}` ngắn gọn, chuẩn kebab-case dựa theo yêu cầu (ví dụ: `CHG-001-change-password`, `AUTH-002-rate-limiting`, hoặc `{TICKET-ID}-{slug}`).
|
|
82
|
+
2. **Tạo thư mục:** Tạo thư mục `process/features/active/{task-slug}` hoặc `process/general-plans/active/{task-slug}`.
|
|
83
|
+
3. **Sao chép phôi mẫu seed:** Sao chép `process/_seeds/task-template.md.seed` vào `{thư-mục-task}/task.md`.
|
|
84
|
+
4. **Điền thông tin đặc tả (Hydration):**
|
|
85
|
+
- Trích xuất mục tiêu yêu cầu vào `<goal>`.
|
|
86
|
+
- Phân rã các yêu cầu người dùng thành danh sách kiểm tra checkbox `- [ ]` trong `<acceptance_criteria>`.
|
|
87
|
+
- Thiết lập `<working_mode>` (`PAIR` mặc định, hoặc `DELEGATED` nếu prompt chỉ thị fast-track / autonomous).
|
|
88
|
+
- Thiết lập `<status>ACTIVE</status>` và `<current_phase>RESEARCH</current_phase>`.
|
|
89
|
+
5. **Khai báo mode & Bắt đầu ngay:** Mở đầu phản hồi bằng `[MODE: RESEARCH]`, thông báo ngắn gọn vị trí `task.md` đã khởi tạo và bắt đầu ngay pha Khảo sát (Research) mà không dừng lại hỏi xin phép thao tác sao chép.
|
|
90
|
+
</prompt_task_initialization>
|
|
91
|
+
|
|
28
92
|
---
|
|
29
93
|
|
|
30
|
-
##
|
|
94
|
+
## 4. Giao Thức Khởi Động Session (Session Startup Protocol)
|
|
31
95
|
|
|
32
96
|
Trước khi tiếp tục bất kỳ task đang dang dở nào, nạp lại trạng thái bền vững theo đúng thứ tự sau:
|
|
33
97
|
|
|
@@ -45,7 +109,7 @@ dựa trên các tệp artifact được liệt kê ở trên.
|
|
|
45
109
|
|
|
46
110
|
---
|
|
47
111
|
|
|
48
|
-
##
|
|
112
|
+
## 5. Quy Tắc Điều Hướng Ngữ Cảnh (Context Navigation Rules)
|
|
49
113
|
|
|
50
114
|
<context_rules>
|
|
51
115
|
<rule id="minimum_context">
|
|
@@ -39,10 +39,11 @@
|
|
|
39
39
|
chưa được khai báo trong kế hoạch đã duyệt.
|
|
40
40
|
3. Thay đổi cần thiết chạm vào tệp nằm ngoài phạm vi được định nghĩa trong `plan.md`.
|
|
41
41
|
4. Cần một quyết định nghiệp vụ hoặc chính sách chưa có trong `<approved_decisions>`.
|
|
42
|
+
(Ngoại lệ: Trong chế độ DELEGATED / Fast-Track, Agent được phép tự chọn phương án kỹ thuật được khuyến nghị trong `decision.md` miễn là không vi phạm `<invariants>` hay `<out_of_scope>`).
|
|
42
43
|
5. Cần mở rộng phạm vi ra ngoài mục `<out_of_scope>` trong `task.md`.
|
|
43
44
|
|
|
44
45
|
Ngoại lệ: KHÔNG dừng nếu thay đổi đã được người dùng ủy quyền rõ ràng
|
|
45
|
-
trong prompt/spec, hoặc nếu đó là tệp test đi kèm bắt buộc hay cập nhật import.
|
|
46
|
+
trong prompt/spec (chế độ DELEGATED, fast-track, skip permissions), hoặc nếu đó là tệp test đi kèm bắt buộc hay cập nhật import.
|
|
46
47
|
</escalation_triggers>
|
|
47
48
|
|
|
48
49
|
---
|
package/templates/vi/AGENTS.md
CHANGED
|
@@ -36,6 +36,12 @@
|
|
|
36
36
|
<!-- Trụ cột 1: Task & Specification -->
|
|
37
37
|
<pillar id="task_spec" title="Task & Đặc tả (Specification)">
|
|
38
38
|
<rule>Nguồn sự thật duy nhất (Single Source of Truth): Tệp task đang thực thi trong [`process/features/active/{feature}/task.md`](process/features/) hoặc [`process/general-plans/active/{task}/task.md`](process/general-plans/) (khởi tạo từ [`process/_seeds/task-template.md.seed`](process/_seeds/task-template.md.seed)).</rule>
|
|
39
|
+
<rule>Khởi tạo qua Prompt & Lệnh Gạch Chéo (Prompt & Slash Command Initialization): Người dùng có thể yêu cầu tạo và chạy task trực tiếp bằng prompt hoặc tiền tố lệnh gạch chéo (Pseudo-Slash Commands). Agent tự động định tuyến thư mục và khởi tạo `task.md` từ [`process/_seeds/task-template.md.seed`](process/_seeds/task-template.md.seed):
|
|
40
|
+
- Cú pháp `/feature`, `/big-task`, `/epic` hoặc các từ khóa `big task`, `feature`, `big changes`: định tuyến vào `process/features/active/{task-slug}/task.md` (chế độ PAIR).
|
|
41
|
+
- Cú pháp `/task`, `/small-task`, `/bug` hoặc các từ khóa `small task`, `general changes`, `small changes`: định tuyến vào `process/general-plans/active/{task-slug}/task.md` (chế độ PAIR).
|
|
42
|
+
- Cú pháp `/hotfix`: định tuyến vào `process/general-plans/active/{task-slug}/task.md` và chạy chế độ DELEGATED.
|
|
43
|
+
- Cú pháp `/fast-track`, `/delegated`: chạy tự trị liên tục qua toàn bộ chu trình.
|
|
44
|
+
Agent tự tạo thư mục, điền mục tiêu & tiêu chí AC từ prompt vào `task.md` và bắt đầu ngay pha RESEARCH.</rule>
|
|
39
45
|
<rule>Định nghĩa thay đổi thông qua Mục tiêu (Goal), Hành vi hiện tại (Current Behavior), Hành vi kỳ vọng (Expected Behavior), Bất biến (Invariants) và Ngoài phạm vi (`<out_of_scope>`).</rule>
|
|
40
46
|
<rule>Tiêu chí nghiệm thu (Acceptance Criteria - AC) phải rõ ràng, kiểm chứng được dưới dạng checkbox markdown (`- [ ]`).</rule>
|
|
41
47
|
<rule>Mỗi task đều có bản hợp đồng master (`task.md`) và chuỗi artifact hoàn chỉnh: `research.md → decision.md → plan.md → state.md → review.md → handoff.md`.</rule>
|
|
@@ -69,6 +75,12 @@
|
|
|
69
75
|
|
|
70
76
|
<riper5_protocol>
|
|
71
77
|
|
|
78
|
+
<!-- ─────────────────── CHẾ ĐỘ VẬN HÀNH (WORKING MODES) ─────────────────── -->
|
|
79
|
+
<working_modes>
|
|
80
|
+
<mode id="PAIR" default="true">Hợp tác từng bước. Dừng lại sau mỗi phase để kỹ sư kiểm tra và ký duyệt Gate tương ứng.</mode>
|
|
81
|
+
<mode id="DELEGATED" alias="fast-track,autonomous,skip-permissions">Ủy quyền tự trị. Khi task.md có working_mode=DELEGATED hoặc người dùng chỉ thị fast-track / skip permissions, Agent tự động nghiệm thu các Gate đạt chuẩn ([AUTO: DELEGATED]), tự động chuyển phase trong task.md và thực thi liên tục qua toàn bộ chu trình RIPER-5 mà KHÔNG dừng lại chờ lệnh "tiếp theo".</mode>
|
|
82
|
+
</working_modes>
|
|
83
|
+
|
|
72
84
|
<!-- ─────────────────── RÀNG BUỘC TỪNG GIAI ĐOẠN ─────────────────── -->
|
|
73
85
|
|
|
74
86
|
<phase name="RESEARCH" order="1">
|
|
@@ -76,15 +88,16 @@
|
|
|
76
88
|
<constraint>Không tự ý ra quyết định triển khai.</constraint>
|
|
77
89
|
<constraint>Không tự ý chọn lựa kiến trúc.</constraint>
|
|
78
90
|
<output>Tạo/cập nhật `research.md`. Phân loại bằng chứng thành Đã xác nhận (Confirmed) / Quan sát thấy (Observed) / Giả thuyết (Hypothesized).</output>
|
|
79
|
-
<gate id="G0">Đánh dấu đạt tất cả Tiêu chí rời khỏi Khảo sát (Research Exit Criteria) trong `research.md` trước khi chuyển tiếp.</gate>
|
|
91
|
+
<gate id="G0">Đánh dấu đạt tất cả Tiêu chí rời khỏi Khảo sát (Research Exit Criteria) trong `research.md` trước khi chuyển tiếp. Ở chế độ DELEGATED / Fast-Track, Agent tự động đánh giá và chuyển sang INNOVATE ngay lập tức.</gate>
|
|
80
92
|
</phase>
|
|
81
93
|
|
|
82
94
|
<phase name="INNOVATE" order="2">
|
|
83
95
|
<constraint>CHỈ ĐỌC (READ-ONLY). Không chỉnh sửa mã nguồn.</constraint>
|
|
84
|
-
<constraint>Đề xuất 2–3 phương án khả thi kèm ma trận đánh đổi (Trade-off)
|
|
85
|
-
<constraint>
|
|
86
|
-
<
|
|
87
|
-
<
|
|
96
|
+
<constraint>Đề xuất 2–3 phương án khả thi kèm ma trận đánh đổi (Trade-off).</constraint>
|
|
97
|
+
<constraint>Chế độ PAIR: Để trống phần `<engineer_decision>` — kỹ sư sẽ kiểm tra và điền phần này.</constraint>
|
|
98
|
+
<constraint>Chế độ DELEGATED / Fast-Track: Tự động chọn phương án khuyến nghị (Recommendation), ghi rõ rationale với `[AUTO: DELEGATED]`, tự ký duyệt Gate 1 và chuyển tiếp ngay sang PLAN.</constraint>
|
|
99
|
+
<output>Tạo `decision.md`.</output>
|
|
100
|
+
<gate id="G1">Gate 1 trong `decision.md` được kỹ sư ký duyệt (chế độ PAIR) hoặc tự động ký duyệt bởi Agent với `[AUTO: DELEGATED]` (chế độ DELEGATED / Fast-Track) trước khi chuyển sang Plan.</gate>
|
|
88
101
|
</phase>
|
|
89
102
|
|
|
90
103
|
<phase name="PLAN" order="3">
|
|
@@ -92,7 +105,7 @@
|
|
|
92
105
|
<constraint>Mỗi lát cắt (slice) phải có công cụ kiểm chứng (verifier), bằng chứng kỳ vọng và điểm hoàn nguyên (rollback point).</constraint>
|
|
93
106
|
<constraint>Hợp đồng phạm vi (danh sách file được phép / cấm sửa) phải tường minh.</constraint>
|
|
94
107
|
<output>Tạo `plan.md`. Điền sẵn các tiêu đề của Ma trận Kiểm chứng (Verification Matrix).</output>
|
|
95
|
-
<gate id="G2">Gate 2 trong `plan.md`
|
|
108
|
+
<gate id="G2">Gate 2 trong `plan.md` được kỹ sư ký duyệt (chế độ PAIR) hoặc tự động ký duyệt bởi Agent với `[AUTO: DELEGATED]` (chế độ DELEGATED / Fast-Track) trước khi chuyển sang Execute.</gate>
|
|
96
109
|
</phase>
|
|
97
110
|
|
|
98
111
|
<phase name="EXECUTE" order="4">
|
|
@@ -100,7 +113,7 @@
|
|
|
100
113
|
<constraint>Thực hiện từng lát cắt một. Chạy verifier sau mỗi slice. Kiểm tra diff sau mỗi slice.</constraint>
|
|
101
114
|
<constraint>Không refactor lan man. Không sửa các file bị cấm.</constraint>
|
|
102
115
|
<constraint>Cập nhật `state.md` ngay sau mỗi slice hoàn thành.</constraint>
|
|
103
|
-
<output>Mã nguồn + kiểm thử + cập nhật `state.md` kèm bằng chứng kiểm chứng.</output>
|
|
116
|
+
<output>Mã nguồn + kiểm thử + cập nhật `state.md` kèm bằng chứng kiểm chứng. Khi hoàn tất toàn bộ lát cắt, tự động chuyển ngay sang REVIEW.</output>
|
|
104
117
|
</phase>
|
|
105
118
|
|
|
106
119
|
<phase name="REVIEW" order="5">
|
|
@@ -108,7 +121,7 @@
|
|
|
108
121
|
<constraint>Không sửa mã nguồn trong lúc review. Ghi nhận các phát hiện vào `review.md`.</constraint>
|
|
109
122
|
<constraint>Bao quát: hành vi (behavior), kiến trúc (architecture), dữ liệu (data), bảo mật (security), hồi quy (regression).</constraint>
|
|
110
123
|
<output>Tạo `review.md` với các phát hiện được phân loại theo danh mục/mức độ/loại và checklist Gate 3.</output>
|
|
111
|
-
<gate id="G3">Gate 3 trong `review.md` phải được ký duyệt trước khi bàn giao. Quyết định review phải là PASS.</gate>
|
|
124
|
+
<gate id="G3">Gate 3 trong `review.md` phải được ký duyệt trước khi bàn giao. Quyết định review phải là PASS. Ở chế độ DELEGATED, Agent tự động kiểm toán toàn diện, tạo `handoff.md`, chuyển task sang `completed/` và báo cáo hoàn thành.</gate>
|
|
112
125
|
</phase>
|
|
113
126
|
|
|
114
127
|
<!-- Quy tắc hành vi (khai báo mode, retry, escalation, cổng hoàn thành) →
|
|
@@ -36,6 +36,7 @@ process/
|
|
|
36
36
|
│ ├── orchestration.md # Quy tắc phân công subagent
|
|
37
37
|
│ └── implementation-standards.md # Tiêu chuẩn kiểu dữ liệu, linting và kiểm thử
|
|
38
38
|
├── features/ # Tính năng theo domain (≥5 files / ≥3 phases)
|
|
39
|
+
│ # Kích hoạt qua prompt: "big task", "feature", "big changes", "task lớn", "tính năng"...
|
|
39
40
|
│ ├── active/ # Thư mục task đang làm: {CHG-ID}-{task-slug}/
|
|
40
41
|
│ │ └── CHG-XXX-example/ # Mỗi task một thư mục riêng biệt
|
|
41
42
|
│ │ ├── task.md # Hợp đồng master & lưu vết trạng thái
|
|
@@ -51,6 +52,7 @@ process/
|
|
|
51
52
|
│ ├── completed/ # Lưu trữ các task đã hoàn thành
|
|
52
53
|
│ └── backlog/ # Ghi chú task tồn đọng: {note_slug}_NOTE_{dd-mm-yy}.md
|
|
53
54
|
└── general-plans/ # Task độc lập, xuyên suốt, sửa bug nhanh (<5 files)
|
|
55
|
+
# Kích hoạt qua prompt: "small task", "general changes", "small changes", "task nhỏ", "sửa lỗi"...
|
|
54
56
|
├── active/
|
|
55
57
|
├── completed/
|
|
56
58
|
└── backlog/
|
|
@@ -71,16 +73,16 @@ flowchart TD
|
|
|
71
73
|
Task --> Res["research.md"] --> G0{"Gate G0 (Tự động)"}
|
|
72
74
|
end
|
|
73
75
|
subgraph I2["2. INNOVATE (Chỉ đọc)"]
|
|
74
|
-
G0 --> Dec["decision.md (2-3 Phương án)"] --> G1{"Gate G1 (Kỹ sư
|
|
76
|
+
G0 --> Dec["decision.md (2-3 Phương án)"] --> G1{"Gate G1 (Kỹ sư hoặc Auto-DELEGATED)"}
|
|
75
77
|
end
|
|
76
78
|
subgraph P3["3. PLAN (Chỉ lập kế hoạch)"]
|
|
77
|
-
G1 --> Plan["plan.md (Lát cắt dọc)"] --> G2{"Gate G2 (Kỹ sư
|
|
79
|
+
G1 --> Plan["plan.md (Lát cắt dọc)"] --> G2{"Gate G2 (Kỹ sư hoặc Auto-DELEGATED)"}
|
|
78
80
|
end
|
|
79
81
|
subgraph E4["4. EXECUTE (Đọc/Ghi theo phạm vi)"]
|
|
80
82
|
G2 --> Code["Thực thi từng Slice"] --> Test["Chạy Verifiers"] --> State["state.md (Bộ nhớ)"]
|
|
81
83
|
end
|
|
82
84
|
subgraph R5["5. REVIEW (Chỉ đọc)"]
|
|
83
|
-
State --> Rev["review.md (Kiểm toán diff)"] --> G3{"Gate G3 (Kỹ sư
|
|
85
|
+
State --> Rev["review.md (Kiểm toán diff)"] --> G3{"Gate G3 (Kỹ sư hoặc Auto-DELEGATED)"}
|
|
84
86
|
end
|
|
85
87
|
subgraph Done["6. HOÀN THÀNH"]
|
|
86
88
|
G3 --> Arch["Chuyển sang completed/"] --> Handoff["handoff.md"]
|
|
@@ -90,13 +92,22 @@ flowchart TD
|
|
|
90
92
|
```text
|
|
91
93
|
task.md ← (luôn có) Hợp đồng master, trạng thái RIPER phase/gate, AC, decisions
|
|
92
94
|
research.md ← (Research) Luồng thực thi, bằng chứng, ranh giới hệ thống
|
|
93
|
-
decision.md ← (Innovate) Các phương án, bảng đánh đổi, Gate 1
|
|
94
|
-
plan.md ← (Plan) Các lát cắt, verifiers, hợp đồng phạm vi, Gate 2
|
|
95
|
+
decision.md ← (Innovate) Các phương án, bảng đánh đổi, Gate 1 (Kỹ sư duyệt hoặc Auto-DELEGATED)
|
|
96
|
+
plan.md ← (Plan) Các lát cắt, verifiers, hợp đồng phạm vi, Gate 2 (Kỹ sư duyệt hoặc Auto-DELEGATED)
|
|
95
97
|
state.md ← (Execute) Tiến độ từng slice, bộ nhớ lỗi, ngân sách thử lại
|
|
96
|
-
review.md ← (Review) Phát hiện kiểm toán, ma trận kiểm chứng, Gate 3
|
|
98
|
+
review.md ← (Review) Phát hiện kiểm toán, ma trận kiểm chứng, Gate 3 (PASS)
|
|
97
99
|
handoff.md ← (Complete) Tóm tắt bàn giao ngắn gọn
|
|
98
100
|
```
|
|
99
101
|
|
|
102
|
+
### Khởi Tạo Task: Prompt-Driven vs Thủ Công
|
|
103
|
+
|
|
104
|
+
Người dùng có thể khởi tạo task theo 2 cách:
|
|
105
|
+
1. **Khởi tạo tự động qua Prompt & Lệnh Gạch Chéo (Khuyến nghị):** Đưa yêu cầu công việc kèm tiền tố lệnh slash hoặc từ khóa trực tiếp cho Agent. Agent sẽ tự động tạo thư mục trong `active/`, sao chép `task-template.md.seed` $\rightarrow$ `task.md`, điền các thẻ đặc tả và bắt đầu ngay pha `RESEARCH`:
|
|
106
|
+
- **`process/features/active/{task-slug}/`**: Kích hoạt bởi lệnh `/feature`, `/big-task`, `/epic` hoặc từ khóa `big task`, `feature`, `big changes`. Dành cho tính năng lớn, theo domain (≥5 files, nhiều phase).
|
|
107
|
+
- **`process/general-plans/active/{task-slug}/`**: Kích hoạt bởi lệnh `/task`, `/small-task`, `/bug`, `/quick-fix` hoặc từ khóa `small task`, `general changes`, `small changes`. Dành cho tác vụ độc lập, sửa bug nhanh (<5 files).
|
|
108
|
+
- **Lệnh đặc biệt**: `/hotfix` (sửa lỗi khẩn cấp, tự chạy DELEGATED), `/fast-track` (ủy quyền tự trị toàn bộ chu trình).
|
|
109
|
+
2. **Khởi tạo thủ công qua Terminal:** Tự tạo thư mục `mkdir -p process/.../active/{slug}` và `cp process/_seeds/task-template.md.seed process/.../active/{slug}/task.md` trước khi gọi Agent.
|
|
110
|
+
|
|
100
111
|
### Bảng Ánh Xạ Khái Niệm → Tệp Artifact
|
|
101
112
|
|
|
102
113
|
| Khái niệm | Artifact |
|
|
@@ -130,14 +141,14 @@ handoff.md ← (Complete) Tóm tắt bàn giao ngắn gọn
|
|
|
130
141
|
</phase>
|
|
131
142
|
|
|
132
143
|
<phase order="2" name="Innovate">
|
|
133
|
-
CHỈ ĐỌC. Đề xuất 2–3 phương án kèm ma trận đánh đổi.
|
|
134
|
-
Tạo `decision.md`. Kỹ sư phê duyệt
|
|
144
|
+
CHỈ ĐỌC. Đề xuất 2–3 phương án kèm ma trận đánh đổi.
|
|
145
|
+
Tạo `decision.md`. Gate 1: Kỹ sư phê duyệt (chế độ PAIR) hoặc Agent tự chọn phương án tối ưu [AUTO: DELEGATED] (chế độ DELEGATED/Fast-Track).
|
|
135
146
|
</phase>
|
|
136
147
|
|
|
137
148
|
<phase order="3" name="Plan">
|
|
138
149
|
Chỉ tạo/sửa artifact kế hoạch — không sửa mã nguồn.
|
|
139
150
|
Phân rã thành các lát cắt dọc (vertical slices) kèm verifiers, điểm hoàn nguyên và hợp đồng phạm vi.
|
|
140
|
-
Tạo `plan.md`. Kỹ sư phê duyệt
|
|
151
|
+
Tạo `plan.md`. Gate 2: Kỹ sư phê duyệt (chế độ PAIR) hoặc Agent tự động khóa hợp đồng lát cắt [AUTO: DELEGATED] (chế độ DELEGATED/Fast-Track).
|
|
141
152
|
</phase>
|
|
142
153
|
|
|
143
154
|
<phase order="4" name="Execute">
|
|
@@ -147,7 +158,7 @@ handoff.md ← (Complete) Tóm tắt bàn giao ngắn gọn
|
|
|
147
158
|
|
|
148
159
|
<phase order="5" name="Review">
|
|
149
160
|
CHỈ ĐỌC. Có thể chạy các lệnh kiểm thử xác minh. Không sửa mã nguồn.
|
|
150
|
-
Tạo `review.md` kèm các phát hiện. Gate 3
|
|
161
|
+
Tạo `review.md` kèm các phát hiện. Gate 3: Phải PASS trước khi bàn giao. Ở chế độ DELEGATED, Agent tự động hoàn tất dọn dẹp housekeeping và tạo `handoff.md`.
|
|
151
162
|
</phase>
|
|
152
163
|
</operational_phases>
|
|
153
164
|
|
|
@@ -170,6 +181,7 @@ handoff.md ← (Complete) Tóm tắt bàn giao ngắn gọn
|
|
|
170
181
|
* Ranh giới cú pháp máy đọc được (Machine-Readable Contract), khóa chặt phạm vi sửa đổi của AI.
|
|
171
182
|
|
|
172
183
|
### 2. Bản chất "HOW" — Nguyên Tắc Vận Hành
|
|
184
|
+
* **Prompt-Driven Task Initialization:** Loại bỏ hoàn toàn sự bất tiện khi phải tự chạy lệnh tạo folder hay copy seed. Người dùng chỉ cần gửi prompt chứa từ khóa (`big task`, `feature`, `big changes` cho `features/active/`; `small task`, `general changes`, `small changes` cho `general-plans/active/`). Agent tự động nhận diện từ khóa, dựng cấu trúc thư mục, sao chép `task-template.md.seed`, trích xuất yêu cầu vào `task.md` và thực thi ngay lập tức.
|
|
173
185
|
* **Copy-On-Demand:** Tuyệt đối không copy hàng loạt tất cả seed vào task cùng lúc. Bắt đầu với `task.md`, sau đó sinh ra `research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md` theo tiến độ phase.
|
|
174
186
|
* **Stateless Chat, Stateful Workspace:** Cửa sổ chat có thể tắt hoặc reset session. Toàn bộ tiến độ và bộ nhớ lỗi (`<failure_memory>`) được lưu bền vững trên ổ đĩa (`state.md`), session mới chỉ cần nạp lại file là tiếp tục công việc chính xác 100%.
|
|
175
187
|
* **Selective Knowledge Crystallization:** Sau khi task hoàn thành và tạo `handoff.md`, chỉ những thay đổi kiến trúc/contract dùng chung mới được cập nhật vào `process/context/` và đăng ký trong `all-context.md`.
|
|
@@ -12,7 +12,8 @@
|
|
|
12
12
|
### Triết Lý Thiết Kế Seeds: Bản Chất "Why" & "How"
|
|
13
13
|
* **Tại sao là đuôi `.seed`? (Why):** Đuôi `.seed` đóng vai trò ranh giới bất biến (Blueprint Immutability). Nó giúp phân biệt rõ ràng giữa "khuôn mẫu phôi" và "tài liệu markdown đang làm việc" (`*.md`). Khi AI quét repo bằng các công cụ tìm kiếm, hậu tố `.seed` bảo vệ các file này không bao giờ bị AI sửa đè vào làm hỏng template gốc của cả dự án.
|
|
14
14
|
* **Tại sao tách riêng từng seed theo phase? (Why):** Mỗi giai đoạn trong chu trình RIPER-5 đòi hỏi một kiểu tư duy và ranh giới quyền hạn khác biệt (Khảo sát vs Đề xuất vs Lập kế hoạch vs Thực thi vs Nghiệm thu). Việc tách rời giúp AI chỉ nạp đúng artifact cần thiết, chống phình to context window (Anti-Context Saturation) và gắn chặt với từng Cổng kiểm soát (Gates G1–G3).
|
|
15
|
-
* **Quy tắc Copy-On-Demand (How):** Tuyệt đối không copy hàng loạt tất cả seed vào thư mục task. Bắt đầu duy nhất với `task.md`. Khi task tiến vào phase nào, mới lần lượt khởi tạo artifact của phase đó (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`).
|
|
15
|
+
* **Quy tắc Copy-On-Demand (How):** Tuyệt đối không copy hàng loạt tất cả seed vào thư mục task. Bắt đầu duy nhất với `task.md`. Khi task tiến vào phase nào, mới lần lượt khởi tạo artifact của phase đó (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`). Ở chế độ PAIR, Agent dừng lại chờ người dùng duyệt cổng. Ở chế độ DELEGATED / Fast-Track, Agent tự động khởi tạo seed kế tiếp, tự động duyệt cổng và chạy liên tục không gián đoạn.
|
|
16
|
+
* **Khởi Tạo Task Qua Prompt (How):** Loại bỏ việc sao chép thủ công tốn thời gian. Người dùng có thể khởi tạo task ngay trong prompt bằng các từ khóa định hướng: `big task`, `feature`, `big changes` (vào `features/active/`) hoặc `small task`, `general changes`, `small changes` (vào `general-plans/active/`). Agent sẽ tự động tạo thư mục, sao chép seed và điền thông tin ban đầu.
|
|
16
17
|
</architectural_rationale>
|
|
17
18
|
|
|
18
19
|
---
|
|
@@ -23,7 +24,7 @@
|
|
|
23
24
|
|
|
24
25
|
<seed type="task" path="task-template.md.seed">
|
|
25
26
|
Hợp đồng master và bản lưu vết trạng thái xuyên suốt toàn bộ vòng đời RIPER-5.
|
|
26
|
-
Bao gồm: Metadata kiểm soát task, Đặc tả (Spec), Ranh giới ngữ cảnh, Chiến lược kiểm chứng,
|
|
27
|
+
Bao gồm: Metadata kiểm soát task (working_mode PAIR/DELEGATED), Đặc tả (Spec), Ranh giới ngữ cảnh, Chiến lược kiểm chứng,
|
|
27
28
|
Quyết định kỹ thuật, Kế hoạch thực thi RIPER-5 (kèm Gates G0–G3), và Ranh giới an toàn (Guardrails).
|
|
28
29
|
</seed>
|
|
29
30
|
|
|
@@ -38,7 +39,7 @@
|
|
|
38
39
|
<seed type="decision" path="decision-template.md.seed">
|
|
39
40
|
Artifact của giai đoạn Đề xuất giải pháp (Innovate). Bộ nhớ lưu vết Gate 1.
|
|
40
41
|
Bao gồm: Câu hỏi quyết định, Các phương án (A/B/C) kèm ma trận đánh đổi (Trade-off),
|
|
41
|
-
Khuyến nghị của Agent, Quyết định
|
|
42
|
+
Khuyến nghị của Agent, Quyết định Triển khai (Kỹ sư điền ở PAIR, hoặc Agent tự động chọn ở DELEGATED), Ràng buộc phái sinh,
|
|
42
43
|
Bằng chứng còn cần xác minh, và Checklist Gate 1.
|
|
43
44
|
</seed>
|
|
44
45
|
|
|
@@ -125,9 +126,9 @@ handoff.md ← Tóm tắt bàn giao cuối cùng (ngắn gọn)
|
|
|
125
126
|
| Hủy task | `cancelled.md` (lưu giữ tri thức khi hủy bỏ) |
|
|
126
127
|
| Benchmark / Định lượng | `results.tsv` (theo dõi hiệu năng và số liệu đánh giá) |
|
|
127
128
|
| Chương trình lớn | `program.md` (bản thiết kế chương trình lớn nhiều giai đoạn) |
|
|
128
|
-
| Gate 1 | Phê duyệt trong `decision.md` |
|
|
129
|
-
| Gate 2 | Phê duyệt trong `plan.md` |
|
|
130
|
-
| Gate 3 |
|
|
129
|
+
| Gate 1 | Phê duyệt trong `decision.md` (Kỹ sư hoặc Auto-DELEGATED) |
|
|
130
|
+
| Gate 2 | Phê duyệt trong `plan.md` (Kỹ sư hoặc Auto-DELEGATED) |
|
|
131
|
+
| Gate 3 | Nghiệm thu trong `review.md` (Kỹ sư hoặc Auto-DELEGATED) |
|
|
131
132
|
|
|
132
133
|
---
|
|
133
134
|
|
|
@@ -162,7 +163,17 @@ Không nhất thiết phải tạo tất cả các artifact ngay từ đầu. H
|
|
|
162
163
|
|
|
163
164
|
---
|
|
164
165
|
|
|
165
|
-
## 4.
|
|
166
|
+
## 4. Khởi Tạo Seed: Qua Prompt & Lệnh Sao Chép (Instantiation Methods)
|
|
167
|
+
|
|
168
|
+
### Phương thức 1: Khởi Tạo Tự Động Qua Prompt & Lệnh Slash (Khuyến nghị)
|
|
169
|
+
Thay vì gõ lệnh terminal thủ công, bạn chỉ cần mở đầu prompt bằng cú pháp gạch chéo (**Pseudo-Slash**) hoặc từ khóa:
|
|
170
|
+
- **`process/features/active/{task-slug}/`**: Dùng lệnh `/feature`, `/big-task`, `/epic` hoặc các từ khóa: `big task`, `feature`, `big changes`, `epic` (hoặc: `task lớn`, `tính năng`, `thay đổi lớn`).
|
|
171
|
+
- **`process/general-plans/active/{task-slug}/`**: Dùng lệnh `/task`, `/small-task`, `/bug`, `/quick-fix` hoặc các từ khóa: `small task`, `general changes`, `small changes`, `bug fix`, `quick fix` (hoặc: `task nhỏ`, `thay đổi chung`, `thay đổi nhỏ`, `sửa lỗi`).
|
|
172
|
+
- **Lệnh đặc biệt**: `/hotfix` (sửa lỗi production khẩn cấp, tự động chạy DELEGATED mode).
|
|
173
|
+
|
|
174
|
+
Agent sẽ tự động tạo thư mục tương ứng, copy `task-template.md.seed` $\rightarrow$ `task.md`, trích xuất `<goal>` và `<acceptance_criteria>` từ prompt, rồi bắt đầu ngay pha Khảo sát (Research).
|
|
175
|
+
|
|
176
|
+
### Phương thức 2: Lệnh Sao Chép Thủ Công Qua Terminal (Copy Commands)
|
|
166
177
|
|
|
167
178
|
```bash
|
|
168
179
|
# Tạo thư mục task mới
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
<technical_decision task_id="[TASK-ID]" dec_id="[DEC-ID]" version="1.0" framework="RIPER-5">
|
|
4
4
|
|
|
5
|
-
<!-- GIAI ĐOẠN CHỈ ĐỌC (READ-ONLY). Đề xuất các phương án.
|
|
5
|
+
<!-- GIAI ĐOẠN CHỈ ĐỌC (READ-ONLY). Đề xuất các phương án. PAIR: kỹ sư chọn. DELEGATED: agent tự chọn phương án tối ưu và tự động chuyển phase. -->
|
|
6
6
|
<decision_status>
|
|
7
7
|
<phase>INNOVATE</phase>
|
|
8
8
|
<mode>READ-ONLY</mode>
|
|
@@ -98,9 +98,11 @@
|
|
|
98
98
|
|
|
99
99
|
---
|
|
100
100
|
|
|
101
|
-
## 6. Quyết Định
|
|
101
|
+
## 6. Quyết Định Triển Khai (Implementation Decision)
|
|
102
102
|
|
|
103
|
-
<!--
|
|
103
|
+
<!-- Chế độ PAIR: Kỹ sư con người điền phần này trước khi duyệt Gate 1.
|
|
104
|
+
Chế độ DELEGATED / Fast-Track: Agent tự động điền phương án khuyến nghị (Recommendation)
|
|
105
|
+
vào <selected_option>, ghi rõ rationale và ký duyệt Gate 1 với [AUTO: DELEGATED]. -->
|
|
104
106
|
<engineer_decision>
|
|
105
107
|
<selected_option></selected_option>
|
|
106
108
|
<rationale></rationale>
|
|
@@ -133,10 +135,9 @@
|
|
|
133
135
|
|
|
134
136
|
<gate id="G1">
|
|
135
137
|
- [ ] Toàn bộ phương án đã được trình bày và phân tích đánh đổi.
|
|
136
|
-
- [ ]
|
|
137
|
-
- [ ] Phương án do kỹ sư chọn đã được ghi nhận ở trên.
|
|
138
|
+
- [ ] Phương án được chọn đã được ghi nhận ở trên.
|
|
138
139
|
- [ ] Không còn quyết định nghiệp vụ / schema / bảo mật nào đang bỏ ngỏ.
|
|
139
|
-
<approved_by></approved_by>
|
|
140
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
140
141
|
<approved_date></approved_date>
|
|
141
142
|
</gate>
|
|
142
143
|
|
|
@@ -127,8 +127,8 @@
|
|
|
127
127
|
- [ ] Điều kiện dừng đã được định nghĩa cho từng slice.
|
|
128
128
|
- [ ] Điểm hoàn nguyên (rollback point) đã được định nghĩa cho từng slice.
|
|
129
129
|
- [ ] Danh sách lệnh được phép đã được liệt kê.
|
|
130
|
-
- [ ]
|
|
131
|
-
<approved_by></approved_by>
|
|
130
|
+
- [ ] Kế hoạch đã được ký duyệt.
|
|
131
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
132
132
|
<approved_date></approved_date>
|
|
133
133
|
</gate>
|
|
134
134
|
|
|
@@ -142,7 +142,7 @@
|
|
|
142
142
|
- [ ] Rủi ro tồn đọng đã được chấp nhận rõ ràng.
|
|
143
143
|
- [ ] Quyết định review: PASS.
|
|
144
144
|
- [ ] Sẵn sàng bàn giao (handoff).
|
|
145
|
-
<approved_by></approved_by>
|
|
145
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
146
146
|
<approved_date></approved_date>
|
|
147
147
|
</gate>
|
|
148
148
|
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
<priority>P2</priority> <!-- P0=khẩn cấp | P1=cao | P2=bình thường | P3=thấp -->
|
|
12
12
|
<risk>MEDIUM</risk> <!-- LOW | MEDIUM | HIGH -->
|
|
13
13
|
<estimated_story_points>2</estimated_story_points> <!-- 1 SP ≈ 2-4 giờ làm việc kỹ thuật tập trung -->
|
|
14
|
-
<working_mode>PAIR</working_mode> <!--
|
|
14
|
+
<working_mode>PAIR</working_mode> <!-- PAIR (mặc định: dừng chờ duyệt từng gate) | DELEGATED (fast-track: tự động chạy liên tục qua các phase) | MANUAL | DIAGNOSE-ONLY -->
|
|
15
15
|
<current_phase>RESEARCH</current_phase> <!-- RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW -->
|
|
16
16
|
<owner>@engineer</owner>
|
|
17
17
|
<decision_owner>@engineer</decision_owner>
|
|
@@ -124,18 +124,19 @@
|
|
|
124
124
|
- [ ] Hành vi hiện tại đã được hiểu và ghi nhận tài liệu.
|
|
125
125
|
- [ ] Luồng thực thi đã được truy vết đầy đủ.
|
|
126
126
|
- [ ] Không còn rào cản khảo sát chưa giải quyết.
|
|
127
|
+
<!-- Ở chế độ DELEGATED / Fast-Track: Agent tự động đánh giá và chuyển sang Innovate -->
|
|
127
128
|
</gate>
|
|
128
129
|
</phase>
|
|
129
130
|
|
|
130
131
|
<phase name="Innovate" order="2">
|
|
131
|
-
<!-- CHỈ ĐỌC. Đề xuất 2-3 phương án khả thi.
|
|
132
|
+
<!-- CHỈ ĐỌC. Đề xuất 2-3 phương án khả thi. PAIR: kỹ sư chọn. DELEGATED: agent tự chọn phương án tối ưu. -->
|
|
132
133
|
- [ ] Đề xuất 2–3 hướng tiếp cận khác nhau kèm ma trận đánh đổi.
|
|
133
134
|
- [ ] Tạo artifact `decision.md`.
|
|
134
135
|
<gate id="G1" label="Gate 1 — Phê duyệt phương án (Decision Approved)">
|
|
135
|
-
- [ ] Các phương án đã được
|
|
136
|
+
- [ ] Các phương án đã được xem xét và phân tích đánh đổi.
|
|
136
137
|
- [ ] Phương án được chọn đã ghi nhận vào `decision.md`.
|
|
137
138
|
- [ ] Không còn quyết định nghiệp vụ/schema/bảo mật nào đang bỏ ngỏ.
|
|
138
|
-
<approved_by></approved_by>
|
|
139
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
139
140
|
<approved_date></approved_date>
|
|
140
141
|
</gate>
|
|
141
142
|
</phase>
|
|
@@ -149,8 +150,8 @@
|
|
|
149
150
|
- [ ] Phạm vi file được phép / bị cấm sửa được xác định rõ ràng.
|
|
150
151
|
- [ ] Điểm hoàn nguyên (rollback point) được định nghĩa cho từng slice.
|
|
151
152
|
- [ ] Điều kiện dừng khẩn cấp được nêu rõ.
|
|
152
|
-
- [ ]
|
|
153
|
-
<approved_by></approved_by>
|
|
153
|
+
- [ ] Kế hoạch đã được ký duyệt.
|
|
154
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
154
155
|
<approved_date></approved_date>
|
|
155
156
|
</gate>
|
|
156
157
|
</phase>
|
|
@@ -171,9 +172,9 @@
|
|
|
171
172
|
<gate id="G3" label="Gate 3 — Nghiệm thu đạt (Review Passed)">
|
|
172
173
|
- [ ] Mọi AC đều được kiểm chứng kèm bằng chứng thực tế.
|
|
173
174
|
- [ ] Rủi ro tồn đọng đã được chấp nhận.
|
|
174
|
-
- [ ] Quyết định review: PASS
|
|
175
|
+
- [ ] Quyết định review: PASS.
|
|
175
176
|
- [ ] Sẵn sàng bàn giao (handoff).
|
|
176
|
-
<approved_by></approved_by>
|
|
177
|
+
<approved_by></approved_by> <!-- Tên kỹ sư (PAIR) hoặc [AUTO: DELEGATED] (DELEGATED/Fast-Track) -->
|
|
177
178
|
<approved_date></approved_date>
|
|
178
179
|
</gate>
|
|
179
180
|
</phase>
|