aether-colony 5.3.0 โ†’ 5.3.1

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,59 +1,54 @@
1
1
  <div align="center">
2
2
 
3
- # ๐Ÿœ Aether Colony
3
+ <br>
4
4
 
5
- **Multi-agent AI development for Claude Code and OpenCode**
5
+ <picture>
6
+ <source media="(prefers-color-scheme: dark)" srcset="./AetherLogo.png" />
7
+ <source media="(prefers-color-scheme: light)" srcset="./AetherLogo.png" />
8
+ <img src="./AetherLogo.png" alt="Aether" width="240" />
9
+ </picture>
6
10
 
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)
11
+ <br>
12
12
 
13
- Spawn a colony of 24 AI specialists that self-organize around your goal using pheromone signals.
14
- 1,000+ weekly installs.
13
+ # Aether
15
14
 
16
- *Artificial Ecology For Thought and Emergent Reasoning*
15
+ ### Artificial Ecology for Thought and Emergent Reasoning
17
16
 
18
- *The whole is greater than the sum of its ants.*
17
+ <br>
19
18
 
20
- ```bash
21
- npx aether-colony
22
- ```
19
+ [![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)
20
+ [![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)
21
+ [![license](https://img.shields.io/github/license/calcosmic/Aether?style=for-the-badge&color=333333)](LICENSE)
22
+ [![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)
23
+ [![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)
23
24
 
24
- </div>
25
+ <br>
25
26
 
26
- <p align="center">
27
- <img src="./AetherAnts.png" alt="Aether Colony" width="640" />
28
- </p>
27
+ Multi-agent AI development for **Claude Code** and **OpenCode**.
28
+ <br>
29
+ Spawn 24 specialists that self-organize around your goal using pheromone signals.
30
+
31
+ <br>
29
32
 
30
33
  ```
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
- โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
34
+ $ npx aether-colony
50
35
  ```
51
36
 
52
- ## ๐Ÿœ The Problem
37
+ <br>
38
+
39
+ *The whole is greater than the sum of its ants.*
40
+
41
+ <br>
42
+
43
+ </div>
44
+
45
+ ---
46
+
47
+ ## The Problem
53
48
 
54
49
  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.
55
50
 
56
- ## ๐Ÿœ The Solution
51
+ ## The Solution
57
52
 
58
53
  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.
59
54
 
@@ -62,14 +57,14 @@ Workers spawn workers dynamically (max depth 3, max 10 per phase). When a Builde
62
57
  You steer the colony with **pheromone signals**, not micromanagement:
63
58
 
64
59
  ```
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"
60
+ /ant:focus "security" # "Pay attention here"
61
+ /ant:redirect "no jQuery" # "Don't do this" (hard constraint)
62
+ /ant:feedback "prefer composition" # "Adjust based on this"
68
63
  ```
69
64
 
70
- The colony **remembers**. Wisdom, learnings, and instincts persist across sessions. The ๐Ÿง  Hive Brain shares knowledge across colonies on your machine.
65
+ The colony **remembers**. Wisdom, learnings, and instincts persist across sessions. The Hive Brain shares knowledge across colonies on your machine.
71
66
 
72
- ## ๐Ÿš€ Quick Start
67
+ ## Quick Start
73
68
 
74
69
  ```bash
75
70
  # Interactive setup (recommended)
@@ -77,184 +72,186 @@ npx aether-colony
77
72
 
78
73
  # Or install globally
79
74
  npm install -g aether-colony
75
+ ```
76
+
77
+ Then in your project:
80
78
 
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
79
+ ```
80
+ /ant:lay-eggs # Set up Aether (one-time)
81
+ /ant:init "Build X" # Start a colony with a goal
82
+ /ant:plan # Generate phased roadmap
83
+ /ant:run # Autopilot: build, verify, advance all phases
84
+ /ant:seal # Done โ€” archive the colony
87
85
  ```
88
86
 
89
- That's it. Five commands from zero to shipped.
87
+ Five commands from zero to shipped.
90
88
 
91
- ## โœจ Key Features
89
+ ## Key Features
92
90
 
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
91
+ | | Feature | Description |
92
+ |---|---------|-------------|
93
+ | **Agents** | 24 Specialized Workers | Builders, Watchers, Scouts, Trackers, Archaeologists, Oracle, and more |
94
+ | **Commands** | 45 Slash Commands | Full lifecycle management across Claude Code and OpenCode |
95
+ | **Signals** | Pheromone System | Guide the colony with FOCUS, REDIRECT, and FEEDBACK signals |
96
+ | **Memory** | Colony Wisdom | Learnings and instincts persist across sessions via QUEEN.md |
97
+ | **Sharing** | Hive Brain | Cross-colony wisdom sharing with domain-scoped retrieval |
98
+ | **Skills** | 28 Skills | 10 colony + 18 domain skills inject knowledge into workers |
99
+ | **Autopilot** | `/ant:run` | Automated build-verify-advance loop with smart pause conditions |
100
+ | **Verification** | 6-Phase Gates | Build, types, lint, tests, security, diff gates before advancing |
101
+ | **Quality** | 4 Gate Agents | Security (Gatekeeper), quality (Auditor), coverage (Probe), performance (Measurer) |
102
+ | **Research** | Oracle + Scouts | Deep autonomous research before task decomposition |
103
+ | **State** | Pause/Resume | Full state serialization for context breaks |
105
104
 
106
- ## ๐Ÿ“– Commands
105
+ ## Commands
107
106
 
108
107
  <details>
109
- <summary><strong>๐Ÿ—๏ธ Core Lifecycle</strong></summary>
108
+ <summary><strong>Core Lifecycle</strong></summary>
110
109
 
111
110
  | Command | Description |
112
111
  |---------|-------------|
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 |
112
+ | `/ant:lay-eggs` | Set up Aether in this repo (one-time) |
113
+ | `/ant:init "goal"` | Initialize colony with mission |
114
+ | `/ant:plan` | Generate phased roadmap with domain research |
115
+ | `/ant:build N` | Execute phase N with worker waves |
116
+ | `/ant:continue` | 6-phase verification, advance to next phase |
117
+ | `/ant:run` | Autopilot โ€” build, verify, advance automatically |
118
+ | `/ant:patrol` | Pre-seal audit โ€” verify work against plan |
119
+ | `/ant:seal` | Complete and archive colony |
120
+ | `/ant:entomb` | Create chamber from completed colony |
121
+ | `/ant:pause-colony` | Save state for context break |
122
+ | `/ant:resume-colony` | Restore from pause |
124
123
 
125
124
  </details>
126
125
 
127
126
  <details>
128
- <summary><strong>๐ŸŽฏ Pheromone Signals</strong></summary>
127
+ <summary><strong>Pheromone Signals</strong></summary>
129
128
 
130
129
  | Command | Description |
131
130
  |---------|-------------|
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 |
131
+ | `/ant:focus "area"` | FOCUS โ€” "Pay attention here" |
132
+ | `/ant:redirect "pattern"` | REDIRECT โ€” "Don't do this" (hard constraint) |
133
+ | `/ant:feedback "note"` | FEEDBACK โ€” "Adjust based on this" |
134
+ | `/ant:pheromones` | View active signals |
135
+ | `/ant:export-signals` | Export signals to XML |
136
+ | `/ant:import-signals` | Import signals from XML |
138
137
 
139
138
  </details>
140
139
 
141
140
  <details>
142
- <summary><strong>๐Ÿ”ฌ Research & Analysis</strong></summary>
141
+ <summary><strong>Research & Analysis</strong></summary>
143
142
 
144
143
  | Command | Description |
145
144
  |---------|-------------|
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 |
145
+ | `/ant:colonize` | 4 parallel scouts analyze your codebase |
146
+ | `/ant:oracle "topic"` | Deep research with autonomous loop |
147
+ | `/ant:archaeology <path>` | Excavate git history for any file |
148
+ | `/ant:chaos <target>` | Resilience testing, edge case probing |
149
+ | `/ant:swarm "problem"` | 4 parallel scouts for stubborn bugs |
150
+ | `/ant:dream` | Philosophical codebase wanderer |
151
+ | `/ant:interpret` | Grounds dreams in reality |
152
+ | `/ant:organize` | Codebase hygiene report |
154
153
 
155
154
  </details>
156
155
 
157
156
  <details>
158
- <summary><strong>๐Ÿ‘๏ธ Visibility & Status</strong></summary>
157
+ <summary><strong>Visibility & Status</strong></summary>
159
158
 
160
159
  | Command | Description |
161
160
  |---------|-------------|
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 |
161
+ | `/ant:status` | Colony overview with memory health |
162
+ | `/ant:memory-details` | Wisdom, pending promotions, recent failures |
163
+ | `/ant:watch` | Real-time swarm display |
164
+ | `/ant:history` | Recent activity log |
165
+ | `/ant:flags` | List blockers and issues |
166
+ | `/ant:help` | Full command reference |
168
167
 
169
168
  </details>
170
169
 
171
170
  <details>
172
- <summary><strong>๐Ÿ”ง Coordination & Maintenance</strong></summary>
171
+ <summary><strong>Coordination & Maintenance</strong></summary>
173
172
 
174
173
  | Command | Description |
175
174
  |---------|-------------|
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 |
175
+ | `/ant:council` | Clarify intent via multi-choice questions |
176
+ | `/ant:flag "title"` | Create project-specific flag |
177
+ | `/ant:data-clean` | Remove test artifacts from colony data |
178
+ | `/ant:preferences` | Add or list user preferences |
179
+ | `/ant:skill-create "topic"` | Create custom domain skill |
180
+ | `/ant:update` | Update system files from hub |
182
181
 
183
182
  </details>
184
183
 
185
- ## ๐Ÿœ The 24 Agents
184
+ ## The 24 Agents
186
185
 
187
186
  | Tier | Agent | Role |
188
187
  |------|-------|------|
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
188
+ | **Core** | Builder | Writes code, TDD-first |
189
+ | **Core** | Watcher | Tests, validates, quality gates |
190
+ | **Core** | Scout | Researches, discovers |
191
+ | **Orchestration** | Queen | Orchestrates phases, spawns workers |
192
+ | **Orchestration** | Route-Setter | Plans phases, breaks down goals |
193
+ | **Orchestration** | Architect | Architecture design |
194
+ | **Surveyor** | surveyor-nest | Maps directory structure |
195
+ | **Surveyor** | surveyor-disciplines | Documents conventions |
196
+ | **Surveyor** | surveyor-pathogens | Identifies tech debt |
197
+ | **Surveyor** | surveyor-provisions | Maps dependencies |
198
+ | **Specialist** | Keeper | Preserves knowledge |
199
+ | **Specialist** | Tracker | Investigates bugs |
200
+ | **Specialist** | Probe | Coverage analysis |
201
+ | **Specialist** | Weaver | Refactoring specialist |
202
+ | **Specialist** | Auditor | Quality gate |
203
+ | **Niche** | Chaos | Resilience testing |
204
+ | **Niche** | Archaeologist | Excavates git history |
205
+ | **Niche** | Gatekeeper | Security gate |
206
+ | **Niche** | Includer | Accessibility audits |
207
+ | **Niche** | Measurer | Performance analysis |
208
+ | **Niche** | Sage | Wisdom synthesis |
209
+ | **Niche** | Oracle | Deep research |
210
+ | **Niche** | Ambassador | External integrations |
211
+ | **Niche** | Chronicler | Documentation |
212
+
213
+ ## Architecture
215
214
 
216
215
  ```
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
216
+ .aether/ Colony files (repo-local)
217
+ โ”œโ”€โ”€ aether-utils.sh Dispatcher (~5,500 lines, ~130+ subcommands)
218
+ โ”œโ”€โ”€ utils/ 35 modular scripts
219
+ โ”œโ”€โ”€ skills/ 28 skills (10 colony + 18 domain)
220
+ โ”œโ”€โ”€ commands/ 45 YAML command sources
221
+ โ”œโ”€โ”€ exchange/ XML exchange modules
222
+ โ”œโ”€โ”€ docs/ Documentation
223
+ โ”œโ”€โ”€ templates/ 12 templates
224
+ โ””โ”€โ”€ data/ Colony state (local only)
225
+
226
+ ~/.aether/ Hub (cross-colony, user-level)
227
+ โ”œโ”€โ”€ QUEEN.md Wisdom + preferences
228
+ โ”œโ”€โ”€ hive/wisdom.json Cross-colony wisdom (200 cap)
229
+ โ””โ”€โ”€ registry.json All registered colonies
231
230
  ```
232
231
 
233
- ## ๐Ÿ”Œ Works With
232
+ ## Works With
234
233
 
235
234
  - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** โ€” 45 slash commands + 24 agent definitions
236
235
  - **[OpenCode](https://github.com/opencode-ai/opencode)** โ€” 45 slash commands + agent definitions
237
236
 
238
- ## โค๏ธ Support Aether
237
+ ## Support
239
238
 
240
- If Aether has been useful to you, here's how you can keep the colony alive:
239
+ If Aether has been useful to you:
241
240
 
242
- **[Sponsor on GitHub](https://github.com/sponsors/calcosmic)** (preferred)
241
+ **[Sponsor on GitHub](https://github.com/sponsors/calcosmic)**
243
242
 
244
243
  <details>
245
- <summary>๐Ÿ’ก Crypto โ€” no middlemen, no fees</summary>
244
+ <summary>Crypto</summary>
246
245
 
247
246
  | Network | Address |
248
247
  |---------|---------|
249
- | **ETH** (MetaMask) | `0xE7F8C9BE190c207D49DF01b82747cf7B6Bd1c809` |
250
- | **SOL** (Phantom) | `6DVTdoZvvi9siUpgmRJZxk5Kqho8TZiN2ZzyVUVC9gX8` |
248
+ | **ETH** | `0xE7F8C9BE190c207D49DF01b82747cf7B6Bd1c809` |
249
+ | **SOL** | `6DVTdoZvvi9siUpgmRJZxk5Kqho8TZiN2ZzyVUVC9gX8` |
251
250
 
252
251
  </details>
253
252
 
254
253
  [PayPal](https://www.paypal.com/ncp/payment/RENG7ZMW5F59L) ยท [Buy Me a Coffee](https://buymeacoffee.com/music5y)
255
254
 
256
- *Your support funds servers, new features, docs, and keeps Aether free & open source (MIT).*
257
-
258
- ## ๐Ÿ“„ License
255
+ ## License
259
256
 
260
257
  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.1",
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",