aether-colony 5.0.0 โ†’ 5.2.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.
Files changed (317) hide show
  1. package/.aether/aether-utils.sh +3226 -3345
  2. package/.aether/agents-claude/aether-ambassador.md +265 -0
  3. package/.aether/agents-claude/aether-archaeologist.md +327 -0
  4. package/.aether/agents-claude/aether-architect.md +236 -0
  5. package/.aether/agents-claude/aether-auditor.md +271 -0
  6. package/.aether/agents-claude/aether-builder.md +224 -0
  7. package/.aether/agents-claude/aether-chaos.md +269 -0
  8. package/.aether/agents-claude/aether-chronicler.md +305 -0
  9. package/.aether/agents-claude/aether-gatekeeper.md +330 -0
  10. package/.aether/agents-claude/aether-includer.md +374 -0
  11. package/.aether/agents-claude/aether-keeper.md +272 -0
  12. package/.aether/agents-claude/aether-measurer.md +322 -0
  13. package/.aether/agents-claude/aether-oracle.md +237 -0
  14. package/.aether/agents-claude/aether-probe.md +211 -0
  15. package/.aether/agents-claude/aether-queen.md +330 -0
  16. package/.aether/agents-claude/aether-route-setter.md +178 -0
  17. package/.aether/agents-claude/aether-sage.md +418 -0
  18. package/.aether/agents-claude/aether-scout.md +179 -0
  19. package/.aether/agents-claude/aether-surveyor-disciplines.md +417 -0
  20. package/.aether/agents-claude/aether-surveyor-nest.md +355 -0
  21. package/.aether/agents-claude/aether-surveyor-pathogens.md +289 -0
  22. package/.aether/agents-claude/aether-surveyor-provisions.md +360 -0
  23. package/.aether/agents-claude/aether-tracker.md +270 -0
  24. package/.aether/agents-claude/aether-watcher.md +280 -0
  25. package/.aether/agents-claude/aether-weaver.md +248 -0
  26. package/.aether/commands/archaeology.yaml +653 -0
  27. package/.aether/commands/build.yaml +1221 -0
  28. package/.aether/commands/chaos.yaml +653 -0
  29. package/.aether/commands/colonize.yaml +442 -0
  30. package/.aether/commands/continue.yaml +1484 -0
  31. package/.aether/commands/council.yaml +509 -0
  32. package/.aether/commands/data-clean.yaml +80 -0
  33. package/.aether/commands/dream.yaml +275 -0
  34. package/.aether/commands/entomb.yaml +863 -0
  35. package/.aether/commands/export-signals.yaml +64 -0
  36. package/.aether/commands/feedback.yaml +158 -0
  37. package/.aether/commands/flag.yaml +160 -0
  38. package/.aether/commands/flags.yaml +177 -0
  39. package/.aether/commands/focus.yaml +112 -0
  40. package/.aether/commands/help.yaml +167 -0
  41. package/.aether/commands/history.yaml +137 -0
  42. package/.aether/commands/import-signals.yaml +79 -0
  43. package/.aether/commands/init.yaml +502 -0
  44. package/.aether/commands/insert-phase.yaml +102 -0
  45. package/.aether/commands/interpret.yaml +285 -0
  46. package/.aether/commands/lay-eggs.yaml +224 -0
  47. package/.aether/commands/maturity.yaml +122 -0
  48. package/.aether/commands/memory-details.yaml +74 -0
  49. package/.aether/commands/migrate-state.yaml +174 -0
  50. package/.aether/commands/oracle.yaml +1224 -0
  51. package/.aether/commands/organize.yaml +446 -0
  52. package/.aether/commands/patrol.yaml +621 -0
  53. package/.aether/commands/pause-colony.yaml +424 -0
  54. package/.aether/commands/phase.yaml +124 -0
  55. package/.aether/commands/pheromones.yaml +153 -0
  56. package/.aether/commands/plan.yaml +1364 -0
  57. package/.aether/commands/preferences.yaml +63 -0
  58. package/.aether/commands/quick.yaml +104 -0
  59. package/.aether/commands/redirect.yaml +123 -0
  60. package/.aether/commands/resume-colony.yaml +375 -0
  61. package/.aether/commands/resume.yaml +407 -0
  62. package/.aether/commands/run.yaml +229 -0
  63. package/.aether/commands/seal.yaml +1214 -0
  64. package/.aether/commands/skill-create.yaml +337 -0
  65. package/.aether/commands/status.yaml +408 -0
  66. package/.aether/commands/swarm.yaml +352 -0
  67. package/.aether/commands/tunnels.yaml +814 -0
  68. package/.aether/commands/update.yaml +131 -0
  69. package/.aether/commands/verify-castes.yaml +159 -0
  70. package/.aether/commands/watch.yaml +454 -0
  71. package/.aether/docs/INCIDENT_TEMPLATE.md +32 -0
  72. package/.aether/docs/QUEEN-SYSTEM.md +11 -11
  73. package/.aether/docs/README.md +32 -2
  74. package/.aether/docs/command-playbooks/README.md +23 -0
  75. package/.aether/docs/command-playbooks/build-complete.md +349 -0
  76. package/.aether/docs/command-playbooks/build-context.md +282 -0
  77. package/.aether/docs/command-playbooks/build-full.md +1683 -0
  78. package/.aether/docs/command-playbooks/build-prep.md +284 -0
  79. package/.aether/docs/command-playbooks/build-verify.md +405 -0
  80. package/.aether/docs/command-playbooks/build-wave.md +749 -0
  81. package/.aether/docs/command-playbooks/continue-advance.md +524 -0
  82. package/.aether/docs/command-playbooks/continue-finalize.md +447 -0
  83. package/.aether/docs/command-playbooks/continue-full.md +1725 -0
  84. package/.aether/docs/command-playbooks/continue-gates.md +686 -0
  85. package/.aether/docs/command-playbooks/continue-verify.md +407 -0
  86. package/.aether/docs/context-continuity.md +84 -0
  87. package/.aether/docs/disciplines/DISCIPLINES.md +9 -7
  88. package/.aether/docs/error-codes.md +1 -1
  89. package/.aether/docs/known-issues.md +34 -173
  90. package/.aether/docs/pheromones.md +86 -6
  91. package/.aether/docs/plans/pheromone-display-plan.md +257 -0
  92. package/.aether/docs/queen-commands.md +10 -9
  93. package/.aether/docs/source-of-truth-map.md +132 -0
  94. package/.aether/docs/xml-utilities.md +47 -0
  95. package/.aether/rules/aether-colony.md +23 -13
  96. package/.aether/scripts/incident-test-add.sh +47 -0
  97. package/.aether/scripts/weekly-audit.sh +79 -0
  98. package/.aether/skills/.index.json +649 -0
  99. package/.aether/skills/colony/.manifest.json +16 -0
  100. package/.aether/skills/colony/build-discipline/SKILL.md +78 -0
  101. package/.aether/skills/colony/colony-interaction/SKILL.md +56 -0
  102. package/.aether/skills/colony/colony-lifecycle/SKILL.md +77 -0
  103. package/.aether/skills/colony/colony-visuals/SKILL.md +112 -0
  104. package/.aether/skills/colony/context-management/SKILL.md +80 -0
  105. package/.aether/skills/colony/error-presentation/SKILL.md +99 -0
  106. package/.aether/skills/colony/pheromone-protocol/SKILL.md +79 -0
  107. package/.aether/skills/colony/pheromone-visibility/SKILL.md +81 -0
  108. package/.aether/skills/colony/state-safety/SKILL.md +84 -0
  109. package/.aether/skills/colony/worker-priming/SKILL.md +82 -0
  110. package/.aether/skills/domain/.manifest.json +24 -0
  111. package/.aether/skills/domain/README.md +33 -0
  112. package/.aether/skills/domain/django/SKILL.md +49 -0
  113. package/.aether/skills/domain/docker/SKILL.md +52 -0
  114. package/.aether/skills/domain/golang/SKILL.md +52 -0
  115. package/.aether/skills/domain/graphql/SKILL.md +51 -0
  116. package/.aether/skills/domain/html-css/SKILL.md +48 -0
  117. package/.aether/skills/domain/nextjs/SKILL.md +45 -0
  118. package/.aether/skills/domain/nodejs/SKILL.md +53 -0
  119. package/.aether/skills/domain/postgresql/SKILL.md +53 -0
  120. package/.aether/skills/domain/prisma/SKILL.md +59 -0
  121. package/.aether/skills/domain/python/SKILL.md +50 -0
  122. package/.aether/skills/domain/rails/SKILL.md +52 -0
  123. package/.aether/skills/domain/react/SKILL.md +45 -0
  124. package/.aether/skills/domain/rest-api/SKILL.md +58 -0
  125. package/.aether/skills/domain/svelte/SKILL.md +47 -0
  126. package/.aether/skills/domain/tailwind/SKILL.md +45 -0
  127. package/.aether/skills/domain/testing/SKILL.md +53 -0
  128. package/.aether/skills/domain/typescript/SKILL.md +58 -0
  129. package/.aether/skills/domain/vue/SKILL.md +49 -0
  130. package/.aether/templates/QUEEN.md.template +23 -41
  131. package/.aether/templates/colony-state-reset.jq.template +1 -0
  132. package/.aether/templates/colony-state.template.json +4 -0
  133. package/.aether/templates/learning-observations.template.json +6 -0
  134. package/.aether/templates/midden.template.json +13 -0
  135. package/.aether/templates/pheromones.template.json +6 -0
  136. package/.aether/templates/session.template.json +9 -0
  137. package/.aether/utils/atomic-write.sh +63 -17
  138. package/.aether/utils/chamber-utils.sh +145 -2
  139. package/.aether/utils/council.sh +425 -0
  140. package/.aether/utils/emoji-audit.sh +166 -0
  141. package/.aether/utils/error-handler.sh +21 -7
  142. package/.aether/utils/file-lock.sh +182 -27
  143. package/.aether/utils/flag.sh +278 -0
  144. package/.aether/utils/hive.sh +572 -0
  145. package/.aether/utils/immune.sh +508 -0
  146. package/.aether/utils/learning.sh +1928 -0
  147. package/.aether/utils/midden.sh +520 -0
  148. package/.aether/utils/oracle/oracle.md +168 -0
  149. package/.aether/utils/oracle/oracle.sh +1023 -0
  150. package/.aether/utils/pheromone.sh +2029 -0
  151. package/.aether/utils/queen.sh +1710 -0
  152. package/.aether/utils/scan.sh +860 -0
  153. package/.aether/utils/semantic-cli.sh +10 -8
  154. package/.aether/utils/session.sh +816 -0
  155. package/.aether/utils/skills.sh +509 -0
  156. package/.aether/utils/spawn-tree.sh +103 -271
  157. package/.aether/utils/spawn.sh +260 -0
  158. package/.aether/utils/state-api.sh +389 -0
  159. package/.aether/utils/state-loader.sh +8 -6
  160. package/.aether/utils/suggest.sh +611 -0
  161. package/.aether/utils/swarm-display.sh +10 -1
  162. package/.aether/utils/swarm.sh +1004 -0
  163. package/.aether/utils/watch-spawn-tree.sh +11 -2
  164. package/.aether/utils/xml-compose.sh +2 -2
  165. package/.aether/utils/xml-convert.sh +9 -5
  166. package/.aether/utils/xml-core.sh +5 -9
  167. package/.aether/utils/xml-query.sh +4 -4
  168. package/.aether/workers.md +86 -67
  169. package/.claude/agents/ant/aether-ambassador.md +2 -1
  170. package/.claude/agents/ant/aether-archaeologist.md +6 -1
  171. package/.claude/agents/ant/aether-architect.md +236 -0
  172. package/.claude/agents/ant/aether-auditor.md +6 -1
  173. package/.claude/agents/ant/aether-builder.md +38 -1
  174. package/.claude/agents/ant/aether-chaos.md +2 -1
  175. package/.claude/agents/ant/aether-chronicler.md +1 -0
  176. package/.claude/agents/ant/aether-gatekeeper.md +6 -1
  177. package/.claude/agents/ant/aether-includer.md +1 -0
  178. package/.claude/agents/ant/aether-keeper.md +1 -0
  179. package/.claude/agents/ant/aether-measurer.md +6 -1
  180. package/.claude/agents/ant/aether-oracle.md +237 -0
  181. package/.claude/agents/ant/aether-probe.md +2 -1
  182. package/.claude/agents/ant/aether-queen.md +6 -1
  183. package/.claude/agents/ant/aether-route-setter.md +6 -1
  184. package/.claude/agents/ant/aether-sage.md +68 -3
  185. package/.claude/agents/ant/aether-scout.md +38 -1
  186. package/.claude/agents/ant/aether-surveyor-disciplines.md +2 -1
  187. package/.claude/agents/ant/aether-surveyor-nest.md +2 -1
  188. package/.claude/agents/ant/aether-surveyor-pathogens.md +2 -1
  189. package/.claude/agents/ant/aether-surveyor-provisions.md +2 -1
  190. package/.claude/agents/ant/aether-tracker.md +6 -1
  191. package/.claude/agents/ant/aether-watcher.md +37 -1
  192. package/.claude/agents/ant/aether-weaver.md +2 -1
  193. package/.claude/commands/ant/archaeology.md +1 -8
  194. package/.claude/commands/ant/build.md +43 -1159
  195. package/.claude/commands/ant/chaos.md +1 -14
  196. package/.claude/commands/ant/colonize.md +3 -14
  197. package/.claude/commands/ant/continue.md +40 -1026
  198. package/.claude/commands/ant/council.md +213 -15
  199. package/.claude/commands/ant/data-clean.md +81 -0
  200. package/.claude/commands/ant/dream.md +12 -9
  201. package/.claude/commands/ant/entomb.md +62 -87
  202. package/.claude/commands/ant/export-signals.md +57 -0
  203. package/.claude/commands/ant/feedback.md +18 -0
  204. package/.claude/commands/ant/flag.md +12 -0
  205. package/.claude/commands/ant/flags.md +22 -8
  206. package/.claude/commands/ant/focus.md +18 -0
  207. package/.claude/commands/ant/help.md +40 -8
  208. package/.claude/commands/ant/history.md +3 -0
  209. package/.claude/commands/ant/import-signals.md +71 -0
  210. package/.claude/commands/ant/init.md +349 -191
  211. package/.claude/commands/ant/insert-phase.md +105 -0
  212. package/.claude/commands/ant/interpret.md +11 -0
  213. package/.claude/commands/ant/lay-eggs.md +167 -158
  214. package/.claude/commands/ant/maturity.md +22 -11
  215. package/.claude/commands/ant/memory-details.md +77 -0
  216. package/.claude/commands/ant/migrate-state.md +6 -0
  217. package/.claude/commands/ant/oracle.md +317 -62
  218. package/.claude/commands/ant/organize.md +10 -5
  219. package/.claude/commands/ant/patrol.md +620 -0
  220. package/.claude/commands/ant/pause-colony.md +8 -22
  221. package/.claude/commands/ant/phase.md +26 -37
  222. package/.claude/commands/ant/pheromones.md +156 -0
  223. package/.claude/commands/ant/plan.md +199 -50
  224. package/.claude/commands/ant/preferences.md +65 -0
  225. package/.claude/commands/ant/quick.md +100 -0
  226. package/.claude/commands/ant/redirect.md +18 -0
  227. package/.claude/commands/ant/resume-colony.md +37 -22
  228. package/.claude/commands/ant/resume.md +60 -7
  229. package/.claude/commands/ant/run.md +231 -0
  230. package/.claude/commands/ant/seal.md +506 -78
  231. package/.claude/commands/ant/skill-create.md +286 -0
  232. package/.claude/commands/ant/status.md +171 -1
  233. package/.claude/commands/ant/swarm.md +11 -23
  234. package/.claude/commands/ant/tunnels.md +1 -0
  235. package/.claude/commands/ant/update.md +58 -135
  236. package/.claude/commands/ant/verify-castes.md +90 -42
  237. package/.claude/commands/ant/watch.md +1 -0
  238. package/.opencode/agents/aether-ambassador.md +1 -1
  239. package/.opencode/agents/aether-architect.md +133 -0
  240. package/.opencode/agents/aether-builder.md +3 -3
  241. package/.opencode/agents/aether-oracle.md +137 -0
  242. package/.opencode/agents/aether-queen.md +1 -1
  243. package/.opencode/agents/aether-route-setter.md +1 -1
  244. package/.opencode/agents/aether-scout.md +1 -1
  245. package/.opencode/agents/aether-surveyor-disciplines.md +6 -1
  246. package/.opencode/agents/aether-surveyor-nest.md +6 -1
  247. package/.opencode/agents/aether-surveyor-pathogens.md +6 -1
  248. package/.opencode/agents/aether-surveyor-provisions.md +6 -1
  249. package/.opencode/agents/aether-tracker.md +1 -1
  250. package/.opencode/agents/aether-watcher.md +1 -1
  251. package/.opencode/agents/aether-weaver.md +1 -1
  252. package/.opencode/commands/ant/archaeology.md +7 -14
  253. package/.opencode/commands/ant/build.md +54 -88
  254. package/.opencode/commands/ant/chaos.md +7 -24
  255. package/.opencode/commands/ant/colonize.md +10 -17
  256. package/.opencode/commands/ant/continue.md +595 -66
  257. package/.opencode/commands/ant/council.md +150 -18
  258. package/.opencode/commands/ant/data-clean.md +77 -0
  259. package/.opencode/commands/ant/dream.md +15 -17
  260. package/.opencode/commands/ant/entomb.md +28 -18
  261. package/.opencode/commands/ant/export-signals.md +54 -0
  262. package/.opencode/commands/ant/feedback.md +24 -5
  263. package/.opencode/commands/ant/flag.md +16 -4
  264. package/.opencode/commands/ant/flags.md +24 -10
  265. package/.opencode/commands/ant/focus.md +22 -5
  266. package/.opencode/commands/ant/help.md +41 -8
  267. package/.opencode/commands/ant/history.md +9 -0
  268. package/.opencode/commands/ant/import-signals.md +68 -0
  269. package/.opencode/commands/ant/init.md +396 -154
  270. package/.opencode/commands/ant/insert-phase.md +111 -0
  271. package/.opencode/commands/ant/interpret.md +16 -0
  272. package/.opencode/commands/ant/lay-eggs.md +184 -112
  273. package/.opencode/commands/ant/maturity.md +18 -2
  274. package/.opencode/commands/ant/memory-details.md +83 -0
  275. package/.opencode/commands/ant/migrate-state.md +12 -0
  276. package/.opencode/commands/ant/oracle.md +322 -67
  277. package/.opencode/commands/ant/organize.md +14 -12
  278. package/.opencode/commands/ant/patrol.md +626 -0
  279. package/.opencode/commands/ant/pause-colony.md +12 -29
  280. package/.opencode/commands/ant/phase.md +30 -40
  281. package/.opencode/commands/ant/pheromones.md +162 -0
  282. package/.opencode/commands/ant/plan.md +210 -57
  283. package/.opencode/commands/ant/preferences.md +71 -0
  284. package/.opencode/commands/ant/quick.md +91 -0
  285. package/.opencode/commands/ant/redirect.md +22 -5
  286. package/.opencode/commands/ant/resume-colony.md +41 -29
  287. package/.opencode/commands/ant/resume.md +80 -20
  288. package/.opencode/commands/ant/run.md +237 -0
  289. package/.opencode/commands/ant/seal.md +230 -25
  290. package/.opencode/commands/ant/skill-create.md +63 -0
  291. package/.opencode/commands/ant/status.md +125 -30
  292. package/.opencode/commands/ant/swarm.md +3 -345
  293. package/.opencode/commands/ant/tunnels.md +3 -9
  294. package/.opencode/commands/ant/update.md +63 -127
  295. package/.opencode/commands/ant/verify-castes.md +96 -42
  296. package/.opencode/commands/ant/watch.md +7 -0
  297. package/CHANGELOG.md +368 -1
  298. package/README.md +195 -324
  299. package/bin/cli.js +236 -429
  300. package/bin/generate-commands.js +186 -0
  301. package/bin/generate-commands.sh +128 -89
  302. package/bin/lib/spawn-logger.js +0 -15
  303. package/bin/lib/update-transaction.js +285 -35
  304. package/bin/npx-install.js +178 -0
  305. package/bin/validate-package.sh +85 -3
  306. package/package.json +16 -4
  307. package/.aether/CONTEXT.md +0 -160
  308. package/.aether/docs/QUEEN.md +0 -84
  309. package/.aether/exchange/colony-registry.xml +0 -11
  310. package/.aether/exchange/pheromones.xml +0 -87
  311. package/.aether/exchange/queen-wisdom.xml +0 -14
  312. package/.aether/model-profiles.yaml +0 -100
  313. package/.aether/utils/spawn-with-model.sh +0 -56
  314. package/bin/lib/model-profiles.js +0 -445
  315. package/bin/lib/model-verify.js +0 -288
  316. package/bin/lib/proxy-health.js +0 -253
  317. package/bin/lib/telemetry.js +0 -441
package/README.md CHANGED
@@ -1,386 +1,257 @@
1
- ```
2
- _ _____ _____ _ _ _____ ____
3
- / \ | ____|_ _| | | | ____| _ \
4
- / _ \ | _| | | | |_| | _| | |_) |
5
- / ___ \| |___ | | | _ | |___| _ <
6
- /_/ \_\_____| |_| |_| |_|_____|_| \_\
7
- ```
8
-
9
1
  <div align="center">
10
2
 
11
- **22 specialized agents that spawn, coordinate, and self-organize.**
3
+ # ๐Ÿœ Aether Colony
12
4
 
13
- โžก๏ธ Click **Use this template** (top-right) to create your own Aether repo in 30 seconds.
5
+ **Multi-agent AI development for Claude Code and OpenCode**
14
6
 
15
- *Inspired by [glittercowboy's GSD system](https://github.com/glittercowboy/gsd)*
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)
16
12
 
17
- [![npm version](https://img.shields.io/npm/v/aether-colony.svg)](https://www.npmjs.com/package/aether-colony)
18
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
13
+ Spawn a colony of 24 AI specialists that self-organize around your goal using pheromone signals.
14
+ 1,000+ weekly installs.
19
15
 
20
- **v5.0.0** โ€” Worker Emergence (22 real Claude Code agents)
21
- </div>
22
-
23
- ---
16
+ *Artificial Ecology For Thought and Emergent Reasoning*
24
17
 
25
- > *"The whole is greater than the sum of its parts."* โ€” Aristotle
18
+ *The whole is greater than the sum of its ants.*
26
19
 
27
- ---
20
+ ```bash
21
+ npm install -g aether-colony
22
+ ```
28
23
 
29
- ## What Is Aether?
24
+ </div>
30
25
 
31
- Aether brings **ant colony intelligence** to Claude Code. Instead of one agent doing everything sequentially, you get a colony of specialists that self-organize around your goal.
26
+ <p align="center">
27
+ <img src="./AetherAnts.png" alt="Aether Colony" width="640" />
28
+ </p>
32
29
 
33
30
  ```
34
- ๐Ÿ‘‘ Queen (you)
35
- โ”‚
36
- โ–ผ pheromone signals
37
- โ”‚
38
- ๐Ÿœ Workers spawn Workers (max depth 3)
39
- โ”‚
40
- โ”œโ”€โ”€ ๐Ÿ”จ Builders โ€” implement code
41
- โ”œโ”€โ”€ ๐Ÿ‘๏ธ Watchers โ€” verify & test
42
- โ”œโ”€โ”€ ๐Ÿ” Scouts โ€” research docs
43
- โ”œโ”€โ”€ ๐Ÿ—บ๏ธ Colonizers โ€” explore codebases
44
- โ”œโ”€โ”€ ๐Ÿ“‹ Route-setters โ€” plan phases
45
- โ”œโ”€โ”€ ๐Ÿ—๏ธ Architects โ€” extract patterns
46
- โ”œโ”€โ”€ ๐Ÿบ Archaeologists โ€” excavate git history
47
- โ”œโ”€โ”€ ๐Ÿ”ฎ Oracles โ€” deep research (RALF pattern)
48
- โ””โ”€โ”€ ๐ŸŽฒ Chaos Ants โ€” resilience testing
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
+ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
49
50
  ```
50
51
 
51
- 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.**
52
+ ## ๐Ÿœ The Problem
52
53
 
53
- ### Key Features
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.
54
55
 
55
- - **22 Claude Code Agents** โ€” Real subagents, not definitions โ€” `/ant:build` spawns a genuine `aether-builder`
56
- - **34 Slash Commands** โ€” Lifecycle, research, coordination, and utility
57
- - **Real Agent Spawning** โ€” Run `/ant:build 1` and a real builder spawns to write your code
58
- - **6-Phase Verification** โ€” Build, types, lint, tests, security, diff
59
- - **Colony Memory** โ€” Learnings and instincts persist across sessions
60
- - **Pheromone Signals** โ€” Focus, Redirect, Feedback to steer the colony
61
- - **Pause/Resume** โ€” Full state serialization for context breaks
62
- - **Oracle Deep Research** โ€” 50+ iteration autonomous research loop
56
+ ## ๐Ÿœ The Solution
63
57
 
64
- ---
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.
65
59
 
66
- ## Quick Start
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.
67
61
 
68
- ### Prerequisites
62
+ You steer the colony with **pheromone signals**, not micromanagement:
69
63
 
70
- - [Claude Code](https://claude.ai/code) (Anthropic's CLI)
71
- - Node.js >= 16
72
- - `jq` โ€” `brew install jq` on macOS
73
-
74
- ### Installation
75
-
76
- ```bash
77
- npm install -g aether-colony
64
+ ```
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"
78
68
  ```
79
69
 
80
- This installs 22 Claude Code agents to `~/.claude/agents/ant/` plus 34 slash commands.
81
-
82
- All runtime state, utilities, and worker specs live **repo-local** in `.aether/` โ€” each project is self-contained.
83
-
84
- ### Your First Colony
70
+ The colony **remembers**. Wisdom, learnings, and instincts persist across sessions. The ๐Ÿง  Hive Brain shares knowledge across colonies on your machine.
85
71
 
86
- Open Claude Code in any repo:
72
+ ## ๐Ÿš€ Quick Start
87
73
 
88
74
  ```bash
89
- /ant:init "Build a REST API with authentication"
90
- /ant:plan
91
- /ant:build 1
92
- /ant:continue
93
- ```
75
+ # Install globally
76
+ npm install -g aether-colony
94
77
 
95
- That's it. The colony takes over from there.
78
+ # In your project repo:
79
+ /ant:lay-eggs # ๐Ÿฅš Set up Aether (one-time)
80
+ /ant:init "Build X" # ๐ŸŒฑ Start a colony with a goal
81
+ /ant:plan # ๐Ÿ“‹ Generate phased roadmap
82
+ /ant:run # ๐Ÿœ Autopilot: build, verify, advance all phases
83
+ /ant:seal # ๐Ÿบ Done โ€” archive the colony
84
+ ```
96
85
 
97
- ---
86
+ That's it. Five commands from zero to shipped.
98
87
 
99
- ## Command Reference
88
+ ## โœจ Key Features
100
89
 
101
- ### Core Lifecycle
90
+ - ๐Ÿœ **24 Specialized Agents** โ€” Real subagents spawned via Task tool, from builders to archaeologists
91
+ - โšก **44 Slash Commands** โ€” Full lifecycle management across Claude Code and OpenCode
92
+ - ๐ŸŽฏ **Pheromone System** โ€” Guide the colony with FOCUS, REDIRECT, FEEDBACK signals
93
+ - ๐Ÿง  **Colony Memory** โ€” Learnings persist across sessions via QUEEN.md wisdom
94
+ - ๐ŸŒ **Hive Brain** โ€” Cross-colony wisdom sharing with domain-scoped retrieval
95
+ - ๐Ÿ“š **Skills System** โ€” 28 skills (10 colony + 18 domain) inject domain knowledge into workers
96
+ - ๐Ÿค– **Autopilot** (`/ant:run`) โ€” Automated build-verify-advance loop with smart pause conditions
97
+ - โœ… **6-Phase Verification** โ€” Build, types, lint, tests, security, diff gates before any phase advances
98
+ - ๐Ÿ›ก๏ธ **Quality Gates** โ€” Security (Gatekeeper), quality (Auditor), coverage (Probe), performance (Measurer)
99
+ - ๐Ÿ” **Per-Phase Research** โ€” Scouts investigate domain knowledge before task decomposition
100
+ - ๐Ÿ”ฎ **Oracle Deep Research** โ€” Autonomous research loop for complex investigations
101
+ - ๐Ÿ’พ **Pause/Resume** โ€” Full state serialization for context breaks
102
102
 
103
- | Command | Description |
104
- |---------|-------------|
105
- | `/ant:init "goal"` | Initialize colony with mission |
106
- | `/ant:plan` | Generate phased roadmap |
107
- | `/ant:build N` | Execute phase N with worker waves |
108
- | `/ant:continue` | 6-phase verification, advance to next phase |
109
- | `/ant:pause-colony` | Save state for context break |
110
- | `/ant:resume-colony` | Restore from pause |
111
- | `/ant:seal` | Complete and archive colony |
112
- | `/ant:entomb` | Create chamber from completed colony |
113
-
114
- **Core Flow:**
115
- ```
116
- /ant:init โ†’ /ant:plan โ†’ /ant:build 1 โ†’ /ant:continue โ†’ /ant:build 2 โ†’ ... โ†’ /ant:seal
117
- ```
103
+ ## ๐Ÿ“– Commands
118
104
 
119
- ### Research & Analysis
105
+ <details>
106
+ <summary><strong>๐Ÿ—๏ธ Core Lifecycle</strong></summary>
120
107
 
121
108
  | Command | Description |
122
109
  |---------|-------------|
123
- | `/ant:colonize` | 4 parallel scouts analyze your codebase |
124
- | `/ant:archaeology <path>` | Excavate git history for any file |
125
- | `/ant:oracle ["topic"]` | Deep research (50+ iteration loop) |
126
- | `/ant:chaos <target>` | Resilience testing, edge case probing |
127
- | `/ant:swarm ["problem"]` | 4 parallel scouts for stubborn bugs |
128
- | `/ant:dream` | Philosophical codebase wanderer |
129
- | `/ant:organize` | Codebase hygiene report |
130
-
131
- ### Coordination
110
+ | `/ant:lay-eggs` | ๐Ÿฅš Set up Aether in this repo (one-time) |
111
+ | `/ant:init "goal"` | ๐ŸŒฑ Initialize colony with mission |
112
+ | `/ant:plan` | ๐Ÿ“‹ Generate phased roadmap with domain research |
113
+ | `/ant:build N` | ๐Ÿ”จ Execute phase N with worker waves |
114
+ | `/ant:continue` | โžก๏ธ 6-phase verification, advance to next phase |
115
+ | `/ant:run` | ๐Ÿœ Autopilot โ€” build, verify, advance automatically |
116
+ | `/ant:patrol` | ๐Ÿ” Pre-seal audit โ€” verify work against plan |
117
+ | `/ant:seal` | ๐Ÿบ Complete and archive colony |
118
+ | `/ant:entomb` | โšฐ๏ธ Create chamber from completed colony |
119
+ | `/ant:pause-colony` | ๐Ÿ’พ Save state for context break |
120
+ | `/ant:resume-colony` | ๐Ÿšฆ Restore from pause |
121
+
122
+ </details>
123
+
124
+ <details>
125
+ <summary><strong>๐ŸŽฏ Pheromone Signals</strong></summary>
132
126
 
133
127
  | Command | Description |
134
128
  |---------|-------------|
135
- | `/ant:council` | Clarify intent via multi-choice questions |
136
- | `/ant:focus "area"` | FOCUS signal โ€” guide attention |
137
- | `/ant:redirect "pattern"` | REDIRECT signal โ€” hard constraint |
138
- | `/ant:feedback "msg"` | FEEDBACK signal โ€” teach preferences |
129
+ | `/ant:focus "area"` | ๐ŸŽฏ FOCUS โ€” "Pay attention here" |
130
+ | `/ant:redirect "pattern"` | ๐Ÿšซ REDIRECT โ€” "Don't do this" (hard constraint) |
131
+ | `/ant:feedback "note"` | ๐Ÿ’ฌ FEEDBACK โ€” "Adjust based on this" |
132
+ | `/ant:pheromones` | ๐Ÿ“Š View active signals |
133
+ | `/ant:export-signals` | ๐Ÿ“ค Export signals to XML |
134
+ | `/ant:import-signals` | ๐Ÿ“ฅ Import signals from XML |
135
+
136
+ </details>
139
137
 
140
- ### Visibility
138
+ <details>
139
+ <summary><strong>๐Ÿ”ฌ Research & Analysis</strong></summary>
141
140
 
142
141
  | Command | Description |
143
142
  |---------|-------------|
144
- | `/ant:status` | Colony overview |
145
- | `/ant:watch` | Real-time swarm display |
146
- | `/ant:history` | Recent activity log |
147
- | `/ant:flags` | List blockers and issues |
148
- | `/ant:help` | Full command reference |
149
-
150
- ---
151
-
152
- ## CLI Commands
153
-
154
- ```bash
155
- # View version and status
156
- aether version
157
-
158
- # Update all registered repos
159
- aether update --all
160
-
161
- # Checkpoints (safe snapshots)
162
- aether checkpoint create "before refactor"
163
- aether checkpoint list
164
- aether checkpoint restore <id>
165
-
166
- # View telemetry
167
- aether telemetry
168
-
169
- # Context
170
- aether context # Show context including nestmates
171
- aether nestmates # List sibling colonies
172
- aether spawn-tree # Display worker spawn tree
173
- ```
174
-
175
- ---
176
-
177
- ## The Castes
178
-
179
- Workers have distinct personalities and roles, organized by tier:
180
-
181
- ### Core Workers
182
-
183
- | Caste | Role | Personality |
184
- |-------|------|-------------|
185
- | ๐Ÿ‘‘ **Queen** | Orchestrates, spawns workers | Coordinating |
186
- | ๐Ÿ”จ **Builder** | Writes code, TDD-first | Pragmatic, direct |
187
- | ๐Ÿ‘๏ธ **Watcher** | Tests, validates | Vigilant, careful |
188
- | ๐Ÿ” **Scout** | Researches, discovers | Curious |
189
-
190
- ### Orchestration
191
-
192
- | Caste | Role | Personality |
193
- |-------|------|-------------|
194
- | ๐Ÿ“‹ **Route-Setter** | Plans phases | Structured |
195
- | ๐Ÿ—บ๏ธ **Colonizer** | Explores codebases, maps structure | Exploratory |
196
- | ๐Ÿ“Š **Surveyor** | Measures codebase metrics | Systematic |
197
-
198
- ### Specialists
199
-
200
- | Caste | Role | Personality |
201
- |-------|------|-------------|
202
- | ๐Ÿ“š **Keeper** | Curates knowledge, patterns | Preserving |
203
- | ๐Ÿ› **Tracker** | Investigates bugs, root cause | Methodical |
204
- | ๐Ÿงช **Probe** | Generates tests | Thorough |
205
- | ๐Ÿ”„ **Weaver** | Refactors code | Transformative |
206
- | ๐Ÿ‘ฅ **Auditor** | Reviews code quality | Critical |
207
-
208
- ### Niche
209
-
210
- | Caste | Role | Personality |
211
- |-------|------|-------------|
212
- | ๐Ÿ“ฆ **Gatekeeper** | Dependency audits | Protective |
213
- | โ™ฟ **Includer** | Accessibility audits | Inclusive |
214
- | โšก **Measurer** | Performance profiling | Precise |
215
- | ๐ŸŽฒ **Chaos** | Resilience testing | Adversarial |
216
- | ๐Ÿบ **Archaeologist** | Excavates git history | Investigative |
217
- | ๐Ÿ”Œ **Ambassador** | Third-party APIs | Diplomatic |
218
- | ๐Ÿ“ **Chronicler** | Documentation | Recording |
219
- | ๐Ÿ”ฎ **Sage** | Deep research (RALF loop) | Analytical |
220
-
221
- Run `/ant:colonize` and 4 surveyor agents map your entire codebase. Run `/ant:build 1` and a real builder spawns.
143
+ | `/ant:colonize` | ๐Ÿ“Š๐Ÿ—บ๏ธ 4 parallel scouts analyze your codebase |
144
+ | `/ant:oracle "topic"` | ๐Ÿ”ฎ Deep research with autonomous loop |
145
+ | `/ant:archaeology <path>` | ๐Ÿบ Excavate git history for any file |
146
+ | `/ant:chaos <target>` | ๐ŸŽฒ Resilience testing, edge case probing |
147
+ | `/ant:swarm "problem"` | ๐Ÿ”ฅ 4 parallel scouts for stubborn bugs |
148
+ | `/ant:dream` | ๐Ÿ’ญ Philosophical codebase wanderer |
149
+ | `/ant:interpret` | ๐Ÿ” Grounds dreams in reality |
150
+ | `/ant:organize` | ๐Ÿงน Codebase hygiene report |
222
151
 
223
- ---
152
+ </details>
224
153
 
225
- ## Spawn Depth
154
+ <details>
155
+ <summary><strong>๐Ÿ‘๏ธ Visibility & Status</strong></summary>
226
156
 
227
- ```
228
- ๐Ÿ‘‘ Queen (depth 0)
229
- โ””โ”€โ”€ ๐Ÿ”จ Builder-1 (depth 1) โ€” can spawn 4 more
230
- โ”œโ”€โ”€ ๐Ÿ” Scout-7 (depth 2) โ€” can spawn 2 more
231
- โ”‚ โ””โ”€โ”€ ๐Ÿ” Scout-12 (depth 3) โ€” no more spawning
232
- โ””โ”€โ”€ ๐Ÿ‘๏ธ Watcher-3 (depth 2)
233
- ```
234
-
235
- - **Depth 1**: Up to 4 spawns
236
- - **Depth 2**: Up to 2 spawns (only if genuinely surprised)
237
- - **Depth 3**: Complete inline, no further spawning
238
- - **Global cap**: 10 workers per phase
239
-
240
- ---
241
-
242
- ## 6-Phase Verification
243
-
244
- Before any phase advances:
245
-
246
- | Gate | Check |
247
- |------|-------|
248
- | Build | Project compiles/bundles |
249
- | Types | Type checker passes |
250
- | Lint | Linter passes |
251
- | Tests | All tests pass (80%+ coverage target) |
252
- | Security | No exposed secrets or debug artifacts |
253
- | Diff | Review changes, no unintended modifications |
254
-
255
- ---
256
-
257
- ## File Structure
258
-
259
- See [repo-structure.md](repo-structure.md) for a quick overview of all directories.
260
-
261
- ```
262
- <your-repo>/.aether/ # Repo-local runtime
263
- โ”œโ”€โ”€ workers.md # Worker specs and spawn protocol
264
- โ”œโ”€โ”€ aether-utils.sh # Utility layer (80+ subcommands)
265
- โ”œโ”€โ”€ model-profiles.yaml # Model routing config
266
- โ”‚
267
- โ”œโ”€โ”€ docs/ # Documentation
268
- โ”œโ”€โ”€ utils/ # Utility scripts
269
- โ”œโ”€โ”€ oracle/ # Oracle research
270
- โ”‚
271
- โ”œโ”€โ”€ data/ # State (NEVER synced)
272
- โ”‚ โ”œโ”€โ”€ COLONY_STATE.json # Goal, plan, memory
273
- โ”‚ โ”œโ”€โ”€ constraints.json # Focus and redirects
274
- โ”‚ โ””โ”€โ”€ spawn-tree.txt # Worker hierarchy
275
- โ”‚
276
- โ”œโ”€โ”€ dreams/ # Session notes (NEVER synced)
277
- โ””โ”€โ”€ chambers/ # Archived colonies
278
- ```
279
-
280
- ---
281
-
282
- ## Pheromone Signals
283
-
284
- | Signal | Command | Use When |
285
- |--------|---------|----------|
286
- | FOCUS | `/ant:focus "area"` | "Pay attention here" |
287
- | REDIRECT | `/ant:redirect "avoid"` | "Don't do this" (hard constraint) |
288
- | FEEDBACK | `/ant:feedback "note"` | "Adjust based on this" |
289
-
290
- - **Before builds**: FOCUS + REDIRECT to steer
291
- - **After builds**: FEEDBACK to adjust
292
- - **Hard constraints**: REDIRECT (will break)
293
- - **Gentle nudges**: FEEDBACK (preferences)
294
-
295
- ---
296
-
297
- ## Typical Workflows
298
-
299
- ### Starting a New Project
300
-
301
- ```
302
- 1. /ant:init "Build feature X" # Set the goal
303
- 2. /ant:colonize # Analyze existing code (optional)
304
- 3. /ant:plan # Generate phases
305
- 4. /ant:focus "security" # Guide attention (optional)
306
- 5. /ant:build 1 # Execute phase 1
307
- 6. /ant:continue # Verify, advance
308
- 7. Repeat until done
309
- 8. /ant:seal # Complete and archive
310
- ```
157
+ | Command | Description |
158
+ |---------|-------------|
159
+ | `/ant:status` | ๐Ÿ“ˆ Colony overview with memory health |
160
+ | `/ant:memory-details` | ๐Ÿง  Wisdom, pending promotions, recent failures |
161
+ | `/ant:watch` | ๐Ÿ‘๏ธ Real-time swarm display |
162
+ | `/ant:history` | ๐Ÿ“œ Recent activity log |
163
+ | `/ant:flags` | ๐Ÿšฉ List blockers and issues |
164
+ | `/ant:help` | ๐Ÿœ Full command reference |
311
165
 
312
- ### Deep Research
166
+ </details>
313
167
 
314
- ```
315
- /ant:oracle "research topic" # Launch Oracle
316
- /ant:oracle status # Check progress
317
- /ant:oracle stop # Stop if needed
318
- # Read findings in .aether/oracle/discoveries/
319
- ```
168
+ <details>
169
+ <summary><strong>๐Ÿ”ง Coordination & Maintenance</strong></summary>
320
170
 
321
- ### When Stuck
171
+ | Command | Description |
172
+ |---------|-------------|
173
+ | `/ant:council` | ๐Ÿ“œ Clarify intent via multi-choice questions |
174
+ | `/ant:flag "title"` | ๐Ÿšฉ Create project-specific flag |
175
+ | `/ant:data-clean` | ๐Ÿงน Remove test artifacts from colony data |
176
+ | `/ant:preferences` | โš™๏ธ Add or list user preferences |
177
+ | `/ant:skill-create "topic"` | ๐Ÿœ Create custom domain skill |
178
+ | `/ant:update` | ๐Ÿ”„ Update system files from hub |
179
+
180
+ </details>
181
+
182
+ ## ๐Ÿœ The 24 Agents
183
+
184
+ | Tier | Agent | Role |
185
+ |------|-------|------|
186
+ | ๐Ÿ‘‘ **Core** | Builder | ๐Ÿ”จ Writes code, TDD-first |
187
+ | ๐Ÿ‘‘ **Core** | Watcher | ๐Ÿ‘๏ธ Tests, validates, quality gates |
188
+ | ๐Ÿ‘‘ **Core** | Scout | ๐Ÿ” Researches, discovers |
189
+ | ๐Ÿ›๏ธ **Orchestration** | Queen | ๐Ÿ‘‘ Orchestrates phases, spawns workers |
190
+ | ๐Ÿ›๏ธ **Orchestration** | Route-Setter | ๐Ÿ“‹ Plans phases, breaks down goals |
191
+ | ๐Ÿ›๏ธ **Orchestration** | Architect | ๐Ÿ—๏ธ Architecture design |
192
+ | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-nest | ๐Ÿ“‚ Maps directory structure |
193
+ | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-disciplines | ๐Ÿ“ Documents conventions |
194
+ | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-pathogens | ๐Ÿฆ  Identifies tech debt |
195
+ | ๐Ÿ—บ๏ธ **Surveyor** | surveyor-provisions | ๐Ÿ“ฆ Maps dependencies |
196
+ | โšก **Specialist** | Keeper | ๐Ÿ“š Preserves knowledge |
197
+ | โšก **Specialist** | Tracker | ๐Ÿ› Investigates bugs |
198
+ | โšก **Specialist** | Probe | ๐Ÿ”ฌ Coverage analysis |
199
+ | โšก **Specialist** | Weaver | ๐Ÿงต Refactoring specialist |
200
+ | โšก **Specialist** | Auditor | โœ… Quality gate |
201
+ | ๐ŸŽฏ **Niche** | Chaos | ๐ŸŽฒ Resilience testing |
202
+ | ๐ŸŽฏ **Niche** | Archaeologist | ๐Ÿบ Excavates git history |
203
+ | ๐ŸŽฏ **Niche** | Gatekeeper | ๐Ÿ›ก๏ธ Security gate |
204
+ | ๐ŸŽฏ **Niche** | Includer | โ™ฟ Accessibility audits |
205
+ | ๐ŸŽฏ **Niche** | Measurer | โฑ๏ธ Performance analysis |
206
+ | ๐ŸŽฏ **Niche** | Sage | ๐Ÿง™ Wisdom synthesis |
207
+ | ๐ŸŽฏ **Niche** | Oracle | ๐Ÿ”ฎ Deep research |
208
+ | ๐ŸŽฏ **Niche** | Ambassador | ๐ŸŒ External integrations |
209
+ | ๐ŸŽฏ **Niche** | Chronicler | ๐Ÿ“ Documentation |
210
+
211
+ ## ๐Ÿ—๏ธ Architecture
322
212
 
323
213
  ```
324
- /ant:dream # Let the Dreamer observe
325
- /ant:swarm "bug description" # 4 parallel scouts investigate
326
- /ant:archaeology src/module/ # Excavate why code exists
327
- /ant:chaos "auth flow" # Test resilience
214
+ .aether/ # ๐Ÿœ Colony files (repo-local)
215
+ โ”œโ”€โ”€ aether-utils.sh # โšก Dispatcher (~5,200 lines, ~150 subcommands)
216
+ โ”œโ”€โ”€ utils/ # ๐Ÿ”ง ~29 modular scripts
217
+ โ”œโ”€โ”€ skills/ # ๐Ÿ“š 28 skills (10 colony + 18 domain)
218
+ โ”œโ”€โ”€ commands/ # ๐Ÿ“– 44 YAML command sources
219
+ โ”œโ”€โ”€ exchange/ # ๐Ÿ“ค XML exchange modules
220
+ โ”œโ”€โ”€ docs/ # ๐Ÿ“ Documentation
221
+ โ”œโ”€โ”€ templates/ # ๐Ÿ“‹ 12 templates
222
+ โ””โ”€โ”€ data/ # ๐Ÿ’พ Colony state (local only)
223
+
224
+ ~/.aether/ # ๐ŸŒ Hub (cross-colony, user-level)
225
+ โ”œโ”€โ”€ QUEEN.md # ๐Ÿ‘‘ Wisdom + preferences
226
+ โ”œโ”€โ”€ hive/wisdom.json # ๐Ÿง  Cross-colony wisdom (200 cap)
227
+ โ””โ”€โ”€ registry.json # ๐Ÿ“Š All registered colonies
328
228
  ```
329
229
 
330
- ---
230
+ ## ๐Ÿ”Œ Works With
331
231
 
332
- ## Safety Features
232
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** โ€” 44 slash commands + 24 agent definitions
233
+ - **[OpenCode](https://github.com/opencode-ai/opencode)** โ€” 44 slash commands + agent definitions
333
234
 
334
- - **File Locking** โ€” Prevents concurrent modification
335
- - **Atomic Writes** โ€” Temp file + rename pattern
336
- - **Update Transactions** โ€” Two-phase commit with rollback
337
- - **State Validation** โ€” Schema validation before modifications
338
- - **Git Checkpoints** โ€” Automatic commits before phases
339
- - **Checkpoint System** โ€” Safe snapshots with `aether checkpoint`
235
+ ## โค๏ธ Support Aether
340
236
 
341
- ---
237
+ If Aether has been useful to you, here's how you can keep the colony alive:
342
238
 
343
- ## Known Issues
239
+ **[Sponsor on GitHub](https://github.com/sponsors/calcosmic)** (preferred)
344
240
 
345
- 1. **Init may fail if `.aether/data/` doesn't exist** โ€” Run `mkdir -p .aether/data` before `/ant:init` if you see "Error writing file".
241
+ <details>
242
+ <summary>๐Ÿ’ก Crypto โ€” no middlemen, no fees</summary>
346
243
 
347
- 2. **Long commands can cause Claude to lose context** โ€” Commands like `build.md` (1,000+ lines) may cause Claude to skip steps. Use `/ant:status` and `/ant:continue` to recover.
244
+ | Network | Address |
245
+ |---------|---------|
246
+ | **ETH** (MetaMask) | `0xE7F8C9BE190c207D49DF01b82747cf7B6Bd1c809` |
247
+ | **SOL** (Phantom) | `6DVTdoZvvi9siUpgmRJZxk5Kqho8TZiN2ZzyVUVC9gX8` |
348
248
 
349
- ---
249
+ </details>
350
250
 
351
- ## Installation & Updates
251
+ [PayPal](https://www.paypal.com/ncp/payment/RENG7ZMW5F59L) ยท [Buy Me a Coffee](https://buymeacoffee.com/music5y)
352
252
 
353
- ```bash
354
- # Install globally
355
- npm install -g aether-colony
253
+ *Your support funds servers, new features, docs, and keeps Aether free & open source (MIT).*
356
254
 
357
- # Verify install
358
- aether version
359
- ls ~/.claude/commands/ant/
360
-
361
- # Update all registered repos
362
- aether update --all
363
-
364
- # Update npm package
365
- npm update -g aether-colony
366
- ```
255
+ ## ๐Ÿ“„ License
367
256
 
368
- ---
369
-
370
- ## Acknowledgments
371
-
372
- Inspired by **[glittercowboy](https://github.com/glittercowboy)** and the **[GSD system](https://github.com/glittercowboy/gsd)**. GSD showed what Claude Code could become with the right orchestration. Aether adds ant colony dynamics โ€” pheromones, castes, nested spawning, and self-organizing workers.
373
-
374
- ---
375
-
376
- ## License
377
-
378
- MIT โ€” do whatever you want with it.
379
-
380
- ---
381
-
382
- <div align="center">
383
-
384
- *๐Ÿœ The colony is greater than the sum of its ants. ๐Ÿœ*
385
-
386
- </div>
257
+ MIT