thachvd-kit 1.0.26 → 1.0.28
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/.agent/docs/getting-started.md +92 -0
- package/.agent/docs/project.md +13 -1
- package/.agent/docs/tooling.md +7 -13
- package/.agent/docs/workflow.md +43 -1
- package/.agent/rules/GEMINI.md +23 -7
- package/.agent/workflows/release.md +42 -0
- package/.agent/workflows/simple.md +42 -0
- package/.agent/workflows/task.md +59 -0
- package/README.md +98 -15
- package/bin/cli.js +354 -40
- package/package.json +4 -1
- package/prompts/debug.md +11 -0
- package/prompts/release.md +11 -0
- package/prompts/simple.md +11 -0
- package/prompts/spec.md +11 -0
- package/prompts/task.md +12 -0
- package/workflows/release.md +42 -0
- package/workflows/simple.md +42 -0
- package/workflows/task.md +59 -0
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Fast path for one-file, unambiguous fixes with no behavior or shared-contract change.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /simple - Fast Path
|
|
6
|
+
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
Codex UI command: `/prompts:simple`. The `/simple` name below describes the workflow; it is not a built-in Codex slash command.
|
|
10
|
+
|
|
11
|
+
## Use Only When
|
|
12
|
+
|
|
13
|
+
- The change is limited to one obvious file or one tiny local edit.
|
|
14
|
+
- The expected result is unambiguous.
|
|
15
|
+
- No behavior, API, schema, security, CI, dependency, workflow, or release contract changes.
|
|
16
|
+
|
|
17
|
+
## Explicit Bypass
|
|
18
|
+
|
|
19
|
+
Start the response with:
|
|
20
|
+
|
|
21
|
+
```text
|
|
22
|
+
FAST_PATH: simple-fix
|
|
23
|
+
REASON: [why Spec/Plan/Review are not needed]
|
|
24
|
+
SCOPE: [file or narrow area]
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Steps
|
|
28
|
+
|
|
29
|
+
1. Inspect the target and its immediate context.
|
|
30
|
+
2. Make the smallest change.
|
|
31
|
+
3. Run focused verification.
|
|
32
|
+
4. Report the changed file and evidence.
|
|
33
|
+
|
|
34
|
+
Do not create a spec or plan for this route. Do not skip verification. If the scope expands, stop and re-route through `/task` as a feature, bug, or multi-domain task.
|
|
35
|
+
|
|
36
|
+
## Examples
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
/simple fix a typo in README.md
|
|
40
|
+
/simple update one stale command in a workflow doc
|
|
41
|
+
/simple change one test assertion message
|
|
42
|
+
```
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Route every task to the smallest safe workflow, fast path, bug flow, feature flow, or release flow.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /task - Task Router
|
|
6
|
+
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
Codex UI command: `/prompts:task`. The `/task` name below describes the workflow; it is not a built-in Codex slash command.
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
|
|
13
|
+
Use `/task` at the start of a task when you are unsure which workflow, skill, or specialist agent applies. This command routes the request before implementation.
|
|
14
|
+
|
|
15
|
+
## Required Output
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
ROUTE: question | simple | feature | bug | review | release | multi-domain
|
|
19
|
+
WORKFLOW: [exact .agent/workflows/<name>.md file]
|
|
20
|
+
SKILLS: [skills to load, or none]
|
|
21
|
+
AGENTS: [specialist agents to load, or none]
|
|
22
|
+
GATE: fast-path | standard
|
|
23
|
+
NEXT: [the next command or action]
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Do not write code while routing. Ask one concise clarification question if the route cannot be determined safely.
|
|
27
|
+
|
|
28
|
+
## Routing Rules
|
|
29
|
+
|
|
30
|
+
| Signal | Route | Next action |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| Asking for information or architecture explanation | question | Answer directly; no edits |
|
|
33
|
+
| One obvious file, no behavior or contract change | simple | Use `/simple <request>` |
|
|
34
|
+
| New behavior, multiple files, unclear scope, or >30 minutes | feature | `/brainstorm` -> `/spec` when needed -> `/plan`, then approval |
|
|
35
|
+
| Failing test, regression, error, or unknown root cause | bug | Use `/debug <symptom>` |
|
|
36
|
+
| Review request or pre-merge check | review | Use `/review` |
|
|
37
|
+
| npm version/tag/publish request | release | Use `/release` |
|
|
38
|
+
| Several specialist domains | multi-domain | Use `/orchestrate` |
|
|
39
|
+
|
|
40
|
+
## Workflow And Skill Map
|
|
41
|
+
|
|
42
|
+
- `/simple`: `$clean-code` + `$verification-before-completion`.
|
|
43
|
+
- `/brainstorm`: `brainstorming`; no code.
|
|
44
|
+
- `/spec`: `.agent/workflows/spec.md`; define scope and acceptance criteria, no code.
|
|
45
|
+
- `/plan`: `project-planner` + `plan-writing`; no code before approval.
|
|
46
|
+
- `/enhance` or `/create`: relevant domain agent and implementation skills after approval.
|
|
47
|
+
- `/debug`: `debugger` + `$systematic-debugging` + `testing-patterns`.
|
|
48
|
+
- `/test`: `test-engineer` + `testing-patterns`.
|
|
49
|
+
- `/review`: `$code-review-checklist` + `$verification-before-completion`.
|
|
50
|
+
- `/release`: `release.md` and the npm release scripts; never use the fast path.
|
|
51
|
+
|
|
52
|
+
## Examples
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
/task add an export button
|
|
56
|
+
/task login returns 500
|
|
57
|
+
/task fix typo in README
|
|
58
|
+
/task publish a new npm version
|
|
59
|
+
```
|