aether-colony 3.1.17 → 5.1.0

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

@@ -1,3 +1,4 @@
+<!-- Generated from .aether/commands/organize.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:organize
 description: "🧹🐜🏛️🐜🧹 Run codebase hygiene report - archivist ant scans for stale files, dead code, orphaned configs (report-only)"
@@ -9,6 +10,10 @@ You are the **Queen Ant Colony**. Spawn an archivist to analyze codebase hygiene
 
 ## Instructions
 
+Parse `$ARGUMENTS`:
+- If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
+- Otherwise: set `visual_mode = true`
+
 ### Step 1: Read State
 
 Use the Read tool to read these files (in parallel):
@@ -18,7 +23,6 @@ Use the Read tool to read these files (in parallel):
 From COLONY_STATE.json, extract:
 - `goal` from top level
 - `plan.phases` for phase data
-- `signals` for pheromone data
 - `errors.records` for error patterns
 - `memory` for decisions/learnings
 - `events` for activity
@@ -27,11 +31,12 @@ From COLONY_STATE.json, extract:
 
 ### Step 2: Compute Active Pheromones
 
-Read active signals from COLONY_STATE.json `signals` array (already loaded in Step 1).
+Run using the Bash tool with description "Loading active pheromones...":
+```bash
+bash .aether/aether-utils.sh pheromone-read
+```
 
-Filter signals where:
-- `expires_at` is null (permanent signals like INIT), OR
-- `expires_at` > current timestamp (not expired)
+Use `.result.signals` as the active signal list (already decay-filtered by runtime logic).
 
 Format as the standard ACTIVE PHEROMONES block:
 ```
@@ -44,12 +49,12 @@ If no active signals after filtering:
   (no active pheromones)
 ```
 
-### Step 3: Spawn Archivist (Architect-Ant)
+### Step 3: Spawn Archivist (Keeper-Ant)
 
-Read `.aether/workers.md` and extract the `## Architect` section.
+Read `.aether/workers.md` and extract the `## Keeper` section.
 
-Spawn via **Task tool** with `subagent_type="aether-architect"`:
-# FALLBACK: If "Agent type not found", use general-purpose and inject role: "You are an Architect Ant - synthesizes knowledge and coordinates documentation."
+Spawn via **Task tool** with `subagent_type="aether-keeper"`:
+# FALLBACK: If "Agent type not found", use general-purpose and inject role: "You are a Keeper Ant - curates knowledge and synthesizes patterns."
 
 ```
 --- WORKER SPEC ---
@@ -116,14 +121,14 @@ Check for configuration that may not be connected:
 Produce your report in this exact structure:
 
 CODEBASE HYGIENE REPORT
-========================
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Project: {goal}
 Scanned: {timestamp}
 Confidence threshold: HIGH findings are actionable, MEDIUM/LOW are informational
 
 HIGH CONFIDENCE FINDINGS
--------------------------
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 {For each HIGH confidence finding:}
   [{category}] {description}
     Evidence: {what data/observation supports this}
@@ -132,7 +137,7 @@ HIGH CONFIDENCE FINDINGS
 {If no HIGH findings: "No high-confidence hygiene issues detected."}
 
 MEDIUM CONFIDENCE OBSERVATIONS
--------------------------------
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 {For each MEDIUM confidence finding:}
   [{category}] {description}
     Evidence: {what data/observation supports this}
@@ -141,14 +146,14 @@ MEDIUM CONFIDENCE OBSERVATIONS
 {If no MEDIUM findings: "No medium-confidence observations."}
 
 LOW CONFIDENCE NOTES
----------------------
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 {For each LOW confidence finding:}
   [{category}] {description}
 
 {If no LOW findings: "No low-confidence notes."}
 
 SUMMARY
---------
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   High: {count} actionable findings
   Medium: {count} observations
   Low: {count} notes
@@ -165,23 +170,22 @@ CONSTRAINTS:
 
 ### Step 4: Display Report
 
-After the architect-ant returns, display header:
+After the keeper-ant returns, display header:
 
 ```
-🧹🐜🏛️🐜🧹 ═══════════════════════════════════════════════════
+🧹🐜🏛️🐜🧹 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    C O D E B A S E   H Y G I E N E   R E P O R T
-═══════════════════════════════════════════════════ 🧹🐜🏛️🐜🧹
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🧹🐜🏛️🐜🧹
 ```
 
-Then display using Bash tool (white -- architect color):
-
-```
-bash -c 'printf "\e[37m+=====================================================+\e[0m\n"'
-bash -c 'printf "\e[37m|  CODEBASE HYGIENE REPORT                            |\e[0m\n"'
-bash -c 'printf "\e[37m+=====================================================+\e[0m\n\n"'
+Then display using Bash tool with description "Displaying hygiene report header...":
+```bash
+bash -c 'printf "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"'
+bash -c 'printf "   C O D E B A S E   H Y G I E N E   R E P O R T\n"'
+bash -c 'printf "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n"'
 ```
 
-Then display the architect-ant's full report verbatim.
+Then display the keeper-ant's full report verbatim.
 
 ### Step 5: Persist Report
 
@@ -203,7 +207,7 @@ Next:
 
 ### Step 6: Log Activity
 
-Use the Bash tool to run:
+Use the Bash tool with description "Logging hygiene activity..." to run:
 ```
 bash .aether/aether-utils.sh activity-log "COMPLETE" "queen" "Hygiene report generated"
 ```
@@ -216,3 +220,13 @@ All state persisted. Safe to /clear context if needed.
   Report: .aether/data/hygiene-report.md
   Resume: /ant:resume-colony
 ```
+
+### Step 7: Next Up
+
+Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
+```bash
+state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
+current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
+total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
+bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+```