taskplane 0.19.0 → 0.20.0

package/skills/create-taskplane-task/references/prompt-template.md

@@ -100,7 +100,6 @@ Copy this template when creating a new task. Replace all `[bracketed]` fields.
 - [ ] "Must Update" docs modified
 - [ ] "Check If Affected" docs reviewed
 - [ ] Discoveries logged in STATUS.md
-- [ ] `.DONE` created in this folder
 
 ## Documentation Requirements
 
@@ -115,7 +114,6 @@ Copy this template when creating a new task. Replace all `[bracketed]` fields.
 - [ ] All steps complete
 - [ ] All tests passing
 - [ ] Documentation updated
-- [ ] `.DONE` created
 
 ## Git Commit Convention
 
@@ -208,7 +206,6 @@ this from PROMPT.md.
 - [ ] "Must Update" docs modified
 - [ ] "Check If Affected" docs reviewed
 - [ ] Discoveries logged
-- [ ] `.DONE` created
 
 ---
 

package/templates/agents/task-worker.md

@@ -19,7 +19,22 @@ completing each step before moving to the next.
 4. Within that step, find the **first unchecked checkbox** (`- [ ]`)
 5. Resume from there — do NOT redo checked items (`- [x]`)
 6. When a step's items are all checked, proceed to the next incomplete step
-7. If all steps are complete, report completion
+7. If all steps are complete, update STATUS.md **Status** field to `✅ Complete`
+   and **Current Step** to the last step name — this is your final action
+
+## CRITICAL: Never Exit Without Updating STATUS.md
+
+**Every turn MUST end with a tool call.** Do NOT produce a text-only response
+and stop — the task-runner interprets that as "session complete" and will
+terminate your process. If you have nothing left to do:
+
+1. Read STATUS.md to verify all checkboxes are checked
+2. Update the Status field to `✅ Complete`
+3. Commit your final changes
+
+**After running tests:** Immediately update STATUS.md checkboxes for the
+testing step BEFORE producing any summary. Check off each item as it passes.
+Do NOT run tests and then stop — always checkpoint the results first.
 
 ## Checkpoint Discipline (CRITICAL)
 

package/templates/tasks/EXAMPLE-001-hello-world/PROMPT.md

@@ -1,99 +1,98 @@
-# Task: EXAMPLE-001 — Hello World
-
-**Created:** {{date}}
-**Size:** S
-
-## Review Level: 0 (None)
-
-**Assessment:** Trivial single-file task to verify Taskplane is working.
-**Score:** 0/8 — Blast radius: 0, Pattern novelty: 0, Security: 0, Reversibility: 0
-
-## Canonical Task Folder
-
-```
-{{tasks_root}}/EXAMPLE-001-hello-world/
-├── PROMPT.md   ← This file (immutable above --- divider)
-├── STATUS.md   ← Execution state (worker updates this)
-├── .reviews/   ← Reviewer output (task-runner creates this)
-└── .DONE       ← Created when complete
-```
-
-## Mission
-
-Create a simple `hello-taskplane.md` file in the project root to verify that
-Taskplane task execution is working correctly. This is a smoke test — if the
-worker can read this prompt, create the file, checkpoint progress, and mark the
-task done, the installation is healthy.
-
-## Expected File Content
-
-`hello-taskplane.md` should include:
-
-- A title line (for example: `# Hello from Taskplane`)
-- A line containing the task ID: `EXAMPLE-001`
-- A line containing today's date
-
-## Dependencies
-
-- **None**
-
-## Context to Read First
-
-_No additional context needed._
-
-## Environment
-
-- **Workspace:** Project root
-- **Services required:** None
-
-## File Scope
-
-- `hello-taskplane.md`
-
-## Steps
-
-### Step 0: Preflight
-
-- [ ] Verify this PROMPT.md is readable
-- [ ] Verify STATUS.md exists in the same folder
-
-### Step 1: Create Hello File
-
-- [ ] Create `hello-taskplane.md` in the project root
-- [ ] Add a title plus lines containing today's date and task ID `EXAMPLE-001`
-
-### Step 2: Verification
-
-- [ ] Verify `hello-taskplane.md` exists and matches the expected content
-
-### Step 3: Delivery
-
-- [ ] `.DONE` created in this folder
-
-## Documentation Requirements
-
-**Must Update:** None
-**Check If Affected:** None
-
-## Completion Criteria
-
-- [ ] `hello-taskplane.md` exists in the project root
-- [ ] `hello-taskplane.md` includes a title, task ID (`EXAMPLE-001`), and current date
-- [ ] `.DONE` exists in the task folder
-
-## Git Commit Convention
-
-- **Implementation:** `feat(EXAMPLE-001): description`
-- **Checkpoints:** `checkpoint: EXAMPLE-001 description`
-
-## Do NOT
-
-- Modify any existing project files
-- Create files outside the project root
-- Over-engineer this — it's a smoke test
-
----
-
-## Amendments (Added During Execution)
-
-<!-- Workers add amendments here if issues discovered during execution. -->
+# Task: EXAMPLE-001 — Hello World
+
+**Created:** {{date}}
+**Size:** S
+
+## Review Level: 0 (None)
+
+**Assessment:** Trivial single-file task to verify Taskplane is working.
+**Score:** 0/8 — Blast radius: 0, Pattern novelty: 0, Security: 0, Reversibility: 0
+
+## Canonical Task Folder
+
+```
+{{tasks_root}}/EXAMPLE-001-hello-world/
+├── PROMPT.md   ← This file (immutable above --- divider)
+├── STATUS.md   ← Execution state (worker updates this)
+├── .reviews/   ← Reviewer output (task-runner creates this)
+└── .DONE       ← Created when complete
+```
+
+## Mission
+
+Create a simple `hello-taskplane.md` file in the project root to verify that
+Taskplane task execution is working correctly. This is a smoke test — if the
+worker can read this prompt, create the file, checkpoint progress, and mark the
+task done, the installation is healthy.
+
+## Expected File Content
+
+`hello-taskplane.md` should include:
+
+- A title line (for example: `# Hello from Taskplane`)
+- A line containing the task ID: `EXAMPLE-001`
+- A line containing today's date
+
+## Dependencies
+
+- **None**
+
+## Context to Read First
+
+_No additional context needed._
+
+## Environment
+
+- **Workspace:** Project root
+- **Services required:** None
+
+## File Scope
+
+- `hello-taskplane.md`
+
+## Steps
+
+### Step 0: Preflight
+
+- [ ] Verify this PROMPT.md is readable
+- [ ] Verify STATUS.md exists in the same folder
+
+### Step 1: Create Hello File
+
+- [ ] Create `hello-taskplane.md` in the project root
+- [ ] Add a title plus lines containing today's date and task ID `EXAMPLE-001`
+
+### Step 2: Verification
+
+- [ ] Verify `hello-taskplane.md` exists and matches the expected content
+
+### Step 3: Delivery
+
+
+
+## Documentation Requirements
+
+**Must Update:** None
+**Check If Affected:** None
+
+## Completion Criteria
+
+- [ ] `hello-taskplane.md` exists in the project root
+- [ ] `hello-taskplane.md` includes a title, task ID (`EXAMPLE-001`), and current date
+
+## Git Commit Convention
+
+- **Implementation:** `feat(EXAMPLE-001): description`
+- **Checkpoints:** `checkpoint: EXAMPLE-001 description`
+
+## Do NOT
+
+- Modify any existing project files
+- Create files outside the project root
+- Over-engineer this — it's a smoke test
+
+---
+
+## Amendments (Added During Execution)
+
+<!-- Workers add amendments here if issues discovered during execution. -->

package/templates/tasks/EXAMPLE-001-hello-world/STATUS.md

@@ -1,73 +1,73 @@
-# EXAMPLE-001: Hello World — Status
-
-**Current Step:** Not Started
-**Status:** 🔵 Ready for Execution
-**Last Updated:** {{date}}
-**Review Level:** 0
-**Review Counter:** 0
-**Iteration:** 0
-**Size:** S
-
----
-
-### Step 0: Preflight
-**Status:** ⬜ Not Started
-
-- [ ] Verify PROMPT.md is readable
-- [ ] Verify STATUS.md exists
-
----
-
-### Step 1: Create Hello File
-**Status:** ⬜ Not Started
-
-- [ ] Create `hello-taskplane.md` in project root
-- [ ] Add title, date, and task ID (EXAMPLE-001)
-
----
-
-### Step 2: Verification
-**Status:** ⬜ Not Started
-
-- [ ] Verify file exists and matches expected content
-
----
-
-### Step 3: Delivery
-**Status:** ⬜ Not Started
-
-- [ ] `.DONE` created
-
----
-
-## Reviews
-
-| # | Type | Step | Verdict | File |
-|---|------|------|---------|------|
-
----
-
-## Discoveries
-
-| Discovery | Disposition | Location |
-|-----------|-------------|----------|
-
----
-
-## Execution Log
-
-| Timestamp | Action | Outcome |
-|-----------|--------|---------|
-| {{date}} | Task staged | PROMPT.md and STATUS.md created |
-
----
-
-## Blockers
-
-*None*
-
----
-
-## Notes
-
-*This is an example task created by `taskplane init`. Delete it after verifying your setup works.*
+# EXAMPLE-001: Hello World — Status
+
+**Current Step:** Not Started
+**Status:** 🔵 Ready for Execution
+**Last Updated:** {{date}}
+**Review Level:** 0
+**Review Counter:** 0
+**Iteration:** 0
+**Size:** S
+
+---
+
+### Step 0: Preflight
+**Status:** ⬜ Not Started
+
+- [ ] Verify PROMPT.md is readable
+- [ ] Verify STATUS.md exists
+
+---
+
+### Step 1: Create Hello File
+**Status:** ⬜ Not Started
+
+- [ ] Create `hello-taskplane.md` in project root
+- [ ] Add title, date, and task ID (EXAMPLE-001)
+
+---
+
+### Step 2: Verification
+**Status:** ⬜ Not Started
+
+- [ ] Verify file exists and matches expected content
+
+---
+
+### Step 3: Delivery
+**Status:** ⬜ Not Started
+
+
+
+---
+
+## Reviews
+
+| # | Type | Step | Verdict | File |
+|---|------|------|---------|------|
+
+---
+
+## Discoveries
+
+| Discovery | Disposition | Location |
+|-----------|-------------|----------|
+
+---
+
+## Execution Log
+
+| Timestamp | Action | Outcome |
+|-----------|--------|---------|
+| {{date}} | Task staged | PROMPT.md and STATUS.md created |
+
+---
+
+## Blockers
+
+*None*
+
+---
+
+## Notes
+
+*This is an example task created by `taskplane init`. Delete it after verifying your setup works.*

package/templates/tasks/EXAMPLE-002-parallel-smoke/PROMPT.md

@@ -1,98 +1,97 @@
-# Task: EXAMPLE-002 — Parallel Smoke
-
-**Created:** {{date}}
-**Size:** S
-
-## Review Level: 0 (None)
-
-**Assessment:** Trivial parallel-safe smoke task to demonstrate orchestrator lanes.
-**Score:** 0/8 — Blast radius: 0, Pattern novelty: 0, Security: 0, Reversibility: 0
-
-## Canonical Task Folder
-
-```
-{{tasks_root}}/EXAMPLE-002-parallel-smoke/
-├── PROMPT.md   ← This file (immutable above --- divider)
-├── STATUS.md   ← Execution state (worker updates this)
-├── .reviews/   ← Reviewer output (task-runner creates this)
-└── .DONE       ← Created when complete
-```
-
-## Mission
-
-Create a simple `hello-taskplane-2.md` file in the project root. This task is
-intentionally independent from EXAMPLE-001 so both can run in parallel when
-using `/orch`.
-
-## Expected File Content
-
-`hello-taskplane-2.md` should include:
-
-- A title line (for example: `# Parallel Hello from Taskplane`)
-- A line containing the task ID: `EXAMPLE-002`
-- A short note that this task is parallel-safe
-
-## Dependencies
-
-- **None**
-
-## Context to Read First
-
-_No additional context needed._
-
-## Environment
-
-- **Workspace:** Project root
-- **Services required:** None
-
-## File Scope
-
-- `hello-taskplane-2.md`
-
-## Steps
-
-### Step 0: Preflight
-
-- [ ] Verify this PROMPT.md is readable
-- [ ] Verify STATUS.md exists in the same folder
-
-### Step 1: Create Parallel Hello File
-
-- [ ] Create `hello-taskplane-2.md` in the project root
-- [ ] Add title plus lines containing task ID `EXAMPLE-002` and a parallel-safe note
-
-### Step 2: Verification
-
-- [ ] Verify `hello-taskplane-2.md` exists and matches the expected content
-
-### Step 3: Delivery
-
-- [ ] `.DONE` created in this folder
-
-## Documentation Requirements
-
-**Must Update:** None
-**Check If Affected:** None
-
-## Completion Criteria
-
-- [ ] `hello-taskplane-2.md` exists in the project root
-- [ ] `hello-taskplane-2.md` includes a title, task ID (`EXAMPLE-002`), and a parallel-safe note
-- [ ] `.DONE` exists in the task folder
-
-## Git Commit Convention
-
-- **Implementation:** `feat(EXAMPLE-002): description`
-- **Checkpoints:** `checkpoint: EXAMPLE-002 description`
-
-## Do NOT
-
-- Modify any existing project files
-- Create files outside the project root
-- Add dependencies between EXAMPLE-001 and EXAMPLE-002
-
----
-
-## Amendments (Added During Execution)
-
-<!-- Workers add amendments here if issues discovered during execution. -->
+# Task: EXAMPLE-002 — Parallel Smoke
+
+**Created:** {{date}}
+**Size:** S
+
+## Review Level: 0 (None)
+
+**Assessment:** Trivial parallel-safe smoke task to demonstrate orchestrator lanes.
+**Score:** 0/8 — Blast radius: 0, Pattern novelty: 0, Security: 0, Reversibility: 0
+
+## Canonical Task Folder
+
+```
+{{tasks_root}}/EXAMPLE-002-parallel-smoke/
+├── PROMPT.md   ← This file (immutable above --- divider)
+├── STATUS.md   ← Execution state (worker updates this)
+├── .reviews/   ← Reviewer output (task-runner creates this)
+└── .DONE       ← Created when complete
+```
+
+## Mission
+
+Create a simple `hello-taskplane-2.md` file in the project root. This task is
+intentionally independent from EXAMPLE-001 so both can run in parallel when
+using `/orch`.
+
+## Expected File Content
+
+`hello-taskplane-2.md` should include:
+
+- A title line (for example: `# Parallel Hello from Taskplane`)
+- A line containing the task ID: `EXAMPLE-002`
+- A short note that this task is parallel-safe
+
+## Dependencies
+
+- **None**
+
+## Context to Read First
+
+_No additional context needed._
+
+## Environment
+
+- **Workspace:** Project root
+- **Services required:** None
+
+## File Scope
+
+- `hello-taskplane-2.md`
+
+## Steps
+
+### Step 0: Preflight
+
+- [ ] Verify this PROMPT.md is readable
+- [ ] Verify STATUS.md exists in the same folder
+
+### Step 1: Create Parallel Hello File
+
+- [ ] Create `hello-taskplane-2.md` in the project root
+- [ ] Add title plus lines containing task ID `EXAMPLE-002` and a parallel-safe note
+
+### Step 2: Verification
+
+- [ ] Verify `hello-taskplane-2.md` exists and matches the expected content
+
+### Step 3: Delivery
+
+
+
+## Documentation Requirements
+
+**Must Update:** None
+**Check If Affected:** None
+
+## Completion Criteria
+
+- [ ] `hello-taskplane-2.md` exists in the project root
+- [ ] `hello-taskplane-2.md` includes a title, task ID (`EXAMPLE-002`), and a parallel-safe note
+
+## Git Commit Convention
+
+- **Implementation:** `feat(EXAMPLE-002): description`
+- **Checkpoints:** `checkpoint: EXAMPLE-002 description`
+
+## Do NOT
+
+- Modify any existing project files
+- Create files outside the project root
+- Add dependencies between EXAMPLE-001 and EXAMPLE-002
+
+---
+
+## Amendments (Added During Execution)
+
+<!-- Workers add amendments here if issues discovered during execution. -->