@elvis1513/auto-coding-skill 2.2.1 → 3.0.1
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 +178 -46
- package/cli/assets/agents/browser-debugger.toml +5 -7
- package/cli/assets/agents/docs-researcher.toml +3 -5
- package/cli/assets/agents/explorer.toml +5 -10
- package/cli/assets/agents/fixer.toml +19 -17
- package/cli/assets/agents/reviewer.toml +14 -10
- package/cli/assets/skill/SKILL.md +152 -37
- package/cli/assets/skill/data/contracts/orchestration-v1.schema.json +475 -0
- package/cli/assets/skill/data/templates/ENGINEERING.md +226 -74
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +4 -4
- package/cli/assets/skill/data/templates/docs/tasks/closure-log.md +7 -6
- package/cli/assets/skill/data/templates/docs/tasks/taskbook.md +11 -4
- package/cli/assets/skill/scripts/ap.py +3296 -545
- package/cli/src/index.js +411 -51
- package/cli/tests/ap_concurrency_test.py +1578 -0
- package/cli/tests/ap_profiles_test.py +242 -98
- package/cli/tests/index.test.js +410 -15
- package/package.json +4 -4
|
@@ -2,45 +2,61 @@
|
|
|
2
2
|
workflow:
|
|
3
3
|
mode: "dev"
|
|
4
4
|
profile: "auto"
|
|
5
|
+
completion: "push"
|
|
5
6
|
|
|
6
7
|
project:
|
|
7
8
|
name: ""
|
|
8
9
|
repo_root: "."
|
|
9
10
|
stack: "generic"
|
|
10
11
|
|
|
12
|
+
access:
|
|
13
|
+
project:
|
|
14
|
+
frontend:
|
|
15
|
+
url: ""
|
|
16
|
+
username: ""
|
|
17
|
+
password: ""
|
|
18
|
+
backend:
|
|
19
|
+
url: ""
|
|
20
|
+
username: ""
|
|
21
|
+
password: ""
|
|
22
|
+
jenkins:
|
|
23
|
+
frontend:
|
|
24
|
+
url: ""
|
|
25
|
+
username: ""
|
|
26
|
+
password: ""
|
|
27
|
+
backend:
|
|
28
|
+
url: ""
|
|
29
|
+
username: ""
|
|
30
|
+
password: ""
|
|
31
|
+
gitlab:
|
|
32
|
+
url: ""
|
|
33
|
+
username: ""
|
|
34
|
+
password: ""
|
|
35
|
+
nexus:
|
|
36
|
+
frontend:
|
|
37
|
+
url: ""
|
|
38
|
+
username: ""
|
|
39
|
+
password: ""
|
|
40
|
+
|
|
41
|
+
concurrency:
|
|
42
|
+
isolation: "worktree"
|
|
43
|
+
base_ref: ""
|
|
44
|
+
target_branch: ""
|
|
45
|
+
branch_prefix: "codex/"
|
|
46
|
+
worktree_root: "../.worktrees"
|
|
47
|
+
cleanup_merged: true
|
|
48
|
+
delete_remote_branch: true
|
|
49
|
+
disposable_ignored: []
|
|
50
|
+
|
|
11
51
|
commands:
|
|
12
|
-
gate_changed: ""
|
|
13
|
-
gate_standard: ""
|
|
14
|
-
gate_full: ""
|
|
52
|
+
gate_changed: "git diff --check"
|
|
15
53
|
|
|
16
54
|
gate:
|
|
17
|
-
default_scope: "
|
|
18
|
-
fallback_scope: "
|
|
19
|
-
full_on_unknown:
|
|
20
|
-
no_change_scope: "
|
|
55
|
+
default_scope: "changed"
|
|
56
|
+
fallback_scope: "changed"
|
|
57
|
+
full_on_unknown: false
|
|
58
|
+
no_change_scope: "changed"
|
|
21
59
|
profile_log: ".local/auto-coding-skill/gate-profile.jsonl"
|
|
22
|
-
full_on:
|
|
23
|
-
paths:
|
|
24
|
-
- "Jenkinsfile"
|
|
25
|
-
- "Jenkinsfile.*"
|
|
26
|
-
- ".github/workflows/**"
|
|
27
|
-
- "Dockerfile"
|
|
28
|
-
- "**/Dockerfile"
|
|
29
|
-
- "docker-compose*.yml"
|
|
30
|
-
- "docker-compose*.yaml"
|
|
31
|
-
- "compose*.yml"
|
|
32
|
-
- "compose*.yaml"
|
|
33
|
-
- "docs/ENGINEERING.md"
|
|
34
|
-
- "docs/tools/autopipeline/**"
|
|
35
|
-
- "package-lock.json"
|
|
36
|
-
- "pnpm-lock.yaml"
|
|
37
|
-
- "yarn.lock"
|
|
38
|
-
- "go.mod"
|
|
39
|
-
- "go.sum"
|
|
40
|
-
- "Cargo.lock"
|
|
41
|
-
- "pom.xml"
|
|
42
|
-
- "build.gradle*"
|
|
43
|
-
- "settings.gradle*"
|
|
44
60
|
rules: []
|
|
45
61
|
|
|
46
62
|
structure:
|
|
@@ -76,14 +92,13 @@ optimization:
|
|
|
76
92
|
require_baseline_for_global_review: false
|
|
77
93
|
report_accepted_debt_as_findings: false
|
|
78
94
|
|
|
79
|
-
verification:
|
|
80
|
-
target_env_required: false
|
|
81
|
-
jenkins_required: false
|
|
82
|
-
|
|
83
95
|
docs:
|
|
84
96
|
taskbook: "docs/tasks/taskbook.md"
|
|
85
97
|
closure_log: "docs/tasks/closure-log.md"
|
|
86
98
|
evidence_log: "docs/tasks/evidence.jsonl"
|
|
99
|
+
active_task_dir: "docs/tasks/active"
|
|
100
|
+
task_closure_dir: "docs/tasks/closures"
|
|
101
|
+
task_evidence_dir: "docs/tasks/evidence"
|
|
87
102
|
design_dir: "docs/design"
|
|
88
103
|
task_archive_dir: "docs/tasks/archives"
|
|
89
104
|
design_archive_dir: "docs/archive/design"
|
|
@@ -106,70 +121,193 @@ docs:
|
|
|
106
121
|
|
|
107
122
|
# Engineering Workflow
|
|
108
123
|
|
|
109
|
-
|
|
110
|
-
|
|
124
|
+
<!-- auto-coding-skill:managed-workflow:start version=3.0.1 -->
|
|
125
|
+
|
|
126
|
+
This file is the single project workflow configuration. Keep it in Git. Its YAML
|
|
127
|
+
frontmatter and content outside these versioned markers are manually maintained;
|
|
128
|
+
`autocoding sync` updates only this managed workflow block. Fill every access URL,
|
|
129
|
+
username, and password during project initialization.
|
|
111
130
|
|
|
112
131
|
## Execution profiles
|
|
113
132
|
|
|
114
133
|
`workflow.profile: auto` selects one of three effective profiles:
|
|
115
134
|
|
|
116
|
-
| Profile | Typical work |
|
|
135
|
+
| Profile | Typical work | Local gate | Completion |
|
|
117
136
|
| --- | --- | --- | --- |
|
|
118
|
-
| `micro` | docs/tests-only, very small isolated work | changed |
|
|
119
|
-
| `standard` | ordinary feature and defect work |
|
|
120
|
-
| `high-risk` | DB/auth/payment/deploy/build config or declared high risk |
|
|
137
|
+
| `micro` | docs/tests-only, very small isolated work | changed/quick | pushed |
|
|
138
|
+
| `standard` | ordinary feature and defect work | changed/quick | pushed |
|
|
139
|
+
| `high-risk` | DB/auth/payment/deploy/build config or declared high risk | changed/quick | pushed |
|
|
121
140
|
|
|
122
|
-
`auto` is only a selector. The effective profile
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
141
|
+
`auto` is only a selector. The effective profile remains useful for analysis,
|
|
142
|
+
design depth, and reviewer recommendations, but it never expands the local gate.
|
|
143
|
+
All profiles run the fast changed-scope gate and complete when the configured
|
|
144
|
+
target branch is pushed. Jenkins owns later build/deploy work; its result and
|
|
145
|
+
manual acceptance are outside the coding task.
|
|
126
146
|
|
|
127
|
-
Project `gate.rules` may
|
|
128
|
-
|
|
129
|
-
|
|
147
|
+
Project `gate.rules` may raise the planning profile or request design/reviewer
|
|
148
|
+
attention. Their legacy `scope` and `commands` values never execute in the
|
|
149
|
+
automatic development flow. Standard/full commands remain callable on demand
|
|
150
|
+
with `ap.py run <name>` but are not part of normal development.
|
|
130
151
|
|
|
131
152
|
## Minimal configuration
|
|
132
153
|
|
|
133
154
|
Required for normal development:
|
|
134
155
|
|
|
135
|
-
- `workflow.mode`: `dev`
|
|
156
|
+
- `workflow.mode`: `dev`
|
|
136
157
|
- `workflow.profile`: `auto`, `micro`, `standard`, or `high-risk`
|
|
158
|
+
- `workflow.completion`: `push`
|
|
137
159
|
- `project.name`
|
|
138
|
-
-
|
|
139
|
-
|
|
140
|
-
|
|
160
|
+
- all URL, username, and direct password fields under `access.project`,
|
|
161
|
+
`access.jenkins`, `access.gitlab`, and `access.nexus`; blank/TODO values make
|
|
162
|
+
initialization incomplete and block `doctor`; keep each value as an inline
|
|
163
|
+
YAML string, quoting values that resemble numbers, dates, booleans, or YAML
|
|
164
|
+
collections
|
|
165
|
+
- `concurrency.isolation`: the only supported value is `worktree`; shared-checkout
|
|
166
|
+
and legacy write modes are rejected
|
|
167
|
+
- `concurrency.base_ref` and `target_branch`: leave blank to derive the current
|
|
168
|
+
upstream, or set them explicitly for a fixed integration branch
|
|
169
|
+
- `concurrency.branch_prefix` and `worktree_root`
|
|
170
|
+
- `concurrency.cleanup_merged` and `delete_remote_branch`: keep both enabled to
|
|
171
|
+
remove integrated temporary worktrees and branches
|
|
172
|
+
- `concurrency.disposable_ignored`: add only project-specific ignored cache/build
|
|
173
|
+
paths that may be discarded with a task worktree; ignored data and unknown
|
|
174
|
+
paths block cleanup, including inside initialized submodules
|
|
175
|
+
- one fast `commands.gate_changed`; the default is `git diff --check`
|
|
176
|
+
|
|
177
|
+
Legacy command keys such as `commands.light_gate`, `test`, and `build` remain
|
|
178
|
+
callable explicitly with `ap.py run <name>` but never replace the automatic
|
|
179
|
+
changed gate. `quick_test` remains the only fallback when `gate_changed` is
|
|
180
|
+
absent. Run `doctor` for exact missing-field diagnostics.
|
|
181
|
+
|
|
182
|
+
## Concurrent write tasks
|
|
183
|
+
|
|
184
|
+
Run every write task in a registered Git worktree and task branch. Do not share
|
|
185
|
+
the primary worktree between writers.
|
|
141
186
|
|
|
142
|
-
|
|
143
|
-
|
|
187
|
+
```bash
|
|
188
|
+
python3 docs/tools/autopipeline/ap.py task-start <TASK_ID> \
|
|
189
|
+
--owned-path <PATH> [--owned-path <PATH> ...] \
|
|
190
|
+
[--depends-on <TASK_ID>=<SHA> ...] [--writer <WRITER>]
|
|
191
|
+
# Enter the worktree path printed by task-start.
|
|
192
|
+
python3 docs/tools/autopipeline/ap.py task-status <TASK_ID>
|
|
193
|
+
python3 docs/tools/autopipeline/ap.py task-submodule-sync <TASK_ID>
|
|
194
|
+
python3 docs/tools/autopipeline/ap.py task-review <TASK_ID> \
|
|
195
|
+
--verdict approved --diff-fingerprint <SHA256> [--reviewer <REVIEWER>]
|
|
196
|
+
python3 docs/tools/autopipeline/ap.py task-handoff <TASK_ID> \
|
|
197
|
+
--from <WRITER> --to <WRITER> [--generation <N>]
|
|
198
|
+
python3 docs/tools/autopipeline/ap.py commit-push <TASK_ID> \
|
|
199
|
+
--msg "<TASK_ID>: <summary>" [--writer <WRITER>]
|
|
200
|
+
python3 docs/tools/autopipeline/ap.py task-integrate <TASK_ID>
|
|
201
|
+
python3 docs/tools/autopipeline/ap.py task-resume <TASK_ID>
|
|
202
|
+
```
|
|
144
203
|
|
|
145
|
-
|
|
146
|
-
`
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
204
|
+
`task-start` fixes the task's base revision and records its task branch and
|
|
205
|
+
worktree, repeated `owned_paths`, dependency task/SHA pairs, and the active writer
|
|
206
|
+
lease in the repository manifest. Run `commit-push` only from that registered
|
|
207
|
+
worktree. Changed and staged paths must be a subset of `owned_paths`; an unknown
|
|
208
|
+
change blocks the push and must never be restored, reset, stashed, cleaned, or
|
|
209
|
+
otherwise altered.
|
|
210
|
+
|
|
211
|
+
The lifecycle fields are runtime gates, not advisory notes. `task-review` records
|
|
212
|
+
the reviewer verdict against the current diff fingerprint; any edit, rebase, or
|
|
213
|
+
conflict resolution invalidates that approval. `task-handoff` is the only way to
|
|
214
|
+
transfer the writer lease, and its generation check prevents stale owners from
|
|
215
|
+
resuming writes. `commit-push` validates the active writer (explicit `--writer`
|
|
216
|
+
or `CODEX_THREAD_ID`), path ownership, exact dependency SHAs, and an approved
|
|
217
|
+
current fingerprint before it runs the single fast gate. `task-integrate` repeats
|
|
218
|
+
the dependency and review checks. If integration stops on a conflict, resolve it
|
|
219
|
+
inside the task worktree, run `task-resume`, obtain a fresh review, and then retry
|
|
220
|
+
integration. A target rebase likewise requires a fresh review.
|
|
221
|
+
|
|
222
|
+
The task commit runs project commit hooks once. The internal backup task-branch
|
|
223
|
+
push skips the pre-push hook; the final target-branch push runs it once.
|
|
224
|
+
`task-integrate` creates no second evidence commit.
|
|
225
|
+
|
|
226
|
+
Successful integration removes the clean worktree and merged local branch, and
|
|
227
|
+
deletes the merged remote task branch by default. Use `task-finish <TASK_ID>` to
|
|
228
|
+
retry cleanup for one integrated task and `task-prune` for registered merged
|
|
229
|
+
tasks left behind. Cleanup must refuse dirty worktrees and unmerged branches.
|
|
230
|
+
Before forced task-worktree removal, recursively require initialized submodules
|
|
231
|
+
to be clean and contain no unknown ignored data, local-only history, or
|
|
232
|
+
unmirrored local branches. A submodule with another linked worktree or an
|
|
233
|
+
unrefreshable remote blocks cleanup. Before forced worktree removal, persist its
|
|
234
|
+
refs and reflog commits in the managed Git-common-dir submodule recovery store.
|
|
235
|
+
Do not run submodule deinit from a linked task worktree because its shared config
|
|
236
|
+
can alter the primary checkout.
|
|
237
|
+
`task-start` enables worktree-scoped Git config and seeds task-local submodule
|
|
238
|
+
URLs. After changing `.gitmodules`, run `task-submodule-sync` before submodule
|
|
239
|
+
initialization or sync. Resolve relative URLs with Git's current-worktree
|
|
240
|
+
default-remote semantics. If shared/common submodule config changed after task
|
|
241
|
+
start, report and stop without restoring or overwriting it. Residual module Git
|
|
242
|
+
directories from a manual deinit or removal block forced cleanup until they are
|
|
243
|
+
reinitialized or recovered.
|
|
244
|
+
Integration must not update the primary checkout; pull it explicitly only when
|
|
245
|
+
its user-owned state is ready.
|
|
246
|
+
|
|
247
|
+
Before running `autocoding sync`, finish, integrate, and clean every registered
|
|
248
|
+
v3.0 task with the currently installed 3.0.0 runtime. Sync atomically rejects the
|
|
249
|
+
whole project batch while any schema-v1 task remains, including
|
|
250
|
+
`--components skill`; it never guesses or auto-claims owned paths during upgrade.
|
|
251
|
+
|
|
252
|
+
## Subagent orchestration
|
|
253
|
+
|
|
254
|
+
The main agent owns the task graph and Git lifecycle. Before dispatch, decompose
|
|
255
|
+
the request into bounded units and record for each unit its task ID, role, scope,
|
|
256
|
+
dependencies, acceptance criteria, and expected result. Run only independent
|
|
257
|
+
work concurrently.
|
|
258
|
+
|
|
259
|
+
1. Run justified `explorer`, `docs_researcher`, and `browser_debugger` roles in
|
|
260
|
+
parallel for read-only discovery. Browser work collects reproduction evidence;
|
|
261
|
+
it is not post-push acceptance.
|
|
262
|
+
2. The main agent merges discovery evidence and decides the design, dependency
|
|
263
|
+
graph, and non-overlapping path ownership.
|
|
264
|
+
3. Assign each independent write unit to exactly one `fixer`, one registered task
|
|
265
|
+
branch, and one worktree. Never run two writers in one worktree, and do not let
|
|
266
|
+
the main agent edit a fixer-owned worktree concurrently.
|
|
267
|
+
4. Parallelize fixer units only when they are dependency-free and their owned
|
|
268
|
+
paths do not overlap. Complete implementation → review → gate/integration for
|
|
269
|
+
the current dependency wave, then start the next wave only after its
|
|
270
|
+
prerequisites are integrated into the target branch.
|
|
271
|
+
5. A read-only `reviewer` checks a stable diff after implementation and binds its
|
|
272
|
+
verdict to the diff fingerprint. Blocking findings return to the owning fixer;
|
|
273
|
+
any edit invalidates approval and requires re-review. Record the final verdict
|
|
274
|
+
with `task-review` before handing the writer lease back to the main agent.
|
|
275
|
+
6. Subagents never commit, push, integrate, clean branches, or run the project
|
|
276
|
+
gate. Their versioned result contains node/task/role, base SHA, status,
|
|
277
|
+
dependencies, owned and changed paths, diff fingerprint, evidence, findings,
|
|
278
|
+
verdict, risks, and next owner. Read-only roles return no changed paths.
|
|
279
|
+
7. After all required results return, use `task-handoff` to transfer the lease to
|
|
280
|
+
the main agent. The main agent alone runs `commit-push` for each write task,
|
|
281
|
+
which validates the current review and runs the single fast gate, then
|
|
282
|
+
integrates in dependency order, pushes, and cleans all temporary branches and
|
|
283
|
+
worktrees.
|
|
284
|
+
|
|
285
|
+
`classify` emits a machine-readable `agent_plan` with this stage and ownership
|
|
286
|
+
contract. Micro tasks remain main-agent-only unless useful independent work
|
|
287
|
+
clearly exceeds delegation overhead. If the client cannot run subagents, execute
|
|
288
|
+
the same stages sequentially without weakening worktree isolation.
|
|
151
289
|
|
|
152
290
|
## Default workflow
|
|
153
291
|
|
|
154
292
|
Development:
|
|
155
293
|
|
|
156
294
|
1. Read this file and the active task entry.
|
|
157
|
-
2.
|
|
158
|
-
3.
|
|
159
|
-
4.
|
|
160
|
-
5.
|
|
161
|
-
6.
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
then
|
|
295
|
+
2. Analyze and decompose the request; run or reason through `classify --scope auto`.
|
|
296
|
+
3. Fan out independent discovery roles, then fan their results back into one main-agent design.
|
|
297
|
+
4. Record the smallest useful design note; create DD/ADR only when indicated.
|
|
298
|
+
5. Start one registered worktree per independent write unit with explicit owned paths, dependency SHAs, and writer lease.
|
|
299
|
+
6. Review stable diffs, record their fingerprints with `task-review`, and return findings to their owning fixers until approved.
|
|
300
|
+
7. Hand the writer lease to the main agent. The main agent runs `commit-push` for each write task; it enforces ownership,
|
|
301
|
+
dependency, lease, and current-review gates, executes the one changed-scope fast gate, records
|
|
302
|
+
`DEV-CLOSED`, commits, and pushes the task branch.
|
|
303
|
+
8. The main agent runs `task-integrate` in dependency order to push the target branch and clean the task worktree and
|
|
304
|
+
merged task branches. This completes the push stage and ends the coding task.
|
|
305
|
+
|
|
306
|
+
Do not wait for, poll, diagnose, or record Jenkins/build/deploy results after the
|
|
307
|
+
push. The project owner performs real acceptance separately.
|
|
308
|
+
|
|
309
|
+
The authoritative order is analysis, decomposition, design, development, fast
|
|
310
|
+
local gate, then push. Do not mark unexecuted external checks as PASS.
|
|
173
311
|
|
|
174
312
|
## Structure policy
|
|
175
313
|
|
|
@@ -210,10 +348,24 @@ python3 docs/tools/autopipeline/ap.py doctor
|
|
|
210
348
|
python3 docs/tools/autopipeline/ap.py classify --scope auto
|
|
211
349
|
python3 docs/tools/autopipeline/ap.py light-gate --scope auto --explain
|
|
212
350
|
python3 docs/tools/autopipeline/ap.py structure-check --scope auto
|
|
351
|
+
python3 docs/tools/autopipeline/ap.py task-start <TASK_ID> --owned-path <PATH>
|
|
352
|
+
python3 docs/tools/autopipeline/ap.py task-status <TASK_ID>
|
|
353
|
+
python3 docs/tools/autopipeline/ap.py task-submodule-sync <TASK_ID>
|
|
354
|
+
python3 docs/tools/autopipeline/ap.py task-review <TASK_ID> --verdict approved --diff-fingerprint <SHA256>
|
|
355
|
+
python3 docs/tools/autopipeline/ap.py task-handoff <TASK_ID> --from <WRITER> --to <WRITER>
|
|
213
356
|
python3 docs/tools/autopipeline/ap.py commit-push <TASK_ID> --msg "<TASK_ID>: <summary>"
|
|
357
|
+
python3 docs/tools/autopipeline/ap.py task-integrate <TASK_ID>
|
|
358
|
+
python3 docs/tools/autopipeline/ap.py task-resume <TASK_ID>
|
|
359
|
+
python3 docs/tools/autopipeline/ap.py task-finish <TASK_ID>
|
|
360
|
+
python3 docs/tools/autopipeline/ap.py task-prune
|
|
214
361
|
python3 docs/tools/autopipeline/ap.py docs-ledger-check
|
|
215
362
|
python3 docs/tools/autopipeline/ap.py gate-profile
|
|
216
363
|
```
|
|
217
364
|
|
|
365
|
+
`light-gate` is available for an explicit gate-diagnostic task. Do not run it
|
|
366
|
+
before normal `commit-push`; `commit-push` owns the single automatic gate.
|
|
367
|
+
|
|
218
368
|
The launcher under `docs/tools/autopipeline` delegates to the single runtime in
|
|
219
369
|
`.agents/skills/auto-coding-skill/scripts`; do not duplicate that runtime.
|
|
370
|
+
|
|
371
|
+
<!-- auto-coding-skill:managed-workflow:end -->
|
|
@@ -4,9 +4,9 @@ Before code changes, read the configured structure standard and place new code i
|
|
|
4
4
|
Obey `structure.layer_rules` import boundaries unless a DD/ADR explicitly records the exception.
|
|
5
5
|
Before optimization reviews, read the project health baseline and optimization backlog, and report only new, worsened, unrecorded P0/P1, or upgraded-priority items.
|
|
6
6
|
Route work through already available MCP servers, installed skills, plugins, and app connectors when they provide current docs, design context, browser evidence, GitHub/CI state, security review, or artifact rendering.
|
|
7
|
-
Use the `.agents/agents` role model when available
|
|
8
|
-
|
|
7
|
+
Use the `.agents/agents` role model when available. The main agent decomposes and fans out independent explorer/docs_researcher/browser_debugger work, fans evidence into one design, assigns each independent fixer exactly one registered branch/worktree with explicit non-overlapping paths, routes stable diffs through reviewer and back to the owning fixer, then alone runs the fast gate, commits, integrates in dependency order, pushes, and cleans. Never run two writers in one worktree; start dependent write work only after its prerequisite is integrated. If the client cannot run subagents, execute the same stages sequentially without weakening isolation.
|
|
8
|
+
Use exactly one fast changed-scope local gate before pushing. Keep advisory structure, docs-ledger, full regression, Docker, API, Jenkins, and target checks outside the default development gate.
|
|
9
9
|
Keep active docs ledgers small: `taskbook.md`, `closure-log.md`, and top-level `docs/design/T*.md` must be physically archived when over budget. Use `docs-ledger-archive --plan` before `--write`; `archive-index.md` is only navigation.
|
|
10
10
|
Keep `docs/tasks/evidence.jsonl` and closure Markdown aligned with actual executed checks.
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
Treat target-branch push as coding completion. Do not wait for, poll, diagnose, or fix Jenkins/build/deploy results unless the user starts a separate diagnostic task; the project owner performs acceptance.
|
|
12
|
+
Use the direct URL, username, and password values configured under `access.*` in `docs/ENGINEERING.md`; do not invent credentials.
|
|
@@ -1,16 +1,17 @@
|
|
|
1
1
|
# Closure Log
|
|
2
2
|
|
|
3
|
-
Record one
|
|
4
|
-
|
|
3
|
+
Record one development closure per task. `DEV-CLOSED` means the fast local gate
|
|
4
|
+
passed and the code was pushed. Jenkins, deployment, and owner acceptance happen
|
|
5
|
+
later and do not change the coding closure.
|
|
5
6
|
|
|
6
7
|
## <TASK_ID> — <Title> — YYYY-MM-DD HH:MM
|
|
7
8
|
|
|
8
9
|
- Commit:
|
|
9
10
|
- Effective profile: micro | standard | high-risk
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
- Result: DEV-CLOSED
|
|
11
|
+
- Fast local gate:
|
|
12
|
+
- Target push:
|
|
13
|
+
- External build/deploy/acceptance: owner-managed
|
|
14
|
+
- Result: DEV-CLOSED
|
|
14
15
|
- Follow-up:
|
|
15
16
|
|
|
16
17
|
---
|
|
@@ -6,16 +6,23 @@ they are useful.
|
|
|
6
6
|
|
|
7
7
|
## Task T0001 — <Title>
|
|
8
8
|
|
|
9
|
-
- Status: Planned | Designing | Implementing | Checking |
|
|
9
|
+
- Status: Planned | Designing | Implementing | Checking | Pushed | Blocked
|
|
10
10
|
- Scope:
|
|
11
|
+
- Orchestrator:
|
|
12
|
+
- Owning fixer:
|
|
13
|
+
- Registered worktree / branch:
|
|
14
|
+
- Owned paths:
|
|
15
|
+
- Depends on integrated tasks:
|
|
16
|
+
- Reviewer / stable diff:
|
|
17
|
+
- Review verdict: pending | approved | changes-requested
|
|
11
18
|
- Non-goals:
|
|
12
19
|
- Effective profile: micro | standard | high-risk
|
|
13
20
|
- Classification reasons:
|
|
14
21
|
- Existing owner / reuse points:
|
|
15
22
|
- Minimal design:
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
- Commit /
|
|
23
|
+
- Development acceptance criteria:
|
|
24
|
+
- Fast local gate evidence:
|
|
25
|
+
- Commit / target push:
|
|
19
26
|
- Follow-up:
|
|
20
27
|
|
|
21
28
|
---
|