aether-colony 5.3.0 โ†’ 5.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -41,6 +41,7 @@ Do not touch during init:
41
41
  - .aether/dreams/ (user notes)
42
42
  - .aether/chambers/ (archived colonies)
43
43
  - .env* files
44
+ - .claude/settings.json
44
45
  - .github/workflows/
45
46
  </read_only>
46
47
 
@@ -364,14 +365,7 @@ domain_tags=$(bash .aether/aether-utils.sh domain-detect 2>/dev/null | jq -r '.r
364
365
  bash .aether/aether-utils.sh registry-add "$(pwd)" "$(jq -r '.version // "unknown"' ~/.aether/version.json 2>/dev/null || echo 'unknown')" --goal "{approved_intent}" --active true --tags "$domain_tags" 2>/dev/null || true
365
366
  cp ~/.aether/version.json .aether/version.json 2>/dev/null || true
366
367
  ```
367
- 11. Install clash detection hook and merge driver (non-blocking):
368
- ```bash
369
- # Install PreToolUse hook to detect file conflicts across worktrees
370
- bash .aether/aether-utils.sh clash-setup --install 2>/dev/null || true
371
- # Register lockfile merge driver (keeps "ours" on package-lock.json conflicts)
372
- git config merge.lockfile.driver "bash .aether/utils/merge-driver-lockfile.sh %O %A %B" 2>/dev/null || true
373
- ```
374
- 12. Seed QUEEN.md from hive (non-blocking):
368
+ 11. Seed QUEEN.md from hive (non-blocking):
375
369
  ```bash
376
370
  domain_tags=$(jq -r --arg repo "$(pwd)" \
377
371
  '[.repos[] | select(.path == $repo) | .domain_tags // []] | .[0] // [] | join(",")' \
@@ -381,7 +375,7 @@ seed_args="queen-seed-from-hive --limit 5"
381
375
  seed_result=$(bash .aether/aether-utils.sh $seed_args 2>/dev/null || echo '{}')
382
376
  seeded_count=$(echo "$seed_result" | jq -r '.result.seeded // 0' 2>/dev/null || echo "0")
383
377
  ```
384
- 13. Run `bash .aether/aether-utils.sh session-init "{session_id}" "{approved_intent}"`
378
+ 12. Run `bash .aether/aether-utils.sh session-init "{session_id}" "{approved_intent}"`
385
379
 
386
380
  **Pheromone auto-apply (referenced by both re-init and fresh init paths above):**
387
381
 
@@ -377,14 +377,7 @@ domain_tags=$(bash .aether/aether-utils.sh domain-detect 2>/dev/null | jq -r '.r
377
377
  bash .aether/aether-utils.sh registry-add "$(pwd)" "$(jq -r '.version // "unknown"' ~/.aether/version.json 2>/dev/null || echo 'unknown')" --goal "{approved_intent}" --active true --tags "$domain_tags" 2>/dev/null || true
378
378
  cp ~/.aether/version.json .aether/version.json 2>/dev/null || true
379
379
  ```
380
- 11. Install clash detection hook and merge driver (non-blocking):
381
- ```bash
382
- # Install PreToolUse hook to detect file conflicts across worktrees
383
- bash .aether/aether-utils.sh clash-setup --install 2>/dev/null || true
384
- # Register lockfile merge driver (keeps "ours" on package-lock.json conflicts)
385
- git config merge.lockfile.driver "bash .aether/utils/merge-driver-lockfile.sh %O %A %B" 2>/dev/null || true
386
- ```
387
- 12. Seed QUEEN.md from hive (non-blocking):
380
+ 11. Seed QUEEN.md from hive (non-blocking):
388
381
  ```bash
389
382
  domain_tags=$(jq -r --arg repo "$(pwd)" \
390
383
  '[.repos[] | select(.path == $repo) | .domain_tags // []] | .[0] // [] | join(",")' \
@@ -394,7 +387,7 @@ seed_args="queen-seed-from-hive --limit 5"
394
387
  seed_result=$(bash .aether/aether-utils.sh $seed_args 2>/dev/null || echo '{}')
395
388
  seeded_count=$(echo "$seed_result" | jq -r '.result.seeded // 0' 2>/dev/null || echo "0")
396
389
  ```
397
- 13. Run `bash .aether/aether-utils.sh session-init "{session_id}" "{approved_intent}"`
390
+ 12. Run `bash .aether/aether-utils.sh session-init "{session_id}" "{approved_intent}"`
398
391
 
399
392
  **Pheromone auto-apply (referenced by both re-init and fresh init paths above):**
400
393
 
package/README.md CHANGED
@@ -1,75 +1,54 @@
1
1
  <div align="center">
2
2
 
3
- # ๐Ÿœ Aether Colony
3
+ <img src="./AetherBanner.png" alt="Aether" width="100%" />
4
4
 
5
- **Multi-agent AI development for Claude Code and OpenCode**
5
+ # Aether
6
6
 
7
- [![npm version](https://img.shields.io/npm/v/aether-colony.svg?style=flat-square)](https://www.npmjs.com/package/aether-colony)
8
- [![npm downloads](https://img.shields.io/npm/dw/aether-colony.svg?style=flat-square)](https://www.npmjs.com/package/aether-colony)
9
- [![License: MIT](https://img.shields.io/github/license/calcosmic/Aether.svg?style=flat-square)](LICENSE)
10
- [![GitHub stars](https://img.shields.io/github/stars/calcosmic/Aether.svg?style=flat-square)](https://github.com/calcosmic/Aether/stargazers)
11
- [![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-%23ea4aaa.svg?style=flat-square&logo=github)](https://github.com/sponsors/calcosmic)
7
+ **Artificial Ecology for Thought and Emergent Reasoning**
12
8
 
13
- Spawn a colony of 24 AI specialists that self-organize around your goal using pheromone signals.
14
- 1,000+ weekly installs.
9
+ <br>
15
10
 
16
- *Artificial Ecology For Thought and Emergent Reasoning*
11
+ [![npm](https://img.shields.io/npm/v/aether-colony?style=for-the-badge&logo=npm&logoColor=white&label=npm&color=7B3FE4)](https://www.npmjs.com/package/aether-colony)
12
+ [![downloads](https://img.shields.io/npm/dw/aether-colony?style=for-the-badge&logo=npm&logoColor=white&color=333333)](https://www.npmjs.com/package/aether-colony)
13
+ [![license](https://img.shields.io/github/license/calcosmic/Aether?style=for-the-badge&color=333333)](LICENSE)
14
+ [![stars](https://img.shields.io/github/stars/calcosmic/Aether?style=for-the-badge&logo=github&logoColor=white&color=333333)](https://github.com/calcosmic/Aether/stargazers)
15
+ [![sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?style=for-the-badge&logo=github-sponsors&logoColor=white)](https://github.com/sponsors/calcosmic)
17
16
 
18
- *The whole is greater than the sum of its ants.*
17
+ <br>
19
18
 
20
- ```bash
21
- npx aether-colony
19
+ ```
20
+ $ npx aether-colony
22
21
  ```
23
22
 
23
+ <br>
24
+
25
+ *The whole is greater than the sum of its ants.* ๐Ÿœ
26
+
24
27
  </div>
25
28
 
26
- <p align="center">
27
- <img src="./AetherAnts.png" alt="Aether Colony" width="640" />
28
- </p>
29
+ ---
29
30
 
30
- ```
31
- ๐Ÿ‘‘ Queen (you)
32
- โ”‚
33
- โ”‚ set the goal, steer with pheromone signals
34
- โ–ผ
35
- โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
36
- โ”‚ Colony self-organizes โ”‚
37
- โ”‚ โ”‚
38
- โ”‚ ๐Ÿ”จ Builders write code (TDD) โ”‚
39
- โ”‚ ๐Ÿ‘๏ธ Watchers verify & test โ”‚
40
- โ”‚ ๐Ÿ” Scouts research first โ”‚
41
- โ”‚ ๐Ÿ› Trackers investigate bugs โ”‚
42
- โ”‚ ๐Ÿ—บ๏ธ Colonizers explore codebases โ”‚
43
- โ”‚ ๐Ÿ“‹ Route-setters plan phases โ”‚
44
- โ”‚ ๐Ÿบ Archaeologists excavate git history โ”‚
45
- โ”‚ ๐ŸŽฒ Chaos Ants resilience testing โ”‚
46
- โ”‚ ๐Ÿ“š Keepers preserve knowledge โ”‚
47
- โ”‚ ๐Ÿ”ฎ Oracle deep research โ”‚
48
- โ”‚ ...and 24 specialists total โ”‚
49
- โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
50
- ```
31
+ ## Why Aether
51
32
 
52
- ## ๐Ÿœ The Problem
33
+ Every AI coding tool now has "agents." Most of them are the same thing repackaged โ€” a loop that plans, executes, and checks. That's not a colony. That's one ant doing laps.
53
34
 
54
- AI coding assistants work sequentially โ€” one agent does everything: research, code, test, review. When it hits something complex, it either guesses or asks you. There's no specialization, no parallel work, no memory across sessions.
35
+ Aether is different because it's modeled on how **real ant colonies work**: no central brain, no single agent trying to be everything. Instead, 24 specialized workers self-organize around your goal. A Builder writes code. When it hits something unfamiliar, it doesn't guess โ€” it spawns a Scout to research. When code lands, a Watcher spawns to verify. A Tracker hunts bugs. An Archaeologist digs through git history. They work in parallel, in waves, across phases.
55
36
 
56
- ## ๐Ÿœ The Solution
37
+ **What actually makes this different:**
57
38
 
58
- Aether brings **ant colony intelligence** to AI-assisted development. Instead of one AI doing everything, you get a colony of specialists that self-organize around your goal.
39
+ ๐Ÿœ **Pheromone signals, not prompt engineering.** You steer the colony the way a queen steers ants โ€” with signals, not instructions. Drop a FOCUS signal on "security" and every worker weighs it. Drop a REDIRECT on "no raw SQL" and it becomes a hard constraint. The colony adapts without you rewriting prompts.
59
40
 
60
- Workers spawn workers dynamically (max depth 3, max 10 per phase). When a Builder hits something complex, it spawns a Scout to research. When code is written, a Watcher spawns to verify. The colony adapts to the problem.
41
+ ๐Ÿœ **Memory that compounds.** Learnings from one build become instincts for the next. Instincts promote to QUEEN.md wisdom. High-confidence wisdom flows to the Hive Brain and crosses into other projects on your machine. Your colonies get smarter over time.
61
42
 
62
- You steer the colony with **pheromone signals**, not micromanagement:
43
+ ๐Ÿœ **Built to be fun.** You set a goal, the colony builds it. You steer with signals, not micromanagement. You watch workers spawn workers. You seal the colony when it's done and start a new one. It feels like tending a garden, not writing tickets.
63
44
 
64
45
  ```
65
- /ant:focus "security" # ๐ŸŽฏ "Pay attention here"
66
- /ant:redirect "no jQuery" # ๐Ÿšซ "Don't do this" (hard constraint)
67
- /ant:feedback "prefer composition" # ๐Ÿ’ฌ "Adjust based on this"
46
+ /ant:focus "security" # ๐Ÿœ "Pay attention here"
47
+ /ant:redirect "no jQuery" # ๐Ÿœ "Don't do this"
48
+ /ant:feedback "prefer composition" # ๐Ÿœ "Adjust based on this"
68
49
  ```
69
50
 
70
- The colony **remembers**. Wisdom, learnings, and instincts persist across sessions. The ๐Ÿง  Hive Brain shares knowledge across colonies on your machine.
71
-
72
- ## ๐Ÿš€ Quick Start
51
+ ## Quick Start
73
52
 
74
53
  ```bash
75
54
  # Interactive setup (recommended)
@@ -77,184 +56,186 @@ npx aether-colony
77
56
 
78
57
  # Or install globally
79
58
  npm install -g aether-colony
59
+ ```
80
60
 
81
- # In your project repo:
82
- /ant:lay-eggs # ๐Ÿฅš Set up Aether (one-time)
83
- /ant:init "Build X" # ๐ŸŒฑ Start a colony with a goal
84
- /ant:plan # ๐Ÿ“‹ Generate phased roadmap
85
- /ant:run # ๐Ÿœ Autopilot: build, verify, advance all phases
86
- /ant:seal # ๐Ÿบ Done โ€” archive the colony
61
+ Then in your project:
62
+
63
+ ```
64
+ /ant:lay-eggs # Set up Aether (one-time)
65
+ /ant:init "Build X" # Start a colony with a goal
66
+ /ant:plan # Generate phased roadmap
67
+ /ant:run # Autopilot: build, verify, advance all phases
68
+ /ant:seal # Done โ€” archive the colony
87
69
  ```
88
70
 
89
- That's it. Five commands from zero to shipped.
71
+ Five commands from zero to shipped.
90
72
 
91
- ## โœจ Key Features
73
+ ## Key Features
92
74
 
93
- - ๐Ÿœ **24 Specialized Agents** โ€” Real subagents spawned via Task tool, from builders to archaeologists
94
- - โšก **45 Slash Commands** โ€” Full lifecycle management across Claude Code and OpenCode
95
- - ๐ŸŽฏ **Pheromone System** โ€” Guide the colony with FOCUS, REDIRECT, FEEDBACK signals
96
- - ๐Ÿง  **Colony Memory** โ€” Learnings persist across sessions via QUEEN.md wisdom
97
- - ๐ŸŒ **Hive Brain** โ€” Cross-colony wisdom sharing with domain-scoped retrieval
98
- - ๐Ÿ“š **Skills System** โ€” 28 skills (10 colony + 18 domain) inject domain knowledge into workers
99
- - ๐Ÿค– **Autopilot** (`/ant:run`) โ€” Automated build-verify-advance loop with smart pause conditions
100
- - โœ… **6-Phase Verification** โ€” Build, types, lint, tests, security, diff gates before any phase advances
101
- - ๐Ÿ›ก๏ธ **Quality Gates** โ€” Security (Gatekeeper), quality (Auditor), coverage (Probe), performance (Measurer)
102
- - ๐Ÿ” **Per-Phase Research** โ€” Scouts investigate domain knowledge before task decomposition
103
- - ๐Ÿ”ฎ **Oracle Deep Research** โ€” Autonomous research loop for complex investigations
104
- - ๐Ÿ’พ **Pause/Resume** โ€” Full state serialization for context breaks
75
+ | | Feature | Description |
76
+ |---|---------|-------------|
77
+ | **Agents** | 24 Specialized Workers | Builders, Watchers, Scouts, Trackers, Archaeologists, Oracle, and more |
78
+ | **Commands** | 45 Slash Commands | Full lifecycle management across Claude Code and OpenCode |
79
+ | **Signals** | Pheromone System | Guide the colony with FOCUS, REDIRECT, and FEEDBACK signals |
80
+ | **Memory** | Colony Wisdom | Learnings and instincts persist across sessions via QUEEN.md |
81
+ | **Sharing** | Hive Brain | Cross-colony wisdom sharing with domain-scoped retrieval |
82
+ | **Skills** | 28 Skills | 10 colony + 18 domain skills inject knowledge into workers |
83
+ | **Autopilot** | `/ant:run` | Automated build-verify-advance loop with smart pause conditions |
84
+ | **Verification** | 6-Phase Gates | Build, types, lint, tests, security, diff gates before advancing |
85
+ | **Quality** | 4 Gate Agents | Security (Gatekeeper), quality (Auditor), coverage (Probe), performance (Measurer) |
86
+ | **Research** | Oracle + Scouts | Deep autonomous research before task decomposition |
87
+ | **State** | Pause/Resume | Full state serialization for context breaks |
105
88
 
106
- ## ๐Ÿ“– Commands
89
+ ## Commands
107
90
 
108
91
  <details>
109
- <summary><strong>๐Ÿ—๏ธ Core Lifecycle</strong></summary>
92
+ <summary><strong>Core Lifecycle</strong></summary>
110
93
 
111
94
  | Command | Description |
112
95
  |---------|-------------|
113
- | `/ant:lay-eggs` | ๐Ÿฅš Set up Aether in this repo (one-time) |
114
- | `/ant:init "goal"` | ๐ŸŒฑ Initialize colony with mission |
115
- | `/ant:plan` | ๐Ÿ“‹ Generate phased roadmap with domain research |
116
- | `/ant:build N` | ๐Ÿ”จ Execute phase N with worker waves |
117
- | `/ant:continue` | โžก๏ธ 6-phase verification, advance to next phase |
118
- | `/ant:run` | ๐Ÿœ Autopilot โ€” build, verify, advance automatically |
119
- | `/ant:patrol` | ๐Ÿ” Pre-seal audit โ€” verify work against plan |
120
- | `/ant:seal` | ๐Ÿบ Complete and archive colony |
121
- | `/ant:entomb` | โšฐ๏ธ Create chamber from completed colony |
122
- | `/ant:pause-colony` | ๐Ÿ’พ Save state for context break |
123
- | `/ant:resume-colony` | ๐Ÿšฆ Restore from pause |
96
+ | `/ant:lay-eggs` | Set up Aether in this repo (one-time) |
97
+ | `/ant:init "goal"` | Initialize colony with mission |
98
+ | `/ant:plan` | Generate phased roadmap with domain research |
99
+ | `/ant:build N` | Execute phase N with worker waves |
100
+ | `/ant:continue` | 6-phase verification, advance to next phase |
101
+ | `/ant:run` | Autopilot โ€” build, verify, advance automatically |
102
+ | `/ant:patrol` | Pre-seal audit โ€” verify work against plan |
103
+ | `/ant:seal` | Complete and archive colony |
104
+ | `/ant:entomb` | Create chamber from completed colony |
105
+ | `/ant:pause-colony` | Save state for context break |
106
+ | `/ant:resume-colony` | Restore from pause |
124
107
 
125
108
  </details>
126
109
 
127
110
  <details>
128
- <summary><strong>๐ŸŽฏ Pheromone Signals</strong></summary>
111
+ <summary><strong>Pheromone Signals</strong></summary>
129
112
 
130
113
  | Command | Description |
131
114
  |---------|-------------|
132
- | `/ant:focus "area"` | ๐ŸŽฏ FOCUS โ€” "Pay attention here" |
133
- | `/ant:redirect "pattern"` | ๐Ÿšซ REDIRECT โ€” "Don't do this" (hard constraint) |
134
- | `/ant:feedback "note"` | ๐Ÿ’ฌ FEEDBACK โ€” "Adjust based on this" |
135
- | `/ant:pheromones` | ๐Ÿ“Š View active signals |
136
- | `/ant:export-signals` | ๐Ÿ“ค Export signals to XML |
137
- | `/ant:import-signals` | ๐Ÿ“ฅ Import signals from XML |
115
+ | `/ant:focus "area"` | FOCUS โ€” "Pay attention here" |
116
+ | `/ant:redirect "pattern"` | REDIRECT โ€” "Don't do this" (hard constraint) |
117
+ | `/ant:feedback "note"` | FEEDBACK โ€” "Adjust based on this" |
118
+ | `/ant:pheromones` | View active signals |
119
+ | `/ant:export-signals` | Export signals to XML |
120
+ | `/ant:import-signals` | Import signals from XML |
138
121
 
139
122
  </details>
140
123
 
141
124
  <details>
142
- <summary><strong>๐Ÿ”ฌ Research & Analysis</strong></summary>
125
+ <summary><strong>Research & Analysis</strong></summary>
143
126
 
144
127
  | Command | Description |
145
128
  |---------|-------------|
146
- | `/ant:colonize` | ๐Ÿ“Š๐Ÿ—บ๏ธ 4 parallel scouts analyze your codebase |
147
- | `/ant:oracle "topic"` | ๐Ÿ”ฎ Deep research with autonomous loop |
148
- | `/ant:archaeology <path>` | ๐Ÿบ Excavate git history for any file |
149
- | `/ant:chaos <target>` | ๐ŸŽฒ Resilience testing, edge case probing |
150
- | `/ant:swarm "problem"` | ๐Ÿ”ฅ 4 parallel scouts for stubborn bugs |
151
- | `/ant:dream` | ๐Ÿ’ญ Philosophical codebase wanderer |
152
- | `/ant:interpret` | ๐Ÿ” Grounds dreams in reality |
153
- | `/ant:organize` | ๐Ÿงน Codebase hygiene report |
129
+ | `/ant:colonize` | 4 parallel scouts analyze your codebase |
130
+ | `/ant:oracle "topic"` | Deep research with autonomous loop |
131
+ | `/ant:archaeology <path>` | Excavate git history for any file |
132
+ | `/ant:chaos <target>` | Resilience testing, edge case probing |
133
+ | `/ant:swarm "problem"` | 4 parallel scouts for stubborn bugs |
134
+ | `/ant:dream` | Philosophical codebase wanderer |
135
+ | `/ant:interpret` | Grounds dreams in reality |
136
+ | `/ant:organize` | Codebase hygiene report |
154
137
 
155
138
  </details>
156
139
 
157
140
  <details>
158
- <summary><strong>๐Ÿ‘๏ธ Visibility & Status</strong></summary>
141
+ <summary><strong>Visibility & Status</strong></summary>
159
142
 
160
143
  | Command | Description |
161
144
  |---------|-------------|
162
- | `/ant:status` | ๐Ÿ“ˆ Colony overview with memory health |
163
- | `/ant:memory-details` | ๐Ÿง  Wisdom, pending promotions, recent failures |
164
- | `/ant:watch` | ๐Ÿ‘๏ธ Real-time swarm display |
165
- | `/ant:history` | ๐Ÿ“œ Recent activity log |
166
- | `/ant:flags` | ๐Ÿšฉ List blockers and issues |
167
- | `/ant:help` | ๐Ÿœ Full command reference |
145
+ | `/ant:status` | Colony overview with memory health |
146
+ | `/ant:memory-details` | Wisdom, pending promotions, recent failures |
147
+ | `/ant:watch` | Real-time swarm display |
148
+ | `/ant:history` | Recent activity log |
149
+ | `/ant:flags` | List blockers and issues |
150
+ | `/ant:help` | Full command reference |
168
151
 
169
152
  </details>
170
153
 
171
154
  <details>
172
- <summary><strong>๐Ÿ”ง Coordination & Maintenance</strong></summary>
155
+ <summary><strong>Coordination & Maintenance</strong></summary>
173
156
 
174
157
  | Command | Description |
175
158
  |---------|-------------|
176
- | `/ant:council` | ๐Ÿ“œ Clarify intent via multi-choice questions |
177
- | `/ant:flag "title"` | ๐Ÿšฉ Create project-specific flag |
178
- | `/ant:data-clean` | ๐Ÿงน Remove test artifacts from colony data |
179
- | `/ant:preferences` | โš™๏ธ Add or list user preferences |
180
- | `/ant:skill-create "topic"` | ๐Ÿœ Create custom domain skill |
181
- | `/ant:update` | ๐Ÿ”„ Update system files from hub |
159
+ | `/ant:council` | Clarify intent via multi-choice questions |
160
+ | `/ant:flag "title"` | Create project-specific flag |
161
+ | `/ant:data-clean` | Remove test artifacts from colony data |
162
+ | `/ant:preferences` | Add or list user preferences |
163
+ | `/ant:skill-create "topic"` | Create custom domain skill |
164
+ | `/ant:update` | Update system files from hub |
182
165
 
183
166
  </details>
184
167
 
185
- ## ๐Ÿœ The 24 Agents
168
+ ## The 24 Agents
186
169
 
187
170
  | Tier | Agent | Role |
188
171
  |------|-------|------|
189
- | ๐Ÿ‘‘ **Core** | Builder | ๐Ÿ”จ Writes code, TDD-first |
190
- | ๐Ÿ‘‘ **Core** | Watcher | ๐Ÿ‘๏ธ Tests, validates, quality gates |
191
- | ๐Ÿ‘‘ **Core** | Scout | ๐Ÿ” Researches, discovers |
192
- | ๐Ÿ›๏ธ **Orchestration** | Queen | ๐Ÿ‘‘ Orchestrates phases, spawns workers |
193
- | ๐Ÿ›๏ธ **Orchestration** | Route-Setter | ๐Ÿ“‹ Plans phases, breaks down goals |
194
- | ๐Ÿ›๏ธ **Orchestration** | Architect | ๐Ÿ—๏ธ Architecture design |
195
- | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-nest | ๐Ÿ“‚ Maps directory structure |
196
- | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-disciplines | ๐Ÿ“ Documents conventions |
197
- | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-pathogens | ๐Ÿฆ  Identifies tech debt |
198
- | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-provisions | ๐Ÿ“ฆ Maps dependencies |
199
- | โšก **Specialist** | Keeper | ๐Ÿ“š Preserves knowledge |
200
- | โšก **Specialist** | Tracker | ๐Ÿ› Investigates bugs |
201
- | โšก **Specialist** | Probe | ๐Ÿ”ฌ Coverage analysis |
202
- | โšก **Specialist** | Weaver | ๐Ÿงต Refactoring specialist |
203
- | โšก **Specialist** | Auditor | โœ… Quality gate |
204
- | ๐ŸŽฏ **Niche** | Chaos | ๐ŸŽฒ Resilience testing |
205
- | ๐ŸŽฏ **Niche** | Archaeologist | ๐Ÿบ Excavates git history |
206
- | ๐ŸŽฏ **Niche** | Gatekeeper | ๐Ÿ›ก๏ธ Security gate |
207
- | ๐ŸŽฏ **Niche** | Includer | โ™ฟ Accessibility audits |
208
- | ๐ŸŽฏ **Niche** | Measurer | โฑ๏ธ Performance analysis |
209
- | ๐ŸŽฏ **Niche** | Sage | ๐Ÿง™ Wisdom synthesis |
210
- | ๐ŸŽฏ **Niche** | Oracle | ๐Ÿ”ฎ Deep research |
211
- | ๐ŸŽฏ **Niche** | Ambassador | ๐ŸŒ External integrations |
212
- | ๐ŸŽฏ **Niche** | Chronicler | ๐Ÿ“ Documentation |
213
-
214
- ## ๐Ÿ—๏ธ Architecture
172
+ | **Core** | Builder | Writes code, TDD-first |
173
+ | **Core** | Watcher | Tests, validates, quality gates |
174
+ | **Core** | Scout | Researches, discovers |
175
+ | **Orchestration** | Queen | Orchestrates phases, spawns workers |
176
+ | **Orchestration** | Route-Setter | Plans phases, breaks down goals |
177
+ | **Orchestration** | Architect | Architecture design |
178
+ | **Surveyor** | surveyor-nest | Maps directory structure |
179
+ | **Surveyor** | surveyor-disciplines | Documents conventions |
180
+ | **Surveyor** | surveyor-pathogens | Identifies tech debt |
181
+ | **Surveyor** | surveyor-provisions | Maps dependencies |
182
+ | **Specialist** | Keeper | Preserves knowledge |
183
+ | **Specialist** | Tracker | Investigates bugs |
184
+ | **Specialist** | Probe | Coverage analysis |
185
+ | **Specialist** | Weaver | Refactoring specialist |
186
+ | **Specialist** | Auditor | Quality gate |
187
+ | **Niche** | Chaos | Resilience testing |
188
+ | **Niche** | Archaeologist | Excavates git history |
189
+ | **Niche** | Gatekeeper | Security gate |
190
+ | **Niche** | Includer | Accessibility audits |
191
+ | **Niche** | Measurer | Performance analysis |
192
+ | **Niche** | Sage | Wisdom synthesis |
193
+ | **Niche** | Oracle | Deep research |
194
+ | **Niche** | Ambassador | External integrations |
195
+ | **Niche** | Chronicler | Documentation |
196
+
197
+ ## Architecture
215
198
 
216
199
  ```
217
- .aether/ # ๐Ÿœ Colony files (repo-local)
218
- โ”œโ”€โ”€ aether-utils.sh # โšก Dispatcher (~5,500 lines, ~130+ subcommands)
219
- โ”œโ”€โ”€ utils/ # ๐Ÿ”ง 35 modular scripts
220
- โ”œโ”€โ”€ skills/ # ๐Ÿ“š 28 skills (10 colony + 18 domain)
221
- โ”œโ”€โ”€ commands/ # ๐Ÿ“– 45 YAML command sources
222
- โ”œโ”€โ”€ exchange/ # ๐Ÿ“ค XML exchange modules
223
- โ”œโ”€โ”€ docs/ # ๐Ÿ“ Documentation
224
- โ”œโ”€โ”€ templates/ # ๐Ÿ“‹ 12 templates
225
- โ””โ”€โ”€ data/ # ๐Ÿ’พ Colony state (local only)
226
-
227
- ~/.aether/ # ๐ŸŒ Hub (cross-colony, user-level)
228
- โ”œโ”€โ”€ QUEEN.md # ๐Ÿ‘‘ Wisdom + preferences
229
- โ”œโ”€โ”€ hive/wisdom.json # ๐Ÿง  Cross-colony wisdom (200 cap)
230
- โ””โ”€โ”€ registry.json # ๐Ÿ“Š All registered colonies
200
+ .aether/ Colony files (repo-local)
201
+ โ”œโ”€โ”€ aether-utils.sh Dispatcher (~5,500 lines, ~130+ subcommands)
202
+ โ”œโ”€โ”€ utils/ 35 modular scripts
203
+ โ”œโ”€โ”€ skills/ 28 skills (10 colony + 18 domain)
204
+ โ”œโ”€โ”€ commands/ 45 YAML command sources
205
+ โ”œโ”€โ”€ exchange/ XML exchange modules
206
+ โ”œโ”€โ”€ docs/ Documentation
207
+ โ”œโ”€โ”€ templates/ 12 templates
208
+ โ””โ”€โ”€ data/ Colony state (local only)
209
+
210
+ ~/.aether/ Hub (cross-colony, user-level)
211
+ โ”œโ”€โ”€ QUEEN.md Wisdom + preferences
212
+ โ”œโ”€โ”€ hive/wisdom.json Cross-colony wisdom (200 cap)
213
+ โ””โ”€โ”€ registry.json All registered colonies
231
214
  ```
232
215
 
233
- ## ๐Ÿ”Œ Works With
216
+ ## Works With
234
217
 
235
218
  - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** โ€” 45 slash commands + 24 agent definitions
236
219
  - **[OpenCode](https://github.com/opencode-ai/opencode)** โ€” 45 slash commands + agent definitions
237
220
 
238
- ## โค๏ธ Support Aether
221
+ ## Support
239
222
 
240
- If Aether has been useful to you, here's how you can keep the colony alive:
223
+ If Aether has been useful to you:
241
224
 
242
- **[Sponsor on GitHub](https://github.com/sponsors/calcosmic)** (preferred)
225
+ **[Sponsor on GitHub](https://github.com/sponsors/calcosmic)**
243
226
 
244
227
  <details>
245
- <summary>๐Ÿ’ก Crypto โ€” no middlemen, no fees</summary>
228
+ <summary>Crypto</summary>
246
229
 
247
230
  | Network | Address |
248
231
  |---------|---------|
249
- | **ETH** (MetaMask) | `0xE7F8C9BE190c207D49DF01b82747cf7B6Bd1c809` |
250
- | **SOL** (Phantom) | `6DVTdoZvvi9siUpgmRJZxk5Kqho8TZiN2ZzyVUVC9gX8` |
232
+ | **ETH** | `0xE7F8C9BE190c207D49DF01b82747cf7B6Bd1c809` |
233
+ | **SOL** | `6DVTdoZvvi9siUpgmRJZxk5Kqho8TZiN2ZzyVUVC9gX8` |
251
234
 
252
235
  </details>
253
236
 
254
237
  [PayPal](https://www.paypal.com/ncp/payment/RENG7ZMW5F59L) ยท [Buy Me a Coffee](https://buymeacoffee.com/music5y)
255
238
 
256
- *Your support funds servers, new features, docs, and keeps Aether free & open source (MIT).*
257
-
258
- ## ๐Ÿ“„ License
239
+ ## License
259
240
 
260
241
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aether-colony",
3
- "version": "5.3.0",
3
+ "version": "5.3.2",
4
4
  "description": "Multi-agent system using ant colony intelligence for Claude Code and OpenCode โ€” workers self-organize via pheromone signals",
5
5
  "bin": {
6
6
  "aether": "bin/cli.js",