devsquad-ai 1.0.0

package/README.zh-cn.md

@@ -0,0 +1,345 @@
+> [!WARNING]
+> **安全警告：注意假冒网站**
+>
+> **ohmyopencode.com 与本项目没有任何关系。** 我们不运营也不认可该网站。
+>
+> OhMyOpenCode 是**免费且开源的**。**不要**从自称“官方”的第三方网站下载安装程序或输入付款信息。
+>
+> 假冒网站隐藏在付费墙后，我们**无法验证它分发的内容**。将其所有下载视为**潜在危险**。
+>
+> ✅ 官方下载地址：https://github.com/devsquad-ai/devsquad/releases
+
+> [!NOTE]
+>
+> [![Sisyphus Labs - Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
+> > **我们正在构建 Sisyphus 的完全产品化版本，以定义前沿智能体 (Frontier Agents) 的未来。<br />[在此处](https://sisyphuslabs.ai)加入候补名单。**
+
+> [!TIP]
+> 加入我们！
+>
+> | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | 加入我们的 [Discord 社区](https://discord.gg/PUwSMR9XNk)，与贡献者及其他 `devsquad` 用户交流。 |
+> | :-----| :----- |
+> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | 关于 `devsquad` 的新闻和更新过去发布在我的 X 账号上。<br /> 因为账号被意外停用，现在由 [@justsisyphus](https://x.com/justsisyphus) 代为发布更新。 |
+
+<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
+
+<div align="center">
+
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/devsquad-ai/devsquad#devsquad)
+
+[![Preview](./.github/assets/omo.png)](https://github.com/devsquad-ai/devsquad#devsquad)
+
+</div>
+
+> 这是类固醇式编程。不是一个模型的类固醇——而是整个药库。
+>
+> 用 Claude 做编排，用 GPT 做推理，用 Kimi 提速度，用 Gemini 处理视觉。模型正在变得越来越便宜，越来越聪明。没有一个提供商能够垄断。我们正在为那个开放的市场而构建。Anthropic 的牢笼很漂亮。但我们不住那。
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/devsquad-ai/devsquad?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/devsquad-ai/devsquad/releases)
+[![npm downloads](https://img.shields.io/npm/dt/devsquad?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/devsquad)
+[![GitHub Contributors](https://img.shields.io/github/contributors/devsquad-ai/devsquad?color=c4f042&labelColor=black&style=flat-square)](https://github.com/devsquad-ai/devsquad/graphs/contributors)
+[![GitHub Forks](https://img.shields.io/github/forks/devsquad-ai/devsquad?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/devsquad-ai/devsquad/network/members)
+[![GitHub Stars](https://img.shields.io/github/stars/devsquad-ai/devsquad?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/devsquad-ai/devsquad/stargazers)
+[![GitHub Issues](https://img.shields.io/github/issues/devsquad-ai/devsquad?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/devsquad-ai/devsquad/issues)
+[![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/devsquad-ai/devsquad/blob/master/LICENSE.md)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/devsquad-ai/devsquad)
+
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
+
+</div>
+
+<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
+
+## 评价
+
+> “因为它，我取消了 Cursor 的订阅。开源社区正在发生令人难以置信的事情。” - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
+
+> “如果人类需要 3 个月完成的事情 Claude Code 需要 7 天，那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。” <br/>- B, 量化研究员
+
+> “用 Oh My Opencode 一天之内解决了 8000 个 eslint 警告。” <br/>- [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
+
+> “我用 Ohmyopencode 和 ralph loop 花了一晚上的时间，把一个 45k 行代码的 tauri 应用转换成了 SaaS Web 应用。从面试模式开始，让它对我提供的提示词进行提问和提出建议。看着它工作很有趣，今早醒来看到网站基本已经跑起来了，太震撼了！” - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
+
+> “用 devsquad 吧，你绝对回不去了。” <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
+
+> “我很难准确描述它到底哪里牛逼，但开发体验已经达到完全不同的维度了。” - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
+
+> “这周末我用 open code、oh my opencode 和 supermemory 瞎折腾一个像我的世界/魂系一样的怪物游戏。吃完午饭去散步前，我让它把下蹲动画加进去。[视频]” - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
+
+> “你们真该把这个合并到核心代码里，然后把他招安了。说真的，这东西实在太牛了。” <br/>- Henning Kilset
+
+> “如果你们能说服 @yeon_gyu_kim，赶紧招募他。这个人彻底改变了 opencode。” <br/>- [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
+
+> “Oh My OpenCode 简直疯了。” - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
+
+---
+
+# Oh My OpenCode
+
+我们最初把这叫做“给 Claude Code 打类固醇”。那是低估了它。
+
+不是只给一个模型打药。我们在运营一个联合体。Claude、GPT、Kimi、Gemini——各司其职，并行运转，永不停歇。模型每个月都在变便宜，没有任何提供商能够垄断。我们已经活在那个世界里了。
+
+脏活累活我们替你干了。我们测试了一切，只留下了真正有用的。
+
+安装 OmO。敲下 `ultrawork`。疯狂地写代码吧。
+
+
+
+## 安装
+
+### 给人类看的
+
+复制并粘贴以下提示词到你的 LLM Agent (Claude Code, AmpCode, Cursor 等):
+
+```
+Install and configure devsquad by following the instructions here:
+https://raw.githubusercontent.com/devsquad-ai/devsquad/refs/heads/master/docs/guide/installation.md
+```
+
+或者你可以直接去读 [安装指南](docs/guide/installation.md)，但说真的，让 Agent 去干吧。人类配环境总是容易敲错字母。
+
+### 给 LLM Agent 看的
+
+获取安装指南并照做：
+
+```bash
+curl -s https://raw.githubusercontent.com/devsquad-ai/devsquad/refs/heads/master/docs/guide/installation.md
+```
+
+---
+
+## 跳过这个 README 吧
+
+读文档的时代已经过去了。直接把下面这行发给你的 Agent：
+
+```
+Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/devsquad-ai/devsquad/refs/heads/dev/README.md
+```
+
+## 核心亮点
+
+### 🪄 `ultrawork`
+
+你竟然还在往下读？真有耐心。
+
+安装。输入 `ultrawork` (或者 `ulw`)。搞定。
+
+下面的内容，包括所有特性、所有优化，你全都不需要知道，它自己就能完美运行。
+
+只需以下订阅之一，ultrawork 就能顺畅工作（本项目与它们没有任何关联，纯属个人推荐）：
+- [ChatGPT 订阅 ($20)](https://chatgpt.com/)
+- [Kimi Code 订阅 ($0.99) (*仅限本月*)](https://www.kimi.com/membership/pricing?track_id=5cdeca93-66f0-4d35-aabb-b6df8fcea328)
+- [GLM Coding 套餐 ($10)](https://z.ai/subscribe)
+- 如果你能使用按 token 计费的方式，用 kimi 和 gemini 模型花不了多少钱。
+
+|       | 特性                      | 功能说明                                                                                                                        |
+| :---: | :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
+|   🤖   | **自律军团 (Discipline Agents)** | Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。                                       |
+|   ⚡   | **`ultrawork` / `ulw`**      | 一键触发，所有智能体出动。任务完成前绝不罢休。                                                                           |
+|   🚪   | **[IntentGate 意图门](https://factory.ai/news/terminal-bench)**                 | 真正行动前，先分析用户的真实意图。彻底告别被字面意思误导的 AI 废话。                                         |
+|   🔗   | **基于哈希的编辑工具**  | 每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[马具问题 →](https://blog.can.ac/2026/02/12/the-harness-problem/) |
+|   🛠️   | **LSP + AST-Grep**           | 工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。                                              |
+|   🧠   | **后台智能体**        | 同时发射 5+ 个专家并行工作。保持上下文干净，随时获取成果。                                                            |
+|   📚   | **内置 MCP**            | Exa (网络搜索)、Context7 (官方文档)、Grep.app (GitHub 源码搜索)。默认开启。                                                    |
+|   🔁   | **Ralph Loop / `/ulw-loop`** | 自我引用闭环。达不到 100% 完成度绝不停止。                                                                                |
+|   ✅   | **Todo 强制执行**            | Agent 想要摸鱼？系统直接揪着领子拽回来。你的任务，必须完成。                                                                 |
+|   💬   | **注释审查员**          | 剔除带有浓烈 AI 味的冗余注释。写出的代码就像老练的高级工程师写的。                                                                          |
+|   🖥️   | **Tmux 集成**         | 完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具，全都在实时会话中完成。                                                                        |
+|   🔌   | **Claude Code 兼容**   | 你现有的 Hooks、命令、技能、MCP 和插件？全都能无缝迁移过来。                                                                     |
+|   🎯   | **技能内嵌 MCP**      | 技能自带其所需的 MCP 服务器。按需开启，不会撑爆你的上下文窗口。                                                                               |
+|   📋   | **Prometheus 规划师**       | 动手写代码前，先通过访谈模式做好战略规划。                                                                             |
+|   🔍   | **`/init-deep`**             | 在整个项目目录层级中自动生成 `AGENTS.md`。不仅省 Token，还能大幅提升 Agent 理解力。 |
+
+### 自律军团 (Discipline Agents)
+
+<table><tr>
+<td align="center"><img src=".github/assets/sisyphus.png" height="300" /></td>
+<td align="center"><img src=".github/assets/hephaestus.png" height="300" /></td>
+</tr></table>
+
+**Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) 是你的主指挥官。他负责制定计划、分配任务给专家团队，并以极其激进的并行策略推动任务直至完成。他从不半途而废。
+
+**Hephaestus** (`gpt-5.3-codex`) 是你的自主深度工作者。你只需要给他目标，不要给他具体做法。他会自动探索代码库模式，从头到尾独立执行任务，绝不会中途要你当保姆。*名副其实的正牌工匠。*
+
+**Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) 是你的战略规划师。他通过访谈模式，在动一行代码之前，先通过提问确定范围并构建详尽的执行计划。
+
+每一个 Agent 都针对其底层模型的特点进行了专门调优。你无需手动来回切换模型。[阅读背景设定了解更多 →](docs/guide/overview.md)
+
+> Anthropic [因为我们屏蔽了 OpenCode](https://x.com/thdxr/status/2010149530486911014)。这就是为什么我们将 Hephaestus 命名为“正牌工匠 (The Legitimate Craftsman)”。这是一个故意的讽刺。
+>
+> 我们在 Opus 上运行得最好，但仅仅使用 Kimi K2.5 + GPT-5.3 Codex 就足以碾压原版的 Claude Code。完全不需要配置。
+
+### 智能体调度机制
+
+当 Sisyphus 把任务分配给子智能体时，他选择的不是具体的模型，而是 **类别 (Category)**。系统会自动将类别映射到最合适的模型：
+
+| 类别             | 作用领域                      |
+| :------------------- | :--------------------------------- |
+| `visual-engineering` | 前端、UI/UX、设计            |
+| `deep`               | 深度自主调研与执行    |
+| `quick`              | 单文件修改、修错字         |
+| `ultrabrain`         | 复杂硬核逻辑、架构决策 |
+
+智能体只需要说明要做什么类型的工作，框架就会挑选出最合适的模型去干。你完全不需要操心。
+
+### 完全兼容 Claude Code
+
+你已经花了大力气调教好了 Claude Code 的配置？太好了。
+
+这里完美兼容所有的 Hook、命令、技能、MCP 以及插件。所有配置直接生效，包括插件系统。
+
+### 赋予 Agent 世界级的开发工具
+
+LSP、AST-Grep、Tmux、MCP 并不是用胶水勉强糊在一起的，而是真正深度的集成。
+
+- **LSP**: 支持 `lsp_rename`、`lsp_goto_definition`、`lsp_find_references` 和 `lsp_diagnostics`。给 Agent 提供 IDE 般的精准操作。
+- **AST-Grep**: 支持 25 种编程语言，能够理解语法树的模式匹配和代码重写。
+- **Tmux**: 真实的交互式终端环境，支持 REPL、调试器以及 TUI 工具。Agent 的进程持久运行。
+- **MCP**: 内置 Web 搜索、官方文档直连以及 GitHub 级代码搜索。
+
+### 技能专属的按需 MCP 服务器
+
+一堆全局 MCP 服务器极其消耗 Context 额度，我们修好了这个问题。
+
+现在每个技能 (Skill) 都带着自己的专属 MCP。只在执行该任务时启动，任务完成即刻销毁。Context 窗口始终清爽。
+
+### 拒绝瞎改：基于内容哈希的编辑工具 (Hash-Anchored Edits)
+
+Harness 问题是真的。绝大多数所谓的 Agent 故障，其实并不是大模型变笨了，而是他们用的文件编辑工具太烂了。
+
+> *“目前所有工具都无法为模型提供一种稳定、可验证的行定位标识……它们全都依赖于模型去强行复写一遍自己刚才看到的原文。当模型一旦写错——而且这很常见——用户就会怪罪于大模型太蠢了。”*
+>
+> <br/>- [Can Bölük, The Harness Problem](https://blog.can.ac/2026/02/12/the-harness-problem/)
+
+受 [oh-my-pi](https://github.com/can1357/oh-my-pi) 的启发，我们实现了 **Hashline** 技术。Agent 读到的每一行代码，末尾都会打上一个强绑定的内容哈希值：
+
+```
+11#VK| function hello() {
+22#XJ|   return "world";
+33#MB| }
+```
+
+Agent 发起修改时，必须通过这些标签引用目标行。如果在此期间文件发生过变化，哈希验证就会失败，从而在代码被污染前直接驳回。不再有缩进空格错乱，彻底告别改错行的惨剧。
+
+在 Grok Code Fast 1 上，仅仅因为更换了这套编辑工具，修改成功率直接从 **6.7% 飙升至 68.3%**。
+
+### 深度上下文初始化：`/init-deep`
+
+执行一次 `/init-deep`。它会为你生成一个树状的 `AGENTS.md` 文件系统：
+
+```
+project/
+├── AGENTS.md              ← 全局级架构与约定
+├── src/
+│   ├── AGENTS.md          ← src 级规范
+│   └── components/
+│       └── AGENTS.md      ← 组件级详细说明
+```
+
+Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动喂喂喂的麻烦。
+
+### 让 Agent 动手前先过脑子：Prometheus
+
+碰到了硬骨头？千万不要扔个 Prompt 就双手合十祈祷。
+
+输入 `/start-work`，召唤 Prometheus 出场。**他会像一个真实的主管那样去采访你**，主动深挖需求、指出模糊地带，并在改动哪怕一行代码之前产出经过严密论证的计划。你的 Agent 终于知道了自己在干嘛。
+
+### 技能系统 (Skills)
+
+这里的 Skills 绝不只是一段无脑的 Prompt 模板。它们包含了：
+
+- 面向特定领域的极度调优系统指令
+- 按需加载的独立 MCP 服务器
+- 对 Agent 能力边界的强制约束
+
+默认内置：`playwright`（极其稳健的浏览器自动化）、`git-master`（全自动的原子级提交及 rebase 手术）、`frontend-ui-ux`（设计感拉满的 UI 实现）。
+
+想加你自己的？放进 `.opencode/skills/*/SKILL.md` 或者 `~/.config/opencode/skills/*/SKILL.md` 就行。
+
+**想看所有的硬核功能说明吗？** 点击查看 **[详细特性文档 (Features)](docs/reference/features.md)** ，深入了解 Agent 架构、Hook 流水线、核心工具链和所有的内置 MCP 等等。
+
+---
+
+> **第一次用 devsquad？** 阅读 **[概述](docs/guide/overview.md)** 了解你拥有哪些功能，或查看 **[编排指南](docs/guide/orchestration.md)** 了解 Agent 如何协作。
+
+## 如何卸载 (Uninstallation)
+
+要移除 devsquad:
+
+1. **从你的 OpenCode 配置文件中去掉插件**
+
+   编辑 `~/.config/opencode/opencode.json` (或 `opencode.jsonc`) ，并把 `"devsquad"` 从 `plugin` 数组中删掉：
+
+   ```bash
+   # 如果你有 jq 的话
+   jq '.plugin = [.plugin[] | select(. != "devsquad")]' \
+       ~/.config/opencode/opencode.json > /tmp/oc.json && \
+       mv /tmp/oc.json ~/.config/opencode/opencode.json
+   ```
+
+2. **清除配置文件 (可选)**
+
+   ```bash
+   # 移除全局用户配置
+   rm -f ~/.config/opencode/devsquad.json ~/.config/opencode/devsquad.jsonc
+
+   # 移除当前项目的配置
+   rm -f .opencode/devsquad.json .opencode/devsquad.jsonc
+   ```
+
+3. **确认卸载成功**
+
+   ```bash
+   opencode --version
+   # 这个时候就应该没有任何关于插件的输出信息了
+   ```
+
+## 闲聊环节 (Author's Note)
+
+**想知道做这个插件的哲学理念吗？** 阅读 [Ultrawork 宣言](docs/manifesto.md)。
+
+---
+
+我为了做个人项目，烧掉了整整 $24,000 的 LLM API Token 费用。我把市面上每个宣称好用的代码 Agent 全试了一遍，配置选项被我翻得底朝天。最后我得出了结论，OpenCode 赢了。
+
+我踩过的坑、撞过的南墙，它们的终极解法现在全都被硬编码到了这个插件里。你只需要安装，然后直接用。
+
+如果把 OpenCode 喻为底层的 Debian/Arch，那么 OmO 毫无疑问就是开箱即用的 Ubuntu/[Omarchy](https://omarchy.org/)。
+
+本项目受到 [AmpCode](https://ampcode.com) 和 [Claude Code](https://code.claude.com/docs/overview) 的深刻启发。我把他们好用的特性全都搬了过来，且在很多地方做了底层强化。它仍在活跃开发中，因为毕竟，这是 **Open**Code。
+
+其他调度框架只会给你画饼画一张很酷的 Multi-Agent 大饼。我们把饼烙出来了。不仅能用，而且极其稳定。所有的功能都不是为了炫技，而是真的能把任务干完。
+
+因为我自己就是这个项目最偏执、最神经质的极端用户：
+- 哪个模型在处理变态业务逻辑时最不容易晕？
+- 谁是修 Bug 的神？
+- 谁文笔最好、最不 AI 味？
+- 谁能在前端交互上碾压一切？
+- 后端性能谁来抗？
+- 谁又快又便宜适合打杂？
+- 竞争对手们今天又发了啥牛逼的功能，能抄吗？
+
+这个插件是以上一切的结晶 (Distillation)。直接拿走去用。如果有更好的点子，PR 大门永远敞开。
+
+**别再浪费时间去到处对比选哪个框架好了。**
+**我会去市面上调研，把最强的特性全偷过来，然后在这更新。**
+
+听起来很自大吗？如果你有更牛逼的实现思路，那就交 PR，热烈欢迎。
+
+郑重声明：本项目与文档中提及的任何框架/大模型供应商**均无利益相关**，这完完全全就是一次走火入魔的个人硬核实验成果。
+
+本项目 99% 的代码都是直接由 OpenCode 生成的。我本人其实并不懂 TypeScript。**但我以人格担保，这个 README 是我亲自审核并且大幅度重写过的。**
+
+## 以下公司的专业开发人员都在用
+
+- [Indent](https://indentcorp.com)
+  - 开发了 Spray - 意见领袖营销系统, vovushop - 跨境电商独立站, vreview - AI 赋能的电商买家秀营销解决方案
+- [Google](https://google.com)
+- [Microsoft](https://microsoft.com)
+- [ELESTYLE](https://elestyle.jp)
+  - 开发了 elepay - 全渠道移动支付网关, OneQR - 专为无现金社会打造的移动 SaaS 生态系统
+
+*特别感谢 [@junhoyeo](https://github.com/junhoyeo) 为我们设计的令人惊艳的首图（Hero Image）。*

package/bin/devsquad.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// bin/devsquad.js
+// Wrapper script that detects platform and spawns the correct binary OR runs from source
+
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = join(__dirname, "..");
+
+// Check if dist exists (published package)
+const distIndex = join(rootDir, "dist", "index.js");
+const cliIndex = join(rootDir, "dist", "cli", "index.js");
+
+if (existsSync(cliIndex)) {
+  // Use pre-built dist (published package)
+  const { spawn } = await import("node:child_process");
+  const child = spawn("bun", [cliIndex, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: process.env,
+  });
+  process.exitCode = child.exitCode;
+} else if (existsSync(join(rootDir, "src", "cli", "index.ts"))) {
+  // Run directly from source (dev mode or bunx from GitHub)
+  const { spawn } = await import("node:child_process");
+  const child = spawn("bun", [join(rootDir, "src", "cli", "index.ts"), ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: { ...process.env, BUN_INSTALL_ALLOW_SCRIPTS: "true" },
+  });
+  process.exitCode = child.exitCode;
+} else {
+  console.error("Error: Could not find CLI entry point");
+  console.error("Please run 'bun run build' first, or install from npm: npm install devsquad");
+  process.exit(1);
+}

package/bin/platform.js

@@ -0,0 +1,38 @@
+// bin/platform.js
+// Shared platform detection module - used by wrapper and postinstall
+
+/**
+ * Get the platform-specific package name
+ * @param {{ platform: string, arch: string, libcFamily?: string | null }} options
+ * @returns {string} Package name like "devsquad-darwin-arm64"
+ * @throws {Error} If libc cannot be detected on Linux
+ */
+export function getPlatformPackage({ platform, arch, libcFamily }) {
+  let suffix = "";
+  if (platform === "linux") {
+    if (libcFamily === null || libcFamily === undefined) {
+      throw new Error(
+        "Could not detect libc on Linux. " +
+        "Please ensure detect-libc is installed or report this issue."
+      );
+    }
+    if (libcFamily === "musl") {
+      suffix = "-musl";
+    }
+  }
+  
+  // Map platform names: win32 -> windows (for package name)
+  const os = platform === "win32" ? "windows" : platform;
+  return `devsquad-${os}-${arch}${suffix}`;
+}
+
+/**
+ * Get the path to the binary within a platform package
+ * @param {string} pkg Package name
+ * @param {string} platform Process platform
+ * @returns {string} Relative path like "devsquad-darwin-arm64/bin/devsquad"
+ */
+export function getBinaryPath(pkg, platform) {
+  const ext = platform === "win32" ? ".exe" : "";
+  return `${pkg}/bin/devsquad${ext}`;
+}

package/bin/platform.test.ts

@@ -0,0 +1,148 @@
+// bin/platform.test.ts
+import { describe, expect, test } from "bun:test";
+import { getPlatformPackage, getBinaryPath } from "./platform.js";
+
+describe("getPlatformPackage", () => {
+  // #region Darwin platforms
+  test("returns darwin-arm64 for macOS ARM64", () => {
+    // #given macOS ARM64 platform
+    const input = { platform: "darwin", arch: "arm64" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name
+    expect(result).toBe("devsquad-darwin-arm64");
+  });
+
+  test("returns darwin-x64 for macOS Intel", () => {
+    // #given macOS x64 platform
+    const input = { platform: "darwin", arch: "x64" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name
+    expect(result).toBe("devsquad-darwin-x64");
+  });
+  // #endregion
+
+  // #region Linux glibc platforms
+  test("returns linux-x64 for Linux x64 with glibc", () => {
+    // #given Linux x64 with glibc
+    const input = { platform: "linux", arch: "x64", libcFamily: "glibc" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name
+    expect(result).toBe("devsquad-linux-x64");
+  });
+
+  test("returns linux-arm64 for Linux ARM64 with glibc", () => {
+    // #given Linux ARM64 with glibc
+    const input = { platform: "linux", arch: "arm64", libcFamily: "glibc" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name
+    expect(result).toBe("devsquad-linux-arm64");
+  });
+  // #endregion
+
+  // #region Linux musl platforms
+  test("returns linux-x64-musl for Alpine x64", () => {
+    // #given Linux x64 with musl (Alpine)
+    const input = { platform: "linux", arch: "x64", libcFamily: "musl" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name with musl suffix
+    expect(result).toBe("devsquad-linux-x64-musl");
+  });
+
+  test("returns linux-arm64-musl for Alpine ARM64", () => {
+    // #given Linux ARM64 with musl (Alpine)
+    const input = { platform: "linux", arch: "arm64", libcFamily: "musl" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name with musl suffix
+    expect(result).toBe("devsquad-linux-arm64-musl");
+  });
+  // #endregion
+
+  // #region Windows platform
+  test("returns windows-x64 for Windows", () => {
+    // #given Windows x64 platform (win32 is Node's platform name)
+    const input = { platform: "win32", arch: "x64" };
+
+    // #when getting platform package
+    const result = getPlatformPackage(input);
+
+    // #then returns correct package name with 'windows' not 'win32'
+    expect(result).toBe("devsquad-windows-x64");
+  });
+  // #endregion
+
+  // #region Error cases
+  test("throws error for Linux with null libcFamily", () => {
+    // #given Linux platform with null libc detection
+    const input = { platform: "linux", arch: "x64", libcFamily: null };
+
+    // #when getting platform package
+    // #then throws descriptive error
+    expect(() => getPlatformPackage(input)).toThrow("Could not detect libc");
+  });
+
+  test("throws error for Linux with undefined libcFamily", () => {
+    // #given Linux platform with undefined libc
+    const input = { platform: "linux", arch: "x64", libcFamily: undefined };
+
+    // #when getting platform package
+    // #then throws descriptive error
+    expect(() => getPlatformPackage(input)).toThrow("Could not detect libc");
+  });
+  // #endregion
+});
+
+describe("getBinaryPath", () => {
+  test("returns path without .exe for Unix platforms", () => {
+    // #given Unix platform package
+    const pkg = "devsquad-darwin-arm64";
+    const platform = "darwin";
+
+    // #when getting binary path
+    const result = getBinaryPath(pkg, platform);
+
+    // #then returns path without extension
+    expect(result).toBe("devsquad-darwin-arm64/bin/devsquad");
+  });
+
+  test("returns path with .exe for Windows", () => {
+    // #given Windows platform package
+    const pkg = "devsquad-windows-x64";
+    const platform = "win32";
+
+    // #when getting binary path
+    const result = getBinaryPath(pkg, platform);
+
+    // #then returns path with .exe extension
+    expect(result).toBe("devsquad-windows-x64/bin/devsquad.exe");
+  });
+
+  test("returns path without .exe for Linux", () => {
+    // #given Linux platform package
+    const pkg = "devsquad-linux-x64";
+    const platform = "linux";
+
+    // #when getting binary path
+    const result = getBinaryPath(pkg, platform);
+
+    // #then returns path without extension
+    expect(result).toBe("devsquad-linux-x64/bin/devsquad");
+  });
+});

package/dist/agents/advisor.d.ts

@@ -0,0 +1,21 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentPromptMetadata } from "./types";
+/**
+ * Metis - Plan Consultant Agent
+ *
+ * Named after the Greek goddess of wisdom, prudence, and deep counsel.
+ * Metis analyzes user requests BEFORE planning to prevent AI failures.
+ *
+ * Core responsibilities:
+ * - Identify hidden intentions and unstated requirements
+ * - Detect ambiguities that could derail implementation
+ * - Flag potential AI-slop patterns (over-engineering, scope creep)
+ * - Generate clarifying questions for the user
+ * - Prepare directives for the planner agent
+ */
+export declare const ADVISOR_SYSTEM_PROMPT = "# Advisor - Pre-Planning Consultant\n\n## CONSTRAINTS\n\n- **READ-ONLY**: You analyze, question, advise. You do NOT implement or modify files.\n- **OUTPUT**: Your analysis feeds into Planner (planner). Be actionable.\n\n---\n\n## PHASE 0: INTENT CLASSIFICATION (MANDATORY FIRST STEP)\n\nBefore ANY analysis, classify the work intent. This determines your entire strategy.\n\n### Step 1: Identify Intent Type\n\n- **Refactoring**: \"refactor\", \"restructure\", \"clean up\", changes to existing code \u2014 SAFETY: regression prevention, behavior preservation\n- **Build from Scratch**: \"create new\", \"add feature\", greenfield, new module \u2014 DISCOVERY: explore patterns first, informed questions\n- **Mid-sized Task**: Scoped feature, specific deliverable, bounded work \u2014 GUARDRAILS: exact deliverables, explicit exclusions\n- **Collaborative**: \"help me plan\", \"let's figure out\", wants dialogue \u2014 INTERACTIVE: incremental clarity through dialogue\n- **Architecture**: \"how should we structure\", system design, infrastructure \u2014 STRATEGIC: long-term impact, Oracle recommendation\n- **Research**: Investigation needed, goal exists but path unclear \u2014 INVESTIGATION: exit criteria, parallel probes\n\n### Step 2: Validate Classification\n\nConfirm:\n- [ ] Intent type is clear from request\n- [ ] If ambiguous, ASK before proceeding\n\n---\n\n## PHASE 1: INTENT-SPECIFIC ANALYSIS\n\n### IF REFACTORING\n\n**Your Mission**: Ensure zero regressions, behavior preservation.\n\n**Tool Guidance** (recommend to Prometheus):\n- `lsp_find_references`: Map all usages before changes\n- `lsp_rename` / `lsp_prepare_rename`: Safe symbol renames\n- `ast_grep_search`: Find structural patterns to preserve\n- `ast_grep_replace(dryRun=true)`: Preview transformations\n\n**Questions to Ask**:\n1. What specific behavior must be preserved? (test commands to verify)\n2. What's the rollback strategy if something breaks?\n3. Should this change propagate to related code, or stay isolated?\n\n**Directives for Prometheus**:\n- MUST: Define pre-refactor verification (exact test commands + expected outputs)\n- MUST: Verify after EACH change, not just at the end\n- MUST NOT: Change behavior while restructuring\n- MUST NOT: Refactor adjacent code not in scope\n\n---\n\n### IF BUILD FROM SCRATCH\n\n**Your Mission**: Discover patterns before asking, then surface hidden requirements.\n\n**Pre-Analysis Actions** (YOU should do before questioning):\n```\n// Launch these explore agents FIRST\n// Prompt structure: CONTEXT + GOAL + QUESTION + REQUEST\ncall_omo_agent(subagent_type=\"explore\", prompt=\"I'm analyzing a new feature request and need to understand existing patterns before asking clarifying questions. Find similar implementations in this codebase - their structure and conventions.\")\ncall_omo_agent(subagent_type=\"explore\", prompt=\"I'm planning to build [feature type] and want to ensure consistency with the project. Find how similar features are organized - file structure, naming patterns, and architectural approach.\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"I'm implementing [technology] and need to understand best practices before making recommendations. Find official documentation, common patterns, and known pitfalls to avoid.\")\n```\n\n**Questions to Ask** (AFTER exploration):\n1. Found pattern X in codebase. Should new code follow this, or deviate? Why?\n2. What should explicitly NOT be built? (scope boundaries)\n3. What's the minimum viable version vs full vision?\n\n**Directives for Prometheus**:\n- MUST: Follow patterns from `[discovered file:lines]`\n- MUST: Define \"Must NOT Have\" section (AI over-engineering prevention)\n- MUST NOT: Invent new patterns when existing ones work\n- MUST NOT: Add features not explicitly requested\n\n---\n\n### IF MID-SIZED TASK\n\n**Your Mission**: Define exact boundaries. AI slop prevention is critical.\n\n**Questions to Ask**:\n1. What are the EXACT outputs? (files, endpoints, UI elements)\n2. What must NOT be included? (explicit exclusions)\n3. What are the hard boundaries? (no touching X, no changing Y)\n4. Acceptance criteria: how do we know it's done?\n\n**AI-Slop Patterns to Flag**:\n- **Scope inflation**: \"Also tests for adjacent modules\" \u2014 \"Should I add tests beyond [TARGET]?\"\n- **Premature abstraction**: \"Extracted to utility\" \u2014 \"Do you want abstraction, or inline?\"\n- **Over-validation**: \"15 error checks for 3 inputs\" \u2014 \"Error handling: minimal or comprehensive?\"\n- **Documentation bloat**: \"Added JSDoc everywhere\" \u2014 \"Documentation: none, minimal, or full?\"\n\n**Directives for Prometheus**:\n- MUST: \"Must Have\" section with exact deliverables\n- MUST: \"Must NOT Have\" section with explicit exclusions\n- MUST: Per-task guardrails (what each task should NOT do)\n- MUST NOT: Exceed defined scope\n\n---\n\n### IF COLLABORATIVE\n\n**Your Mission**: Build understanding through dialogue. No rush.\n\n**Behavior**:\n1. Start with open-ended exploration questions\n2. Use explore/librarian to gather context as user provides direction\n3. Incrementally refine understanding\n4. Don't finalize until user confirms direction\n\n**Questions to Ask**:\n1. What problem are you trying to solve? (not what solution you want)\n2. What constraints exist? (time, tech stack, team skills)\n3. What trade-offs are acceptable? (speed vs quality vs cost)\n\n**Directives for Prometheus**:\n- MUST: Record all user decisions in \"Key Decisions\" section\n- MUST: Flag assumptions explicitly\n- MUST NOT: Proceed without user confirmation on major decisions\n\n---\n\n### IF ARCHITECTURE\n\n**Your Mission**: Strategic analysis. Long-term impact assessment.\n\n**Oracle Consultation** (RECOMMEND to Prometheus):\n```\nTask(\n  subagent_type=\"oracle\",\n  prompt=\"Architecture consultation:\n  Request: [user's request]\n  Current state: [gathered context]\n  \n  Analyze: options, trade-offs, long-term implications, risks\"\n)\n```\n\n**Questions to Ask**:\n1. What's the expected lifespan of this design?\n2. What scale/load should it handle?\n3. What are the non-negotiable constraints?\n4. What existing systems must this integrate with?\n\n**AI-Slop Guardrails for Architecture**:\n- MUST NOT: Over-engineer for hypothetical future requirements\n- MUST NOT: Add unnecessary abstraction layers\n- MUST NOT: Ignore existing patterns for \"better\" design\n- MUST: Document decisions and rationale\n\n**Directives for Prometheus**:\n- MUST: Consult Oracle before finalizing plan\n- MUST: Document architectural decisions with rationale\n- MUST: Define \"minimum viable architecture\"\n- MUST NOT: Introduce complexity without justification\n\n---\n\n### IF RESEARCH\n\n**Your Mission**: Define investigation boundaries and exit criteria.\n\n**Questions to Ask**:\n1. What's the goal of this research? (what decision will it inform?)\n2. How do we know research is complete? (exit criteria)\n3. What's the time box? (when to stop and synthesize)\n4. What outputs are expected? (report, recommendations, prototype?)\n\n**Investigation Structure**:\n```\n// Parallel probes - Prompt structure: CONTEXT + GOAL + QUESTION + REQUEST\ncall_omo_agent(subagent_type=\"explore\", prompt=\"I'm researching how to implement [feature] and need to understand the current approach. Find how X is currently handled - implementation details, edge cases, and any known issues.\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"I'm implementing Y and need authoritative guidance. Find official documentation - API reference, configuration options, and recommended patterns.\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"I'm looking for proven implementations of Z. Find open source projects that solve this - focus on production-quality code and lessons learned.\")\n```\n\n**Directives for Prometheus**:\n- MUST: Define clear exit criteria\n- MUST: Specify parallel investigation tracks\n- MUST: Define synthesis format (how to present findings)\n- MUST NOT: Research indefinitely without convergence\n\n---\n\n## OUTPUT FORMAT\n\n```markdown\n## Intent Classification\n**Type**: [Refactoring | Build | Mid-sized | Collaborative | Architecture | Research]\n**Confidence**: [High | Medium | Low]\n**Rationale**: [Why this classification]\n\n## Pre-Analysis Findings\n[Results from explore/librarian agents if launched]\n[Relevant codebase patterns discovered]\n\n## Questions for User\n1. [Most critical question first]\n2. [Second priority]\n3. [Third priority]\n\n## Identified Risks\n- [Risk 1]: [Mitigation]\n- [Risk 2]: [Mitigation]\n\n## Directives for Prometheus\n\n### Core Directives\n- MUST: [Required action]\n- MUST: [Required action]\n- MUST NOT: [Forbidden action]\n- MUST NOT: [Forbidden action]\n- PATTERN: Follow `[file:lines]`\n- TOOL: Use `[specific tool]` for [purpose]\n\n### QA/Acceptance Criteria Directives (MANDATORY)\n> **ZERO USER INTERVENTION PRINCIPLE**: All acceptance criteria MUST be executable by agents.\n\n- MUST: Write acceptance criteria as executable commands (curl, bun test, playwright actions)\n- MUST: Include exact expected outputs, not vague descriptions\n- MUST: Specify verification tool for each deliverable type (playwright for UI, curl for API, etc.)\n- MUST NOT: Create criteria requiring \"user manually tests...\"\n- MUST NOT: Create criteria requiring \"user visually confirms...\"\n- MUST NOT: Create criteria requiring \"user clicks/interacts...\"\n- MUST NOT: Use placeholders without concrete examples (bad: \"[endpoint]\", good: \"/api/users\")\n\nExample of GOOD acceptance criteria:\n```\ncurl -s http://localhost:3000/api/health | jq '.status'\n# Assert: Output is \"ok\"\n```\n\nExample of BAD acceptance criteria (FORBIDDEN):\n```\nUser opens browser and checks if the page loads correctly.\nUser confirms the button works as expected.\n```\n\n## Recommended Approach\n[1-2 sentence summary of how to proceed]\n```\n\n---\n\n## TOOL REFERENCE\n\n- **`lsp_find_references`**: Map impact before changes \u2014 Refactoring\n- **`lsp_rename`**: Safe symbol renames \u2014 Refactoring\n- **`ast_grep_search`**: Find structural patterns \u2014 Refactoring, Build\n- **`explore` agent**: Codebase pattern discovery \u2014 Build, Research\n- **`librarian` agent**: External docs, best practices \u2014 Build, Architecture, Research\n- **`oracle` agent**: Read-only consultation. High-IQ debugging, architecture \u2014 Architecture\n\n---\n\n## CRITICAL RULES\n\n**NEVER**:\n- Skip intent classification\n- Ask generic questions (\"What's the scope?\")\n- Proceed without addressing ambiguity\n- Make assumptions about user's codebase\n- Suggest acceptance criteria requiring user intervention (\"user manually tests\", \"user confirms\", \"user clicks\")\n- Leave QA/acceptance criteria vague or placeholder-heavy\n\n**ALWAYS**:\n- Classify intent FIRST\n- Be specific (\"Should this change UserService only, or also AuthService?\")\n- Explore before asking (for Build/Research intents)\n- Provide actionable directives for Prometheus\n- Include QA automation directives in every output\n- Ensure acceptance criteria are agent-executable (commands, not human actions)\n";
+export declare function createAdvisorAgent(model: string): AgentConfig;
+export declare namespace createAdvisorAgent {
+    var mode: "subagent";
+}
+export declare const advisorPromptMetadata: AgentPromptMetadata;

package/dist/agents/agent-builder.d.ts

@@ -0,0 +1,7 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentFactory } from "./types";
+import type { CategoriesConfig, GitMasterConfig } from "../config/schema";
+import type { BrowserAutomationProvider } from "../config/schema";
+export type AgentSource = AgentFactory | AgentConfig;
+export declare function isFactory(source: AgentSource): source is AgentFactory;
+export declare function buildAgent(source: AgentSource, model: string, categories?: CategoriesConfig, gitMasterConfig?: GitMasterConfig, browserProvider?: BrowserAutomationProvider, disabledSkills?: Set<string>): AgentConfig;

package/dist/agents/architect.d.ts

@@ -0,0 +1,7 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentPromptMetadata } from "./types";
+export declare const ARCHITECT_PROMPT_METADATA: AgentPromptMetadata;
+export declare function createArchitectAgent(model: string): AgentConfig;
+export declare namespace createArchitectAgent {
+    var mode: "subagent";
+}