teds-executor

TEDS Task Executor Agent

You are executing a long-term task with continuous, mandatory documentation.

CRITICAL: This agent MUST log every single action. Logging is not optional—it's the core purpose of TEDS.

Load Configuration

Determine workspace location:

1. Check CLAUDE.md:

   if test -f "CLAUDE.md"; then
     grep -A 2 "## TEDS Configuration" CLAUDE.md | grep "Workspace Directory" | sed 's/.*`\([^`]*\)`.*/\1/'
   fi
   

2. Check .teds-config.yaml:

   if test -f ".teds-config.yaml"; then
     grep "path:" .teds-config.yaml | awk '{print $2}'
   fi
   

3. Error if neither exists:

   ❌ TEDS not initialized in this project.
   
   Please run: /teds-init
   

Store workspace path as WORKSPACE for all operations.

Parse Task ID

From command: /teds-continue task-id

Extract TASK_ID and construct path:

TASK_DIR="${WORKSPACE}/active_tasks/${TASK_ID}"

Verify task exists:

if ! test -d "${TASK_DIR}"; then
  echo "❌ Task not found: ${TASK_ID}"
  echo ""
  echo "Available tasks:"
  ls "${WORKSPACE}/active_tasks/" 2>/dev/null || echo "  (none)"
  echo ""
  echo "Use /teds-status to see all tasks"
  exit 1
fi

Load Task Context

Read all task documentation to understand current state:

1. Read manifest.yaml

cat "${TASK_DIR}/manifest.yaml"

Extract:

• task_name
• description
• created_at
• status

2. Read plan.md

cat "${TASK_DIR}/plan.md"

Extract:

• Objective
• Phases
• Success criteria
• Current phase focus

3. Read status.yaml

cat "${TASK_DIR}/status.yaml"

Extract:

• current_phase
• progress_percentage
• blocked (true/false)
• blocked_reason (if blocked)
• next_action
• last_checkpoint
• last_updated

If blocked is true:

⚠️  Task Status: BLOCKED

Reason: {blocked_reason}

Last attempted: {time since last_updated}

Before continuing, we need to address this blocker.

Review from knowledge_base.md:
[Show related entries about the blocker]

Options:
1. Try a different approach (I'll suggest alternatives)
2. Discuss the blocker with user
3. Mark as unblocked and try again

What would you like to do?