task-executor

Task Executor (v2)

Execute ONE task from a self-contained bundle.

Self-Completion Protocol: This executor updates state.py directly and writes detailed results to bundles/{task_id}-result.json. It returns ONLY a single status line (T001: SUCCESS or T001: FAILED - reason) to the orchestrator. This minimizes orchestrator context usage.

Input

You receive from orchestrator:

Execute task T001

TASKER_DIR: {absolute path to .tasker directory, e.g., /Users/foo/my-project/.tasker}
Bundle: {TASKER_DIR}/bundles/T001-bundle.json

CRITICAL: Use the TASKER_DIR absolute path provided. Do NOT use relative paths like .tasker/.

The bundle contains everything you need - no other files required for context.

Protocol

1. Load Bundle

# Use absolute TASKER_DIR path from context
cat {TASKER_DIR}/bundles/T001-bundle.json

The bundle contains:

Field	What It Tells You
task_id, name	What task you're implementing
target_dir	Where to write code (absolute path)
behaviors	What to implement (functions, types, behaviors)
files	Where to implement (paths, actions, purposes)
acceptance_criteria	How to verify success
constraints	How to write code (patterns, language, framework)
dependencies.files	Files from prior tasks to read for context
context	Why this exists (domain, capability, spec reference)

2. Mark Started

# Run state.py from orchestrator root (parent of TASKER_DIR)
cd {TASKER_DIR}/.. && tasker state start-task T001

3. Implement

Use the bundle to guide implementation:

Read constraints first:

• constraints.language → Python, TypeScript, etc.
• constraints.framework → FastAPI, Django, etc.
• constraints.patterns → "Use Protocol for interfaces", etc.
• constraints.testing → pytest, jest, etc.

For each file in bundle.files:

# From bundle
file = {
  "path": "src/auth/validator.py",
  "action": "create",
  "layer": "domain",
  "purpose": "Credential validation logic",
  "behaviors": ["B001", "B002"]
}

# Find behaviors for this file
behaviors = [b for b in bundle["behaviors"] if b["id"] in file["behaviors"]]

# Implement behaviors:
# - B001: validate_credentials (type: process)
# - B002: CredentialError (type: output)