Story Execution Orchestrator

Purpose & Scope

• Load Story + task metadata (no descriptions) and drive execution
• Process tasks in order: To Review → To Rework → Todo (foundation-first within each status)
• Delegate per task type to appropriate workers (see Worker Invocation table)
• Mandatory immediate review: Every execution/rework → ln-402 immediately. No batching

Task Storage Mode

shared/references/storage_mode_detection.md

When to Use

• Story is Todo or In Progress and has implementation/refactor/test tasks to finish
• Need automated orchestration through To Review and quality gates

Workflow

Phase 1: Discovery & Branch Setup

1. Auto-discover Team ID/config from kanban_board.md + CLAUDE.md
2. Get Story identifier (e.g., PROJ-42) and title
3. Generate branch name:

   feature/{identifier}-{story-title-slug}

   (lowercase, spaces→dashes, no special chars)
4. Check current branch:

   git branch --show-current

5. If not matching:
   • If branch exists:

     git checkout feature/{identifier}-{slug}

   • If not:

     git checkout -b feature/{identifier}-{slug}

Phase 2: Load Metadata

• Linear Mode:

  list_issues(parentId=Story.id)

• File Mode:

  Glob("docs/tasks/epics/*/stories/{story-slug}/tasks/*.md")

  + parse

  **Status:**

Phase 3: Context Review (before Todo tasks)

1. Load task description (get_issue or Read task file)
2. Extract referenced files from task plan
3. Check: Do files exist? Have related files changed? Are patterns still valid?
4. Decision: No conflicts → proceed | Minor changes → update task, proceed | Major conflicts → ask user

Phase 4: Task Loop

1. Delegate to worker via Task tool (see Worker Invocation table)
2. Reload metadata after subagent completes (task count may increase — ln-402 creates [BUG] tasks)
3. If worker sets status != To Review → STOP and report
4. After ln-401/ln-403/ln-404: Immediately invoke ln-402 on same task

Execute → Review → Next. Never skip review. Never batch reviews.

Phase 5: Quality Gate

1. Invoke ln-500-story-quality-gate Pass 1 via Task tool
2. If creates tasks → return to Phase 4
3. When test task Done → invoke Pass 2
4. If Pass 2 fails and creates tasks → return to Phase 4
5. If Pass 2 passes → Story Done

Worker Invocation

CRITICAL: All delegations use Task tool with subagent_type: "general-purpose" for context isolation.

Task(description: "[Action] task {ID}",
     prompt: "Execute {skill-name} for task {ID}. Read skill from {skill-name}/SKILL.md.",
     subagent_type: "general-purpose")

Formats

TodoWrite (mandatory)

1. Execute [Task-ID]: [Title]

   — mark in_progress when starting

2. Review [Task-ID]: [Title]

   — mark in_progress after executor, completed after ln-402

Critical Rules

1. Branch isolation: All work in

   feature/{story-id}-{slug}

   . Never commit to main/master
2. Metadata first: Never load task descriptions in Phase 2; workers load full text
3. One task at a time: Pick → delegate → review → next. No bulk operations
4. Only ln-402 sets Done: Stop and report if any worker leaves task Done or In Progress
5. Source of truth: Trust Linear metadata (Linear Mode) or task files (File Mode)
6. Story status: ln-400 handles Todo→In Progress→To Review; ln-500 handles To Review→Done
7. Commit policy: Only ln-402 commits code. Workers (ln-401/ln-403/ln-404) leave changes uncommitted for ln-402 to review and commit with task ID reference.
8. [BUG] tasks: ln-402 may create new [BUG] tasks mid-review. After metadata reload, reprioritize — new tasks processed in next loop iteration.

Anti-Patterns

• ❌ Running

  mypy

  /

  ruff

  /

  pytest

  directly instead of skill invocation
• ❌ "Minimal quality check" then asking "Want me to run full skill?"
• ❌ Skipping/batching reviews
• ❌ Self-setting Done status without ln-402
• ❌ Any execution bypassing Task tool subagent

Plan Mode Support

1. Build task execution sequence by priority
2. For each task show: ID, Title, Status, Worker, expected status after
3. Include Quality Gate phases
4. Write plan to plan file, call ExitPlanMode

## Execution Plan for Story {STORY-ID}: {Title}

| # | Task ID | Title | Status | Executor | Reviewer |
|---|---------|-------|--------|----------|----------|
| 1 | {ID} | {Title} | {Status} | ln-40X | ln-402 |

### Sequence
1. [Execute] {Task-1} via ln-401-task-executor
2. [Review] {Task-1} via ln-402-task-reviewer
...
N. [Quality Gate Pass 1/2] via ln-500-story-quality-gate

Definition of Done

• Working in correct feature branch (verified in Phase 1)
• Story and task metadata loaded; counts shown
• Context Review performed for Todo tasks (or skipped with justification)
• Loop executed: all tasks delegated with immediate review after each
• ln-500 Pass 1/Pass 2 invoked; result handled
• Story status transitions applied; kanban updated by workers
• Final report with task counts

Reference Files

• Orchestrator lifecycle:

  shared/references/orchestrator_pattern.md

• Task delegation pattern:

  shared/references/task_delegation_pattern.md

• Auto-discovery patterns:

  shared/references/auto_discovery_pattern.md

• Plan mode behavior:

  shared/references/plan_mode_pattern.md

• Storage mode detection:

  shared/references/storage_mode_detection.md

• Quality orchestration:

  ../ln-500-story-quality-gate/SKILL.md

• Executors:

  ../ln-401-task-executor/SKILL.md

  ,

  ../ln-403-task-rework/SKILL.md

  ,

  ../ln-404-test-executor/SKILL.md

• Reviewer:

  ../ln-402-task-reviewer/SKILL.md

• Auto-discovery:

  CLAUDE.md

  ,

  docs/tasks/kanban_board.md