2.5 KiB
2.5 KiB
Task Implementation Execution Protocol (tasks/do.md)
This protocol defines the standard for executing an approved task from
tasks/new/.
1. Direct Execution Protocol (When You Are Doing the Task)
When commanded to "tasks/do [TASK_FILE]":
- Keep in New During Work: The task file remains in
tasks/new/while work is in progress. - Follow the 4-Step State Machine:
- Step 1 (Research): Inspect the target files and verify architectural assumptions.
- Step 2 (Implementation): Apply minimal, pure functional modifications. Preserve existing docstrings and comments.
- Step 3 (Quality Gates): Run all verification gates:
deno fmtdeno task lintdeno task checkdeno test --allow-all(Run ONLY hermetic unit tests; NEVER rundeno task startin container sandboxes).
- Step 4 (Review & Move): Upon all gates passing, move the task file
directly from
tasks/new/totasks/complete/YYYY-MMDD.XX.agent.type.scope.title-HHMM.md. (If the session must end without completing the task, park it intasks/wip/).
- Commit & Sync: Commit with standard conventional commit syntax and push
to both remotes (
originandgitea).
2. Dispatch Template (When Preparing a Prompt for Jules or External Agents)
When commanded to "tasks/do a prompt for Jules on [TASK_FILE]", fill in
and provide the following block:
**Role:** Act as an Implementation Engineer.
**The Task:** Please review and execute the approved task plan in `[tasks/new/TASK_FILENAME.md]`.
**Directives & Guidelines:**
- Adhere strictly to the repository architecture and operating protocols in `AGENTS.md` and `tasks/GUIDELINES.md`.
- Keep the task file in `tasks/new/` during execution; only move it to `tasks/complete/` upon successful verification (or park in `tasks/wip/` only if work cannot be finished in this session).
- Run ONLY hermetic unit tests (`deno test --allow-all`). Do NOT start long-running servers (`deno task start` / `deno task dev`).
**Acceptance Criteria:**
- Run and pass all quality gates: `deno fmt`, `deno task lint`, `deno task check`, and `deno test --allow-all`.
- Ensure the git working tree contains only intentional modifications to target deliverables (zero untracked or temporary files).
- Move the task file from `tasks/new/` directly to `tasks/complete/YYYY-MMDD.XX.agent.type.scope.title-HHMM.md` (or park in `tasks/wip/` only if work cannot be finished in this session).