@winton979/task-cli 1.0.2 → 1.0.3
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 +138 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,38 +1,164 @@
|
|
|
1
1
|
# task-cli
|
|
2
2
|
|
|
3
|
-
Lightweight task workflow
|
|
3
|
+
Lightweight task workflow for AI-assisted development.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Designed for:
|
|
6
|
+
|
|
7
|
+
* Claude Code
|
|
8
|
+
* Codex CLI
|
|
9
|
+
* Mature projects with frequent bug fixes and small feature iterations
|
|
10
|
+
|
|
11
|
+
Task CLI provides a lightweight alternative to heavyweight spec-driven workflows by combining:
|
|
12
|
+
|
|
13
|
+
* Requirement clarification (via Grill Me)
|
|
14
|
+
* Brief generation
|
|
15
|
+
* Implementation
|
|
16
|
+
* Review
|
|
17
|
+
* Decision logging
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## Installation
|
|
6
22
|
|
|
7
23
|
```bash
|
|
8
24
|
npm install -g @winton979/task-cli
|
|
9
25
|
```
|
|
10
26
|
|
|
27
|
+
Initialize the workflow in your project:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
task init
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Prerequisites
|
|
36
|
+
|
|
37
|
+
Task CLI relies on a Grill Me compatible skill for requirement exploration.
|
|
38
|
+
|
|
39
|
+
Recommended:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx add-skill PJ-SBN-593844/skill-grill-me
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Compatible Grill Me implementations may also work.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
11
49
|
## Usage
|
|
12
50
|
|
|
13
51
|
```bash
|
|
14
|
-
task init
|
|
15
|
-
task --help
|
|
52
|
+
task init
|
|
53
|
+
task --help
|
|
16
54
|
```
|
|
17
55
|
|
|
18
|
-
After
|
|
56
|
+
After initialization, Task CLI creates the `.ai/` workspace and installs workflow skills.
|
|
57
|
+
|
|
58
|
+
---
|
|
19
59
|
|
|
20
|
-
|
|
60
|
+
## Recommended Workflow
|
|
21
61
|
|
|
22
|
-
|
|
62
|
+
### Small Feature / Enhancement
|
|
23
63
|
|
|
24
|
-
|
|
64
|
+
```text
|
|
65
|
+
/task-fast
|
|
66
|
+
↓
|
|
67
|
+
Grill Me
|
|
68
|
+
↓
|
|
69
|
+
task brief generated
|
|
70
|
+
↓
|
|
71
|
+
/task-implement
|
|
72
|
+
↓
|
|
73
|
+
/task-review
|
|
74
|
+
```
|
|
25
75
|
|
|
26
|
-
|
|
76
|
+
### Larger Requirement
|
|
27
77
|
|
|
78
|
+
```text
|
|
79
|
+
/task-explore
|
|
80
|
+
↓
|
|
81
|
+
TASK_READY
|
|
82
|
+
↓
|
|
83
|
+
/task-brief
|
|
84
|
+
↓
|
|
85
|
+
/task-implement
|
|
86
|
+
↓
|
|
87
|
+
/task-review
|
|
28
88
|
```
|
|
89
|
+
|
|
90
|
+
### Bug Fix
|
|
91
|
+
|
|
92
|
+
```text
|
|
93
|
+
/bug-explore
|
|
94
|
+
↓
|
|
95
|
+
BUG_READY
|
|
96
|
+
↓
|
|
97
|
+
/bug-brief
|
|
98
|
+
↓
|
|
99
|
+
/bug-fix
|
|
100
|
+
↓
|
|
101
|
+
/bug-review
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Available Skills
|
|
107
|
+
|
|
108
|
+
### Task Workflow
|
|
109
|
+
|
|
110
|
+
* task-fast
|
|
111
|
+
* task-explore
|
|
112
|
+
* task-brief
|
|
113
|
+
* task-implement
|
|
114
|
+
* task-review
|
|
115
|
+
|
|
116
|
+
### Bug Workflow
|
|
117
|
+
|
|
118
|
+
* bug-explore
|
|
119
|
+
* bug-brief
|
|
120
|
+
* bug-fix
|
|
121
|
+
* bug-review
|
|
122
|
+
|
|
123
|
+
### Other
|
|
124
|
+
|
|
125
|
+
* decision-log
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Directory Structure
|
|
130
|
+
|
|
131
|
+
```text
|
|
29
132
|
.ai/
|
|
30
133
|
├── tasks/
|
|
31
134
|
│ ├── active/
|
|
32
135
|
│ └── archive/
|
|
136
|
+
│
|
|
33
137
|
├── bugs/
|
|
34
138
|
│ ├── active/
|
|
35
139
|
│ └── archive/
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
140
|
+
│
|
|
141
|
+
├── decisions/
|
|
142
|
+
│ └── decisions.md
|
|
143
|
+
│
|
|
144
|
+
└── skills/
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## Philosophy
|
|
150
|
+
|
|
151
|
+
Task CLI is intentionally lightweight.
|
|
152
|
+
|
|
153
|
+
Instead of maintaining large specifications, it focuses on:
|
|
154
|
+
|
|
155
|
+
1. Clarifying requirements before coding
|
|
156
|
+
2. Capturing execution context in concise briefs
|
|
157
|
+
3. Reviewing work against acceptance criteria
|
|
158
|
+
4. Keeping a lightweight decision history
|
|
159
|
+
|
|
160
|
+
The goal is to improve quality without slowing down iteration speed.
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
> Task CLI does not install Grill Me automatically.
|
|
164
|
+
> Users remain free to choose any Grill Me compatible implementation.
|