start

# Loop

Autonomous iteration with wave-based parallel execution. Continues until spec is satisfied or limits reached.

## Architecture

```
User Request
    ↓
[STATE DETECTION] → Resume? / Start fresh?
    ↓
[RECALL LEARNINGS] → surface past failures/discoveries
    ↓
[SPEC + FIT SCORING] → <5? hope:intent, calculate fit_score
    ↓
[SHAPE GENERATION] → hope:shape, extract criteria/mustNot
    ↓
[DECOMPOSITION] → atomic tasks via TaskCreate
    ↓
[WAVE EXECUTION] → parallel subagents + light expert review
    ↓
[THOROUGH REVIEW] → counsel:panel, resolve blockers
    ↓
[COMPLETION] → hope:gate verification
```

---

## Step 0: State Detection & Resume

Before starting, check for existing workflow state:

### 0a. Detect Existing State

```
1. Check .loop/workflow-state.json exists
2. Check .loop/shape/SHAPE.md exists
3. Check TaskList for pending/in_progress tasks
4. Read workflow-state.json if exists
```

### 0b. Resume Decision

```dot
digraph ResumeDecision {
  rankdir=TB
  node [shape=box, style="rounded,filled", fillcolor="#f5f5f5"]

  Start [label="/loop:start", fillcolor="#e6f3ff"]
  Check [label="Check for\nworkflow-state.json"]
  Exists [label="State\nexists?", shape=diamond, fillcolor="#fff4cc"]
  NoState [label="No state\nfound"]
  Ask [label="AskUserQuestion:\nResume / Fresh / Status", fillcolor="#ffe6cc"]

  Resume [label="Resume", fillcolor="#ccffcc"]
  Fresh [label="Start Fresh", fillcolor="#ffffcc"]
  Status [label="View Status", fillcolor="#e6f3ff"]

  ReadStage [label="Read current_stage\nfrom state"]
  SkipTo [label="Jump to\nstage logic"]
  Delete [label="Delete .loop/\ndirectory"]
  ShowStatus [label="/loop:status"]
  Config [label="Step 0c:\nUser Config"]

  Start -> Check -> Exists
  Exists -> Ask [label="yes"]
  Exists -> NoState [label="no"]
  NoState -> Config

  Ask -> Resume
  Ask -> Fresh
  Ask -> Status

  Resume -> ReadStage -> SkipTo
  Fresh -> Delete -> Config
  Status -> ShowStatus -> Ask [style=dashed]
}
```

On "Resume": Skip to cur