aether-colony 3.1.0 → 3.1.2

package/.aether/visualizations/anthill-stages/brood-stable.txt

@@ -0,0 +1,26 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+         🥚  🥚              🥚  🥚
+              .      .      .      .
+             /|\    /|\    /|\    /|\
+            / | \  / | \  / | \  / | \
+           /  |  \/  |  \/  |  \/  |  \
+          /   |   /\  |   /\  |   /\  |   \
+         /____|__/___\|___/___\|___/___\|____\
+        /  o   /  o   \  o   /  o   \  o   \
+       /______/_______\_____/_______\_______\
+      /_______________________________________\
+     /_________________________________________\
+    /___________________________________________\
+   /_____________________________________________\
+  /_______________________________________________\
+
+🐜🐜🐜 Brood chamber thriving...
+   New life stirs in the nursery,
+   the colony's future secured.
+
+Milestone: Brood Stable
+Phases: 4-6 completed
+Colony Age: Established

package/.aether/visualizations/anthill-stages/crowned-anthill.txt

@@ -0,0 +1,30 @@
+                        👑
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              ✨         ✨         ✨
+         🥚  🥚  🥚  🥚  🥚  🥚  🥚  🥚  🥚
+    .      .      .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   \  o   /  o   /
+  \____/_______\_____/_______\_____/_______\_____/_______/
+   \_______________________________________________________/
+    \_______________________________________________________\
+     \_______________________________________________________\
+      \_______________________________________________________\
+       \_______________________________________________________\
+        \_______________________________________________________\
+         \_______________________________________________________\
+
+🐜🐜🐜🐜🐜🐜 The Crowned Anthill!
+   A monument to collective effort,
+   the colony stands supreme.
+
+Milestone: Crowned Anthill
+Phases: 15+ completed
+Colony Age: Legendary

package/.aether/visualizations/anthill-stages/first-mound.txt

@@ -0,0 +1,18 @@
+              .      .
+             /|\    /|\
+            / | \  / | \
+           /  |  \/  |  \
+          /   |   /\  |   \
+         /____|__/___\|____\
+        /      /     \      \
+       /______/_______\______\
+      /________________________\
+     /__________________________\
+
+🐜 A humble beginning...
+   Just a small mound of earth,
+   but full of potential.
+
+Milestone: First Mound
+Phases: 0 completed
+Colony Age: Newborn

package/.aether/visualizations/anthill-stages/open-chambers.txt

@@ -0,0 +1,24 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              .      .      .
+             /|\    /|\    /|\
+            / | \  / | \  / | \
+           /  |  \/  |  \/  |  \
+          /   |   /\  |   /\  |   \
+         /____|__/___\|___/___\|____\
+        /  o   /  o   \  o   /  o   \
+       /______/_______\_____/_______\
+      /_______________________________\
+     /_________________________________\
+    /___________________________________\
+   /_____________________________________\
+
+🐜🐜 Tunnels open...
+   The colony expands its reach,
+   chambers forming beneath the earth.
+
+Milestone: Open Chambers
+Phases: 1-3 completed
+Colony Age: Growing

package/.aether/visualizations/anthill-stages/sealed-chambers.txt

@@ -0,0 +1,28 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              🔒         🔒
+         🥚  🥚  🥚  🥚  🥚  🥚  🥚
+    .      .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   \  o   /
+  \____/_______\_____/_______\_____/_______\_____/
+   \_______________________________________________/
+    \_______________________________________________\
+     \_______________________________________________\
+      \_______________________________________________\
+       \_______________________________________________\
+        \_______________________________________________\
+
+🐜🐜🐜🐜🐜 Chambers sealed...
+   Fortified against the outside world,
+   treasures protected, secrets kept.
+
+Milestone: Sealed Chambers
+Phases: 11-14 completed
+Colony Age: Seasoned

package/.aether/visualizations/anthill-stages/ventilated-nest.txt

@@ -0,0 +1,27 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              🌬️         🌬️
+         🥚  🥚  🥚      🥚  🥚  🥚
+    .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   /
+  \____/_______\_____/_______\_____/_______/
+   \_________________________________________/
+    \_________________________________________\
+     \_________________________________________\
+      \_________________________________________\
+       \_________________________________________\
+
+🐜🐜🐜🐜 Air flows through...
+   Complex passages ventilate the nest,
+   workers move with purpose and speed.
+
+Milestone: Ventilated Nest
+Phases: 7-10 completed
+Colony Age: Mature

package/.claude/commands/ant/build.md

@@ -217,7 +217,7 @@ CONSTRAINTS: (none)
       Scanning history of files to be modified...
    ```
 
-   Spawn a Scout (using Task tool with `subagent_type="general-purpose"`) with this prompt:
+   Spawn a Scout (using Task tool with `subagent_type="general"`) with this prompt:
 
    ```
    You are {Archaeologist-Name}, a 🏺 Archaeologist Ant (Scout) in the Aether Colony.
@@ -236,6 +236,10 @@ CONSTRAINTS: (none)
    4. Run: git blame "{file_path}" | head -40 to see authorship of key sections
    5. Note any TODO/FIXME/HACK markers in the current code
 
+   --- MODEL CONTEXT ---
+   Assigned model: {model} (from caste: archaeologist)
+   This ant is running as: {Ant-Name} (archaeologist caste)
+
    --- OUTPUT ---
    For each file, report:
    - WHY key code sections exist (from commit messages)
@@ -244,6 +248,9 @@ CONSTRAINTS: (none)
    - Areas of caution (high churn, reverted changes, emergency fixes)
    - Sections that are stable bedrock vs volatile sand
 
+   Include in your header:
+   Model: {model} | Caste: archaeologist | Ant: {Ant-Name}
+
    Keep the report concise and actionable — builders need quick context, not a thesis.
    Format as plain text with file headers. No JSON output needed.
    ```
@@ -270,17 +277,39 @@ CONSTRAINTS: (none)
    The `archaeology_context` will be injected into builder prompts in Step 5.1 (see below).
    If this step was skipped (no existing files modified), the archaeology section is omitted from builder prompts.
 
-### Step 5: Analyze Tasks and Plan Spawns
+### Step 5: Initialize Swarm Display and Analyze Tasks
 
 **YOU (the Queen) will spawn workers directly. Do NOT delegate to a single Prime Worker.**
 
-Log phase start:
+**Initialize visual swarm tracking:**
 ```bash
+# Generate unique build ID
+build_id="build-$(date +%s)"
+
+# Initialize swarm display for this build
+bash .aether/aether-utils.sh swarm-display-init "$build_id"
+
+# Log phase start
 bash .aether/aether-utils.sh activity-log "EXECUTING" "Queen" "Phase {id}: {name} - Queen dispatching workers"
+
+# Display animated header
+bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Phase {id}: {name}" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 10 "fungus_garden" 0
+```
+
+**Show real-time display header:**
+```
+🔨🐜 COLONY BUILD INITIATED 🐜🔨
+═══════════════════════════════════════════════════
+Phase {id}: {name}
+Build ID: {build_id}
+
+Launching swarm display... (visual tracking enabled)
 ```
 
 Analyze the phase tasks:
 
+Analyze the phase tasks:
+
 1. **Group tasks by dependencies:**
    - **Wave 1:** Tasks with `depends_on: "none"` or `depends_on: []` (can run in parallel)
    - **Wave 2:** Tasks depending on Wave 1 tasks
@@ -321,56 +350,14 @@ Total: {N} Builders + 1 Watcher + 1 Chaos = {N+2} spawns
 
 **CRITICAL: Spawn ALL Wave 1 workers in a SINGLE message using multiple Task tool calls.**
 
-For each Wave 1 task, use Task tool with `subagent_type="general-purpose"` and `run_in_background: true`:
+For each Wave 1 task, use Task tool with `subagent_type="general"` and `run_in_background: true`:
 
-Log each spawn:
+Log each spawn and update swarm display:
 ```bash
 bash .aether/aether-utils.sh spawn-log "Queen" "builder" "{ant_name}" "{task_description}"
+bash .aether/aether-utils.sh swarm-display-update "{ant_name}" "builder" "excavating" "{task_description}" "Queen" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 10
 ```
 
-**Model Assignment:**
-
-Before spawning each worker, get the optimal model for their caste with task-based routing:
-
-```bash
-# Get model assignment for this caste with task-based routing
-model_info=$(bash .aether/aether-utils.sh model-profile select "{caste}" "{task_description}" "{cli_model_override}")
-model=$(echo "$model_info" | jq -r '.result.model')
-source=$(echo "$model_info" | jq -r '.result.source')
-
-# Log model assignment with source
-bash .aether/aether-utils.sh activity-log "MODEL" "Queen" "{ant_name} ({caste}): assigned to $model (source: $source)"
-```
-
-**Environment Setup for Workers:**
-
-When spawning workers, the following environment variables must be set for Claude Code to use the LiteLLM proxy with the correct model:
-
-```bash
-export ANTHROPIC_BASE_URL="http://localhost:4000"
-export ANTHROPIC_AUTH_TOKEN="sk-litellm-local"
-export ANTHROPIC_MODEL="$model"  # From model-profile get above
-```
-
-**IMPORTANT:** The Task tool inherits environment from the parent Claude Code process. Set these variables in the shell before spawning workers, or ensure they are already set in the parent environment.
-
-### Step 5.1.5: Export Model Environment
-
-Before spawning workers, export the environment variables for LiteLLM proxy routing:
-
-```bash
-export ANTHROPIC_BASE_URL="http://localhost:4000"
-export ANTHROPIC_AUTH_TOKEN="sk-litellm-local"
-```
-
-For each worker spawn, also export their specific model:
-
-```bash
-export ANTHROPIC_MODEL="$model"  # From model-profile get
-```
-
-**Note:** These environment variables will be inherited by spawned workers via the Task tool, enabling automatic model routing through the LiteLLM proxy.
-
 **Builder Worker Prompt Template:**
 ```
 You are {Ant-Name}, a 🔨 Builder Ant in the Aether Colony at depth {depth}.
@@ -378,16 +365,6 @@ You are {Ant-Name}, a 🔨 Builder Ant in the Aether Colony at depth {depth}.
 --- YOUR TASK ---
 Task {id}: {description}
 
---- MODEL CONTEXT ---
-Optimal model for this task: {model} (from caste: {caste})
-Model characteristics: {model_description}
-Task complexity expectation: {simple|medium|complex}
-
-The model has been pre-selected based on your caste's typical work patterns.
-- glm-5: Use for complex reasoning, architecture, planning
-- kimi-k2.5: Use for fast implementation, coding, refactoring
-- minimax-2.5: Use for validation, research, quick checks
-
 --- CONTEXT ---
 Goal: "{colony_goal}"
 Phase: {phase_name}
@@ -449,7 +426,7 @@ Before spawning:
   1. Check: bash .aether/aether-utils.sh spawn-can-spawn {depth}
   2. Generate name: bash .aether/aether-utils.sh generate-ant-name "{caste}"
   3. Log: bash .aether/aether-utils.sh spawn-log "{your_name}" "{caste}" "{child_name}" "{task}"
-  4. Use Task tool with subagent_type="general-purpose"
+  4. Use Task tool with subagent_type="general"
   5. After completion: bash .aether/aether-utils.sh spawn-complete "{child_name}" "{status}" "{summary}"
 
 Full spawn format: .aether/workers.md section "Spawning Sub-Workers"
@@ -465,7 +442,13 @@ Return JSON:
   "files_modified": [],
   "tests_written": [],
   "blockers": [],
-  "spawns": []
+  "spawns": [],
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "builder",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -480,11 +463,15 @@ For each spawned worker, call TaskOutput with `block: true` to wait for completi
 
 Store all results for synthesis in Step 5.6.
 
-For each completed worker, log:
+For each completed worker, log and update swarm display:
 ```bash
 bash .aether/aether-utils.sh spawn-complete "{ant_name}" "completed" "{summary}"
+bash .aether/aether-utils.sh swarm-display-update "{ant_name}" "builder" "completed" "{task_description}" "Queen" '{"read":5,"grep":3,"edit":2,"bash":1}' 100 "fungus_garden" 100
 ```
 
+**Update swarm display with accumulated tool usage:**
+As workers complete, accumulate their actual tool usage (Read, Grep, Edit, Bash counts from their activity logs) and update the swarm display to show live progress.
+
 **Only proceed to Step 5.3 after ALL Wave 1 TaskOutput calls have returned.**
 
 ### Step 5.3: Spawn Wave 2+ Workers (Sequential Waves)
@@ -497,6 +484,7 @@ Repeat Step 5.1-5.2 for each subsequent wave, waiting for previous wave to compl
 
 ```bash
 bash .aether/aether-utils.sh spawn-log "Queen" "watcher" "{watcher_name}" "Independent verification"
+bash .aether/aether-utils.sh swarm-display-update "{watcher_name}" "watcher" "observing" "Verification in progress" "Queen" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "nursery" 50
 ```
 
 **Watcher Worker Prompt:**
@@ -588,7 +576,13 @@ Return JSON:
   "issues_found": [],
   "quality_score": N,
   "recommendation": "proceed" | "fix_required",
-  "spawns": []
+  "spawns": [],
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "watcher",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -601,6 +595,11 @@ Call TaskOutput with `block: true` using the Watcher's task_id:
 - Parse: verification_passed, issues_found, quality_score, recommendation
 - Store results for synthesis in Step 5.6
 
+**Update swarm display when Watcher completes:**
+```bash
+bash .aether/aether-utils.sh swarm-display-update "{watcher_name}" "watcher" "completed" "Verification complete" "Queen" '{"read":3,"grep":2,"edit":0,"bash":1}' 100 "nursery" 100
+```
+
 **Only proceed to Step 5.4.2 after Watcher TaskOutput has returned.**
 
 ### Step 5.4.2: Spawn Chaos Ant for Resilience Testing
@@ -611,6 +610,7 @@ Generate a chaos ant name and log the spawn:
 ```bash
 bash .aether/aether-utils.sh generate-ant-name "chaos"
 bash .aether/aether-utils.sh spawn-log "Queen" "chaos" "{chaos_name}" "Resilience testing of Phase {id} work"
+bash .aether/aether-utils.sh swarm-display-update "{chaos_name}" "chaos" "probing" "Resilience testing" "Queen" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "refuse_pile" 75
 ```
 
 **Retrieve existing flags for this phase** (to avoid duplicate findings):
@@ -619,7 +619,7 @@ bash .aether/aether-utils.sh flag-list --phase {phase_number}
 ```
 Parse the result and extract unresolved flag titles into a list: `{existing_flag_titles}` (comma-separated titles from `.result.flags[].title`). If no flags exist, set `{existing_flag_titles}` to "None".
 
-Spawn the Chaos Ant using Task tool with `subagent_type="general-purpose"`:
+Spawn the Chaos Ant using Task tool with `subagent_type="general"`:
 
 **Chaos Ant Prompt:**
 ```
@@ -666,7 +666,13 @@ Return JSON:
     }
   ],
   "overall_resilience": "strong|moderate|weak",
-  "summary": "..."
+  "summary": "...",
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "chaos",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -690,9 +696,10 @@ Log the flag:
 bash .aether/aether-utils.sh activity-log "FLAG" "Chaos" "Created blocker: {finding.title}"
 ```
 
-Log chaos ant completion:
+Log chaos ant completion and update swarm display:
 ```bash
 bash .aether/aether-utils.sh spawn-complete "{chaos_name}" "completed" "{summary}"
+bash .aether/aether-utils.sh swarm-display-update "{chaos_name}" "chaos" "completed" "Resilience testing done" "Queen" '{"read":2,"grep":1,"edit":0,"bash":0}' 100 "refuse_pile" 100
 ```
 
 **Only proceed to Step 5.5 after Chaos Ant TaskOutput has returned.**
@@ -858,7 +865,23 @@ Use AskUserQuestion to get approval. Record in events:
 
 **This step runs ONLY after synthesis is complete. All values come from actual worker results.**
 
-Display build summary based on synthesis results AND `verbose_mode` from Step 1:
+**First, render the final swarm display showing all completed workers:**
+```bash
+# Final swarm display update - mark Queen as completed
+bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "completed" "Phase {id} complete" "Colony" '{"read":10,"grep":5,"edit":5,"bash":2}' 100 "fungus_garden" 100
+
+# Render the final swarm display
+bash .aether/aether-utils.sh swarm-display-render "$build_id"
+```
+
+The swarm display will show:
+- 🐜 All workers with their caste emojis (🔨 Builder, 👁️ Watcher, 🎲 Chaos)
+- 📖 Tool usage stats (Read, Grep, Edit, Bash counts)
+- 🏠 Chamber activity map (Fungus Garden, Nursery, Refuse Pile)
+- ✅ Progress bars at 100% for completed work
+- 🌈 Color-coded by caste
+
+**Then display build summary based on synthesis results AND `verbose_mode` from Step 1:**
 
 **If verbose_mode = false (compact output, ~12 lines):**
 
@@ -930,6 +953,12 @@ Display build summary based on synthesis results AND `verbose_mode` from Step 1:
 🔧 Debugging: {debugging.issues_resolved}/{debugging.issues_encountered} resolved
 {end if}
 
+🤖 Model Routing:
+{for each spawn in spawn_tree where model_context exists:}
+   {caste_emoji}{ant_name}: {model_context.assigned} {if model_context.assigned matches caste expectation:}✓{else}⚠️{end if}
+{end for}
+   Proxy: {if proxy_healthy:}✓ Healthy @ http://localhost:4000{else}✗ Not running (using default model){end if}
+
 🐜 Next Steps:
 {if synthesis.status == "completed" AND verification.recommendation == "proceed":}
    /ant:continue   ➡️  Advance to next phase

package/.claude/commands/ant/continue.md

@@ -42,10 +42,10 @@ If successful and goal is not null:
    🔄 Resuming: Phase X - Name
    ```
 
-If HANDOFF.md exists (detected in load-state output):
+If .aether/HANDOFF.md exists (detected in load-state output):
 - Display "Resuming from paused session"
-- Read HANDOFF.md for additional context
-- Remove HANDOFF.md after display (cleanup)
+- Read .aether/HANDOFF.md for additional context
+- Remove .aether/HANDOFF.md after display (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.
 
@@ -736,6 +736,48 @@ Set `last_commit_suggestion_phase` to `{phase_id}` in COLONY_STATE.json (add the
 
 **Error handling:** If any git command fails (not a repo, merge conflict, pre-commit hook rejection), display the error output and continue to the next step. The commit suggestion is advisory only -- it never blocks the flow.
 
+Continue to Step 2.7 (Context Clear Suggestion), then to Step 2.5 (Project Completion) or Step 3 (Display Result).
+
+### Step 2.7: Context Clear Suggestion (Optional)
+
+**This step is non-blocking. Skipping does not affect phase advancement.**
+
+After committing (or skipping commit), suggest clearing context to refresh before the next phase.
+
+1. **Display the suggestion:**
+```
+──────────────────────────────────────────────────
+Context Refresh
+──────────────────────────────────────────────────
+
+State is fully persisted and committed.
+Phase {next_id} is ready to build.
+
+──────────────────────────────────────────────────
+```
+
+2. **Use AskUserQuestion:**
+```
+Clear context now?
+
+1. Yes, clear context then run /ant:build {next_id}
+2. No, continue in current context
+```
+
+3. **If option 1 ("Yes, clear context"):**
+
+   **IMPORTANT:** Claude Code does not support programmatic /clear. Display instructions:
+   ```
+   Please type: /clear
+   
+   Then run: /ant:build {next_id}
+   ```
+   
+   Record the suggestion: Set `context_clear_suggested` to `true` in COLONY_STATE.json.
+
+4. **If option 2 ("No, continue in current context"):**
+   Display: `Continuing in current context. State is saved.`
+
 Continue to Step 2.5 (Project Completion) or Step 3 (Display Result).
 
 ### Step 2.5: Project Completion
@@ -798,7 +840,7 @@ Output:
    /ant:phase {next_id}   📋 Review phase details first
    /ant:focus "<area>"    🎯 Guide colony attention
 
-💾 State persisted — safe to /clear, then run /ant:build {next_id}
+💾 State persisted — context clear suggested above
 ```
 
 **IMPORTANT:** In the "Next Steps" section above, substitute the actual phase number for `{next_id}` (calculated in Step 2 as `current_phase + 1`). For example, if advancing to phase 4, output `/ant:build 4` not `/ant:build {next_id}`.

package/.claude/commands/ant/organize.md

@@ -48,7 +48,7 @@ If no active signals after filtering:
 
 Read `.aether/workers.md` and extract the `## Architect` section.
 
-Spawn via **Task tool** with `subagent_type="general-purpose"`:
+Spawn via **Task tool** with `subagent_type="general"`:
 
 ```
 --- WORKER SPEC ---

package/.claude/commands/ant/pause-colony.md

@@ -69,7 +69,7 @@ Run `/ant:resume-colony` in a new session.
 <what should happen next>
 ```
 
-### Step 4.6: Set Paused Flag in State
+### Step 4.5: Set Paused Flag in State
 
 Use Read tool to get current COLONY_STATE.json.
 
@@ -80,7 +80,7 @@ Use Write tool to update COLONY_STATE.json with paused flag:
 
 This flag indicates the colony is in a paused state and will be cleared on resume.
 
-### Step 4.5: Commit Suggestion (Optional)
+### Step 4.6: Commit Suggestion (Optional)
 
 **This step is non-blocking. Skipping does not affect the pause or any subsequent steps. Failure to commit has zero consequences.**
 

package/.claude/commands/ant/plan.md

@@ -44,10 +44,10 @@ If successful and goal is not null:
    🔄 Resuming: Phase X - Name
    ```
 
-If HANDOFF.md exists (detected in load-state output):
+If .aether/HANDOFF.md exists (detected in load-state output):
 - Display "Resuming from paused session"
-- Read HANDOFF.md for additional context
-- Remove HANDOFF.md after display (cleanup)
+- Read .aether/HANDOFF.md for additional context
+- Remove .aether/HANDOFF.md after display (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.
 
@@ -123,7 +123,7 @@ while iteration < 50 AND confidence < 95:
 
     # === RESEARCH PHASE ===
 
-    Spawn Research Ant (Scout) via Task tool with subagent_type="general-purpose":
+    Spawn Research Ant (Scout) via Task tool with subagent_type="general":
 
     """
     You are a Scout Ant in the Aether Colony.
@@ -173,7 +173,7 @@ while iteration < 50 AND confidence < 95:
 
     # === PLANNING PHASE ===
 
-    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="general-purpose":
+    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="general":
 
     """
     You are a Route-Setter Ant in the Aether Colony.

package/.claude/commands/ant/resume-colony.md

@@ -47,7 +47,7 @@ Output header:
 ═══════════════════════════════════════════════════ 🚦➡️🐜💨💨
 ```
 
-Read the HANDOFF.md for context about what was happening, then display:
+Read the .aether/HANDOFF.md for context about what was happening, then display:
 
 ```
 +=====================================================+
@@ -67,23 +67,12 @@ ACTIVE PHEROMONES
 
   If no active signals: (no active pheromones)
 
-WORKERS
-
-  If ALL workers have "idle" status, display:
-    All 6 workers idle -- colony ready
-
-  Otherwise, group by status with caste name:
-    Active:
-      builder: currently executing
-    Idle:
-      colonizer  route-setter  watcher  scout  architect
-
 PHASE PROGRESS
   Phase <id>: <name> [<status>]
   (list all phases from plan.phases)
 
 CONTEXT FROM HANDOFF
-  <summarize what was happening from HANDOFF.md>
+  <summarize what was happening from .aether/HANDOFF.md>
 
 NEXT ACTIONS
 ```

package/.claude/commands/ant/status.md

@@ -63,11 +63,11 @@ If successful and goal is not null:
       Last activity: timestamp
    ```
 
-5. Check for HANDOFF.md existence in the load-state output or via separate check
-6. If HANDOFF.md exists:
+5. Check for .aether/HANDOFF.md existence in the load-state output or via separate check
+6. If .aether/HANDOFF.md exists:
    - Display: "Resuming from paused session"
-   - Read HANDOFF.md content for additional context
-   - Remove HANDOFF.md after displaying (cleanup)
+   - Read .aether/HANDOFF.md content for additional context
+   - Remove .aether/HANDOFF.md after displaying (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.