@damphuquy/agent-init 2.1.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 +34 -2
- package/templates/en/AGENTS.md +6 -0
- package/templates/en/process/README.md +13 -1
- package/templates/en/process/_seeds/_GUIDE.md +12 -1
- package/templates/vi/.agents/behavior.md +34 -2
- package/templates/vi/AGENTS.md +6 -0
- package/templates/vi/process/README.md +12 -0
- package/templates/vi/process/_seeds/_GUIDE.md +12 -1
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
|
@@ -59,7 +59,39 @@ In continuous autonomous execution (DELEGATED / Fast-Track), the agent opens wit
|
|
|
59
59
|
|
|
60
60
|
---
|
|
61
61
|
|
|
62
|
-
## 3.
|
|
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
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 4. Session Startup Protocol
|
|
63
95
|
|
|
64
96
|
Before continuing any in-progress task, reload persistent state in this order:
|
|
65
97
|
|
|
@@ -77,7 +109,7 @@ file-based artifacts listed above.
|
|
|
77
109
|
|
|
78
110
|
---
|
|
79
111
|
|
|
80
|
-
##
|
|
112
|
+
## 5. Context Navigation Rules
|
|
81
113
|
|
|
82
114
|
<context_rules>
|
|
83
115
|
<rule id="minimum_context">
|
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>
|
|
@@ -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/
|
|
@@ -97,6 +99,15 @@ 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 |
|
|
@@ -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`.
|
|
@@ -13,6 +13,7 @@
|
|
|
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
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
|
---
|
|
@@ -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
|
|
@@ -59,7 +59,39 @@ Trong chế độ chạy liên tục (DELEGATED / Fast-Track), Agent mở đầu
|
|
|
59
59
|
|
|
60
60
|
---
|
|
61
61
|
|
|
62
|
-
## 3. Giao Thức Khởi
|
|
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
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 4. Giao Thức Khởi Động Session (Session Startup Protocol)
|
|
63
95
|
|
|
64
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:
|
|
65
97
|
|
|
@@ -77,7 +109,7 @@ dựa trên các tệp artifact được liệt kê ở trên.
|
|
|
77
109
|
|
|
78
110
|
---
|
|
79
111
|
|
|
80
|
-
##
|
|
112
|
+
## 5. Quy Tắc Điều Hướng Ngữ Cảnh (Context Navigation Rules)
|
|
81
113
|
|
|
82
114
|
<context_rules>
|
|
83
115
|
<rule id="minimum_context">
|
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>
|
|
@@ -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/
|
|
@@ -97,6 +99,15 @@ review.md ← (Review) Phát hiện kiểm toán, ma trận kiểm chứn
|
|
|
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 |
|
|
@@ -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`.
|
|
@@ -13,6 +13,7 @@
|
|
|
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
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
|
---
|
|
@@ -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
|