chore: improve harness guidance and ACP debugging (#1969)
This commit is contained in:
@@ -134,6 +134,13 @@ For each user-facing scenario in the spec:
|
||||
|
||||
---
|
||||
|
||||
## Verification Results
|
||||
Pending. On completion, synchronize this section with each task's `## Results`:
|
||||
record exact commands and outcomes/counts, generated artifact paths, and
|
||||
cleanup/teardown evidence.
|
||||
|
||||
---
|
||||
|
||||
## Implementation Waves And Parallel Candidates
|
||||
|
||||
Group task files by dependency order. Use waves to expose possible parallelism,
|
||||
@@ -189,7 +196,7 @@ spec: "../../specs/<slug>/spec.md"
|
||||
|
||||
Each task should be small enough for one focused implementation pass:
|
||||
- **Acceptance:** 1-3 concrete conditions.
|
||||
- **Verification:** exact command(s), e.g. `cd apps/backend && go test -run TestName ./internal/path/...` or `cd apps && pnpm --filter @kandev/web test -- path/to/file.test.ts`.
|
||||
- **Verification:** exact command(s), e.g. `cd apps/backend && go test -run TestName ./internal/path/...` or `cd apps && pnpm --filter @kandev/web test -- path/to/file.test.ts`. Frontend/E2E tasks must include the fresh-worktree bootstrap (`cd apps && pnpm install --frozen-lockfile`) when dependencies may be absent; direct web typechecking uses `cd apps/web && pnpm run typecheck`, while other workspace package commands use the documented `pnpm --filter` form. Backend commands should use the applicable repository `make` target when one exists.
|
||||
- **Files likely touched:** specific paths, not broad directories.
|
||||
- **Dependencies:** task numbers that must land first, or `None`.
|
||||
- **Parallelism:** `sequential` by default; set `parallel-safe` only with named
|
||||
@@ -198,11 +205,20 @@ Each task should be small enough for one focused implementation pass:
|
||||
- **Output contract:** summary, files changed, tests run, blockers, risks, and
|
||||
task/plan status update in the same conversation.
|
||||
|
||||
## Results
|
||||
Pending. Before marking the task done, replace this with every exact command
|
||||
actually run and its outcome/count, generated artifact paths, and cleanup or
|
||||
teardown evidence (including temporary capture-spec removal and
|
||||
`git diff --check` when used). Record security/trust and external side-effect
|
||||
boundaries when applicable, or explicitly state `None`.
|
||||
|
||||
Break a task down further if it touches unrelated subsystems, needs more than one focused session, or the title contains "and".
|
||||
|
||||
When an implementation agent starts the task, it must change `status` to
|
||||
`in_progress`. When it finishes, it must change `status` to `done` and update
|
||||
the corresponding checkbox/status in `plan.md`.
|
||||
`in_progress`. Before it finishes, reconcile **Files likely touched** with the
|
||||
actual diff, including modified existing tests used as E2E evidence. It may then
|
||||
change `status` to `done`, update its `## Results`, and synchronize the
|
||||
corresponding checkbox/status and `## Verification Results` in `plan.md`.
|
||||
```
|
||||
|
||||
### Style rules
|
||||
|
||||
Reference in New Issue
Block a user