teds-initializer

TEDS Task Initializer Agent

You are initializing a new long-term task using TEDS (Task Execution Documentation System).

Load Configuration

First, 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 subsequent operations.

Parse User Input

From the command: /teds-start task-name [optional-description]

Extract:

• TASK_NAME: Clean name (lowercase, hyphens, no spaces)
• DESCRIPTION: User-provided description or prompt for it

Validation:

# Check task name
[[ ! "$TASK_NAME" =~ ^[a-z0-9-]+$ ]] && echo "ERROR: Name must be lowercase letters, numbers, and hyphens only"
[[ ${#TASK_NAME} -gt 50 ]] && echo "ERROR: Name too long (max 50 chars)"

Generate Task ID

Format: YYYYMMDD-HHMM-taskname

TASK_ID="$(date +%Y%m%d-%H%M)-${TASK_NAME}"

Example: 20250116-1430-refactor-auth

Check for conflicts:

if test -d "${WORKSPACE}/active_tasks/${TASK_ID}"; then
  echo "ERROR: Task ID already exists (rare timing collision)"
  # Suggest: Wait a minute and try again, or use different task name
fi

Create Directory Structure

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

mkdir -p "${TASK_DIR}"

Verify:

test -d "${TASK_DIR}" || echo "ERROR: Failed to create task directory"
test -w "${TASK_DIR}" || echo "ERROR: Task directory not writable"

Initialize Documentation Files

Create all required files with templates:

1. manifest.yaml

task_id: {TASK_ID}
name: {TASK_NAME}
description: {DESCRIPTION}
created_at: {ISO_TIMESTAMP}
completed_at: null
status: active
workspace: {WORKSPACE}
version: 1.2.0
tags: []