delegate-team 2.1.0 โ 2.2.0
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.
- package/README.md +263 -290
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,385 +1,358 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
# ๐ ๏ธ delegate-team
|
|
6
4
|
|
|
7
|
-
|
|
8
|
-
> Three routing layers. One `/mavis-ship` command that orchestrates them all.
|
|
5
|
+
### *One command runs the full engineering chain.*
|
|
9
6
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
| **`dt` CLI** (gateway) | `src/`, `dist/` | Routes Claude Code tasks to backend agents | `npm install && npm run build` |
|
|
13
|
-
| **`/mavis-ship` orchestrator** | `orchestrator/` | Single command that drives every stage of a task | `./install.sh --orchestrator` |
|
|
14
|
-
| **Skill scaffolder** | `scaffolder/` | Generate Mavis skills with proper structure | `./install.sh --scaffolder` |
|
|
15
|
-
| **Multi-agent team (MMAS)** | `mmas/` | Boss mode: spawn Atlas + Forge + Scout + 5 more specialized agents | `./install.sh --mmas` |
|
|
16
|
-
| **Companion frameworks** | `integrations/` | superpowers, Waza, unslop-preflight, autoresearch | `./install.sh --integrations` |
|
|
17
|
-
|
|
18
|
-
**One-command setup** (everything):
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
git clone https://github.com/imMamdouhaboammar/delegate-team
|
|
22
|
-
cd delegate-team
|
|
23
|
-
./install.sh --all
|
|
7
|
+
```text
|
|
8
|
+
/mavis-ship "Make API p95 < 200ms"
|
|
24
9
|
```
|
|
25
10
|
|
|
26
|
-
|
|
11
|
+
**Waza `/think` โ unslop audit โ superpowers writing-plans โ**
|
|
12
|
+
**autoresearch | `/delegate-team` | `/mavis-team` โ Waza `/check` โ quality-guard โ SHIP**
|
|
27
13
|
|
|
28
|
-
|
|
14
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/releases)
|
|
15
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/blob/master/LICENSE)
|
|
16
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/stargazers)
|
|
17
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/actions/workflows/ci.yml)
|
|
18
|
+
[](https://skills.sh/imMamdouhaboammar/delegate-team)
|
|
19
|
+
[](https://nodejs.org)
|
|
20
|
+
[](https://python.org)
|
|
21
|
+
[](https://www.gnu.org/software/bash/)
|
|
29
22
|
|
|
30
|
-
|
|
23
|
+
</div>
|
|
31
24
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
- [`INSTALL.md`](./INSTALL.md) โ full install guide
|
|
38
|
-
- [`CHANGELOG.md`](./CHANGELOG.md) โ release notes
|
|
25
|
+
> **The complete agentic engineering supersystem.** One open-source repo. Six
|
|
26
|
+
> components. Four routing layers. One **(`/mavis-ship "<task>")** command that
|
|
27
|
+
> orchestrates them all. Built on top of superpowers, Waza, unslop-preflight,
|
|
28
|
+
> and autoresearch. Designed to work with Claude Code, Codex, Cursor, Copilot,
|
|
29
|
+
> Windsurf, Gemini CLI, OpenCode, and 60+ more coding agents via Skills.sh.
|
|
39
30
|
|
|
40
31
|
---
|
|
41
32
|
|
|
42
|
-
## What
|
|
33
|
+
## โก What is this?
|
|
43
34
|
|
|
44
|
-
|
|
35
|
+
**delegate-team** is the bridge between a natural-language request and a
|
|
36
|
+
multi-model, multi-stage engineering pipeline. Instead of picking tools by hand,
|
|
37
|
+
type one command and let the supersystem decide:
|
|
45
38
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
39
|
+
| Without delegate-team | With delegate-team |
|
|
40
|
+
|---|---|
|
|
41
|
+
| Pick a model โ craft a prompt โ wait โ review โ fix the prompt โ repeat | `/mavis-ship "X"` and watch the chain run |
|
|
42
|
+
| Architect **or** implement **or** review per turn | Brainstorm โ plan โ TDD โ execute โ verify โ ship |
|
|
43
|
+
| Each agent works alone | 8 specialized agents (Atlas / Forge / Scout / Oracle / Librarian / Reviewer / Visionary / Sentinel) collaborate |
|
|
44
|
+
| "Best practice" depends on which LLM answered | Methodology encoded as skills: superpowers ยท Waza ยท unslop-preflight ยท autoresearch |
|
|
50
45
|
|
|
51
|
-
|
|
46
|
+
**Sounds good? Try it:**
|
|
52
47
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
-
|
|
56
|
-
|
|
48
|
+
```bash
|
|
49
|
+
git clone https://github.com/imMamdouhaboammar/delegate-team
|
|
50
|
+
cd delegate-team
|
|
51
|
+
./install.sh --all
|
|
52
|
+
./install.sh --verify # sanity check
|
|
53
|
+
```
|
|
57
54
|
|
|
58
|
-
|
|
55
|
+
---
|
|
59
56
|
|
|
60
|
-
|
|
61
|
-
|---|---|
|
|
62
|
-
| **Failover Ring** | `dt` attempts best-effort fallback across configured backends. If another backend is available, `dt` can retry the task automatically. |
|
|
63
|
-
| **Lean Token Protocol** | A targeted, compact contract. The routing engine minimizes file ingestion size, feeding only the context that actually matters. |
|
|
64
|
-
| **Autopilot Setup** | `dt setup` creates local Python virtual environments and checks cloud credentials. |
|
|
65
|
-
| **Dynamic Auth** | Zero hardcoded keys. `dt` queries your active local sessions and safely stores configurations locally. |
|
|
66
|
-
| **Skill Linker** | Instantly injects `dt`'s orchestrators directly into local Claude Code and Gemini CLI paths. |
|
|
57
|
+
## ๐ฆ Quick install
|
|
67
58
|
|
|
68
|
-
|
|
59
|
+
**Three installation paths. Pick your favorite.**
|
|
69
60
|
|
|
70
|
-
|
|
61
|
+
### Path A โ Skills.sh CLI (skill discovery + global install)
|
|
71
62
|
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
โ
|
|
75
|
-
Claude Code
|
|
76
|
-
โ brief / review
|
|
77
|
-
dt Policy Gateway
|
|
78
|
-
โ route
|
|
79
|
-
Single backend OR Team mode
|
|
80
|
-
โ
|
|
81
|
-
VertexCoder / Codex / MiniMax / OpenCode / Gemini
|
|
82
|
-
โ
|
|
83
|
-
result contract
|
|
84
|
-
โ
|
|
85
|
-
Claude Code review
|
|
86
|
-
โ
|
|
87
|
-
human-approved commit
|
|
63
|
+
```bash
|
|
64
|
+
npx skills add imMamdouhaboammar/delegate-team -a claude-code -g -y
|
|
88
65
|
```
|
|
89
66
|
|
|
90
|
-
-
|
|
91
|
-
|
|
92
|
-
|
|
67
|
+
This installs all 8 sub-skills to your Claude Code (or any of 68 supported agents)
|
|
68
|
+
and makes `delegate-team`, `mavis-ship`, `mmas`, `skill-scaffold`, `dt`, etc.
|
|
69
|
+
all invocable by name.
|
|
93
70
|
|
|
94
|
-
|
|
71
|
+
### Path B โ Claude Code marketplace (native plugin install)
|
|
95
72
|
|
|
96
|
-
|
|
97
|
-
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
- Optional: provider credentials for configured backends
|
|
73
|
+
```bash
|
|
74
|
+
/plugin marketplace add imMamdouhaboammar/delegate-team
|
|
75
|
+
/plugin install delegate-team@delegate-team
|
|
76
|
+
```
|
|
101
77
|
|
|
102
|
-
|
|
78
|
+
### Path C โ Bootstrap script (everything, including companion frameworks)
|
|
103
79
|
|
|
104
80
|
```bash
|
|
105
|
-
|
|
106
|
-
git clone https://github.com/imMamdouhaboammar/delegate-team.git
|
|
81
|
+
git clone https://github.com/imMamdouhaboammar/delegate-team
|
|
107
82
|
cd delegate-team
|
|
83
|
+
./install.sh --all # everything
|
|
84
|
+
./install.sh --orchestrator # just /mavis-ship
|
|
85
|
+
./install.sh --mmas # just the multi-agent framework
|
|
86
|
+
./install.sh --integrations # just companion frameworks
|
|
87
|
+
./install.sh --verify # check what's installed
|
|
88
|
+
```
|
|
108
89
|
|
|
109
|
-
|
|
110
|
-
npm install
|
|
111
|
-
npm run build
|
|
112
|
-
|
|
113
|
-
# Link the package globally
|
|
114
|
-
npm link
|
|
90
|
+
After install, every component is idempotent and verifiable.
|
|
115
91
|
|
|
116
|
-
|
|
117
|
-
dt --help
|
|
118
|
-
dt check
|
|
119
|
-
```
|
|
92
|
+
---
|
|
120
93
|
|
|
121
|
-
##
|
|
94
|
+
## ๐งฉ Components
|
|
122
95
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
dt
|
|
96
|
+
| Component | Path | Language | Status | What it does |
|
|
97
|
+
|---|---|---|---|---|
|
|
98
|
+
| **dt CLI** | [`src/`](./src), [`dist/`](./dist) |  |  | Delegation gateway with policy + failover + MetaGPT teams |
|
|
99
|
+
| **`/mavis-ship`** | [`orchestrator/`](./orchestrator/) |  |  | Single-command orchestrator with regex routing |
|
|
100
|
+
| **Skill scaffolder** | [`scaffolder/`](./scaffolder/) |  |  | `mavis-skill-scaffold` generator |
|
|
101
|
+
| **MMAS** | [`mmas/`](./mmas/) |  |  | 8-agent multi-agent team framework |
|
|
102
|
+
| **God Agent** | [`god-agent/`](./god-agent/) |  |  | Codex + opencode dispatcher |
|
|
103
|
+
| **MiniMax Coder** | [`minimax-coder/`](./minimax-coder/) |  |  | MiniMax via `mmx` CLI |
|
|
104
|
+
| **Vertex Coder** | [`vertex-coder/`](./vertex-coder/) |  |  | Gemini via google-genai |
|
|
105
|
+
| **MetaGPT team** | [`metagpt/`](./metagpt/) |  |  | Multi-role team runner |
|
|
126
106
|
|
|
127
|
-
|
|
128
|
-
dt check --strict
|
|
107
|
+
### Companion frameworks (separate install, see [`integrations/`](./integrations/))
|
|
129
108
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
109
|
+
| Framework | Stars | What it adds |
|
|
110
|
+
|---|---|---|
|
|
111
|
+
| [superpowers](https://github.com/obra/superpowers) |  | Methodology โ 14 skills, brainstorm-first hard gate |
|
|
112
|
+
| [Waza](https://github.com/tw93/Waza) |  | Entry-point โ 8 habits-engineering skills |
|
|
113
|
+
| [unslop-preflight](https://github.com/imMamdouhaboammar/unslop-preflight) |  | UI quality gate โ 23 reasoning gates |
|
|
114
|
+
| [autoresearch](https://github.com/uditgoenka/autoresearch) |  | Metric-driven iteration loop |
|
|
133
115
|
|
|
134
|
-
|
|
116
|
+
---
|
|
135
117
|
|
|
136
|
-
##
|
|
118
|
+
## ๐ The /mavis-ship chain (how it works)
|
|
137
119
|
|
|
138
|
-
|
|
120
|
+
Type one command. The orchestrator inspects the task and routes through the
|
|
121
|
+
right stages.
|
|
139
122
|
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
123
|
+
```text
|
|
124
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
125
|
+
โ /mavis-ship "<your task>" โ
|
|
126
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
127
|
+
โ
|
|
128
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
129
|
+
โ Waza /think โ pressure-test + design
|
|
130
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ (NEVER skip โ hard gate)
|
|
131
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
132
|
+
โ
|
|
133
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
134
|
+
โ unslop audit (BLOCKING) โ score โฅ70 to proceed
|
|
135
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ for UI tasks only
|
|
136
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
137
|
+
โ
|
|
138
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
139
|
+
โ superpowers writing-plans โ plan with checkpoints
|
|
140
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
141
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
142
|
+
โ
|
|
143
|
+
โโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโ
|
|
144
|
+
โ โ โ
|
|
145
|
+
โโโโโผโโโโโโโโโโโ โโโโโโโโผโโโโโโโ โโโโโโโโโโโโผโโโโโโโโโ
|
|
146
|
+
โ autoresearch โ โ /delegate- โ โ /mavis-team โ
|
|
147
|
+
โ plan + loop โ โ team โ โ MMAS (Atlas+) โ
|
|
148
|
+
โ metric-drivenโ โ multi-modelโ โ parallel agents โ
|
|
149
|
+
โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโ โโโโโโโโโโฌโโโโโโโโโโโ
|
|
150
|
+
โ โ โ
|
|
151
|
+
โโโโผโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโ
|
|
152
|
+
โ Waza /check โ quality-guard (Mavis) โ SHIP โ
|
|
153
|
+
โ review + 5-layer pre-delivery check โ
|
|
154
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
152
155
|
```
|
|
153
156
|
|
|
154
|
-
|
|
155
|
-
Modify or create a single file:
|
|
156
|
-
```bash
|
|
157
|
-
dt vx direct index.html "Update the hero title to a premium dark gradient design"
|
|
158
|
-
```
|
|
157
|
+
**Routing logic** (live in [`orchestrator/scripts/orchestrate.sh`](./orchestrator/scripts/orchestrate.sh)):
|
|
159
158
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
159
|
+
| Task signature | Route |
|
|
160
|
+
|---|---|
|
|
161
|
+
| Has measurable metric (e.g. "p95 < 200ms") | autoresearch loop |
|
|
162
|
+
| UI task (frontend, page, modal, shadcn) | unslop BLOCKING โ /delegate-team |
|
|
163
|
+
| Multi-agent signals (squad, spawn team, swarm) | /mavis-team MMAS |
|
|
164
|
+
| Bug / broken / failing | systematic-debugging โ /delegate-team |
|
|
165
|
+
| Heavy multi-file / refactor / migrate | /delegate-team |
|
|
166
|
+
| Research / understand / learn | Waza /read + /learn |
|
|
167
|
+
| Trivial (rename, bump) | handle locally, skip chain |
|
|
165
168
|
|
|
166
|
-
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## ๐ Usage
|
|
167
172
|
|
|
168
|
-
|
|
173
|
+
### Slash command (in any Claude Code session)
|
|
169
174
|
|
|
170
175
|
```bash
|
|
171
|
-
|
|
176
|
+
/mavis-ship "Build a CLI to convert CSV to JSON"
|
|
177
|
+
/mavis-ship "The mobile header is rendering wrong on Safari iOS 17"
|
|
178
|
+
/mavis-ship "Make API p95 < 200ms"
|
|
179
|
+
/mavis-ship "Design the auth flow before I implement it"
|
|
172
180
|
```
|
|
173
181
|
|
|
174
|
-
|
|
175
|
-
- ready
|
|
176
|
-
- missing credentials
|
|
177
|
-
- missing binary
|
|
178
|
-
- not configured
|
|
179
|
-
|
|
180
|
-
If a backend shows missing credentials/binary, see
|
|
181
|
-
[AGENT_ACCESS_GUIDE.md](./AGENT_ACCESS_GUIDE.md) โ the controlling agent should walk
|
|
182
|
-
the user through granting access (Codex, MiniMax, GLM, OpenCode, OpenRouter, Gemini,
|
|
183
|
-
Vertex AI) rather than silently skipping the backend.
|
|
182
|
+
### CLI router (shell โ returns routing decision without execution)
|
|
184
183
|
|
|
185
|
-
|
|
184
|
+
```bash
|
|
185
|
+
mavis-orchestrate "Build a landing page with shadcn components"
|
|
186
|
+
```
|
|
186
187
|
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
-
|
|
190
|
-
- File tools are restricted to the workspace
|
|
191
|
-
- Dependency installation is blocked unless explicitly enabled
|
|
192
|
-
- The local proxy binds to `127.0.0.1` and requires a token
|
|
193
|
-
- Do not expose `dt serve` to a public network
|
|
188
|
+
Output:
|
|
189
|
+
```
|
|
190
|
+
# /mavis-ship route for: "Build a landing page with shadcn components"
|
|
194
191
|
|
|
195
|
-
|
|
192
|
+
Stages (descending score):
|
|
193
|
+
โข unslop audit (UI gate) (score=3)
|
|
194
|
+
โข /think (Waza) (score=2)
|
|
195
|
+
โข /delegate-team (multi-model) (score=1)
|
|
196
|
+
โข /check (Waza) (score=2)
|
|
197
|
+
โข quality-guard (Mavis) (score=2)
|
|
196
198
|
|
|
197
|
-
|
|
199
|
+
# Verdict:
|
|
200
|
+
UI DELIVERY path โ unslop audit is BLOCKING before /delegate-team.
|
|
201
|
+
```
|
|
198
202
|
|
|
199
|
-
|
|
203
|
+
### dt CLI (low-level delegation)
|
|
200
204
|
|
|
201
|
-
When the task is monumental, summon an entire company. While `dt run` focuses on execution, `dt metagpt` spins up an Architect, Product Manager, Engineer, and QA.
|
|
202
205
|
```bash
|
|
203
|
-
dt
|
|
206
|
+
dt run "Refactor the user model for multi-tenancy"
|
|
207
|
+
dt run "<task>" --backend minimax-coder # force a specific backend
|
|
208
|
+
dt run "<task>" --team # MetaGPT-style multi-role
|
|
209
|
+
dt setup # first-time setup
|
|
210
|
+
dt doctor # health check
|
|
204
211
|
```
|
|
205
212
|
|
|
206
|
-
|
|
207
|
-
- `--plan-only`: Draft the architecture without writing code.
|
|
208
|
-
- `--approve-write`: Require your final human seal of approval before writing to disk.
|
|
209
|
-
- `--workspace-only`: Sandbox the team strictly to the current workspace root.
|
|
210
|
-
- `--no-install`: Forbid the installation of package dependencies.
|
|
211
|
-
- `--dry-run`: Simulate the entire workflow safely.
|
|
212
|
-
|
|
213
|
-
## Local proxy
|
|
213
|
+
### Multi-agent team (MMAS โ boss mode)
|
|
214
214
|
|
|
215
|
-
Start a local LLM Gateway Proxy server on port `3000` to connect tools directly to `dt`:
|
|
216
215
|
```bash
|
|
217
|
-
|
|
216
|
+
python3 ~/.mavis/agents/mavis/multi-agent/spawn-team.py --atlas
|
|
217
|
+
# Atlas autonomously picks team composition based on the task signature
|
|
218
218
|
```
|
|
219
219
|
|
|
220
|
-
|
|
221
|
-
You can connect LobeChat to the local `dt` proxy for a browser-based chat interface.
|
|
222
|
-
|
|
223
|
-
1. Start the `dt` proxy server:
|
|
224
|
-
```bash
|
|
225
|
-
dt serve 3000
|
|
226
|
-
```
|
|
227
|
-
2. Open `~/.config/dt/config.json`, copy `proxy_token`, and use it as `OPENAI_API_KEY`.
|
|
228
|
-
3. Launch the LobeChat Docker container, pointing its API URL to your local `dt` instance:
|
|
229
|
-
```bash
|
|
230
|
-
docker run -d -p 3210:3210 \
|
|
231
|
-
-e OPENAI_API_KEY="<your-dt-proxy-token>" \
|
|
232
|
-
-e PROXY_TOKEN="<your-dt-proxy-token>" \
|
|
233
|
-
-e OPENAI_PROXY_URL=http://host.docker.internal:3000/v1 \
|
|
234
|
-
-e ACCESS_CODE= \
|
|
235
|
-
--name lobe-chat \
|
|
236
|
-
lobehub/lobe-chat
|
|
237
|
-
```
|
|
238
|
-
4. Journey to `http://localhost:3210` in your browser.
|
|
239
|
-
|
|
240
|
-
## Claude Code / Agent Operating Guide
|
|
241
|
-
|
|
242
|
-
The notes below describe how Claude Code, Cursor, Gemini CLI, or another coding agent should use `dt` safely. They are project operating guidance, not a system prompt, not an instruction override, and not a request to bypass the user's approval.
|
|
220
|
+
---
|
|
243
221
|
|
|
244
|
-
|
|
222
|
+
## ๐๏ธ Architecture
|
|
245
223
|
|
|
246
|
-
|
|
224
|
+
```
|
|
225
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
226
|
+
โ USER TASK (natural lang) โ
|
|
227
|
+
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
|
|
228
|
+
โ
|
|
229
|
+
โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโ
|
|
230
|
+
โ /mavis-ship orchestrator โ
|
|
231
|
+
โ (orchestrator/SKILL.md) โ
|
|
232
|
+
โโโโโโโฌโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโ
|
|
233
|
+
โ โ
|
|
234
|
+
โโโโโโโโโโโโโผโโโ โโโโโโโโโผโโโโโโโโโโ
|
|
235
|
+
โ Methodology โ โ Execution โ
|
|
236
|
+
โ โโโโโโโโโโโ โ โ โโโโโโโโโโโโ โ
|
|
237
|
+
โ Waza โ โ /delegate-team โ
|
|
238
|
+
โ superpowers โ โ /mavis-team โ
|
|
239
|
+
โ unslop โ โ autoresearch โ
|
|
240
|
+
โ โ โ (each routes โ
|
|
241
|
+
โ โ โ to a back- โ
|
|
242
|
+
โ โ โ end agent) โ
|
|
243
|
+
โโโโโโโโโโโโโโโโ โโโโโโโโโโโฌโโโโโโโโ
|
|
244
|
+
โ
|
|
245
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโ
|
|
246
|
+
โ โ โ
|
|
247
|
+
โโโโโโโโผโโโโโโโ โโโโโโโโโผโโโโโโ โโโโโโโโผโโโโโโโ
|
|
248
|
+
โ God Agent โ โ MiniMax โ โ Vertex โ
|
|
249
|
+
โ codex / โ โ Coder โ โ Coder โ
|
|
250
|
+
โ opencode โ โ mmx CLI โ โ Gemini โ
|
|
251
|
+
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
|
|
252
|
+
|
|
253
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
254
|
+
โ VERIFICATION (Waza /check) โ
|
|
255
|
+
โ + quality-guard 5-layer check โ
|
|
256
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
257
|
+
```
|
|
247
258
|
|
|
248
|
-
|
|
259
|
+
---
|
|
249
260
|
|
|
250
|
-
|
|
261
|
+
## โ Why not just use...?
|
|
251
262
|
|
|
252
|
-
|
|
263
|
+
| Comparison | Use this when |
|
|
264
|
+
|---|---|
|
|
265
|
+
| `autoresearch` alone | You have ONE measurable metric + bounded scope. Skip the planning. |
|
|
266
|
+
| `/delegate-team` alone | You know which model + backend you want. Skip orchestration. |
|
|
267
|
+
| `/mavis-team` alone | You want a specific team composition. Skip auto-picking. |
|
|
268
|
+
| LLM directly (no agents) | Trivial edits. Use `:edit` mode. |
|
|
269
|
+
| **`delegate-team` / `/mavis-ship`** | Anything else. Let the orchestrator decide. |
|
|
253
270
|
|
|
254
|
-
|
|
271
|
+
---
|
|
255
272
|
|
|
256
|
-
|
|
257
|
-
dt --help
|
|
258
|
-
```
|
|
273
|
+
## ๐ Documentation
|
|
259
274
|
|
|
260
|
-
|
|
275
|
+
| Doc | What's inside |
|
|
276
|
+
|---|---|
|
|
277
|
+
| [`INSTALL.md`](./INSTALL.md) | Full installation guide + verification matrix |
|
|
278
|
+
| [`CHANGELOG.md`](./CHANGELOG.md) | v1 โ v2 โ v2.1 release notes |
|
|
279
|
+
| [`DT.md`](./DT.md) | Original `dt` CLI specifics (gateway internals) |
|
|
280
|
+
| [`orchestrator/README.md`](./orchestrator/README.md) | `/mavis-ship` details |
|
|
281
|
+
| [`scaffolder/README.md`](./scaffolder/README.md) | `mavis-skill-scaffold` reference |
|
|
282
|
+
| [`mmas/README.md`](./mmas/README.md) | Multi-agent team framework |
|
|
283
|
+
| [`integrations/README.md`](./integrations/README.md) | Companion frameworks overview |
|
|
284
|
+
| [`AGENTS.md`](./AGENTS.md) | Repo conventions for contributors |
|
|
285
|
+
| [`CLAUDE.md`](./CLAUDE.md) | Claude-Code-specific guidance |
|
|
286
|
+
| [`DELEGATION_PROTOCOL.md`](./DELEGATION_PROTOCOL.md) | Lean Token Protocol spec |
|
|
287
|
+
| [`SECURITY.md`](./SECURITY.md) | Auth + scope policy |
|
|
288
|
+
| [`ROLE_ROUTING.md`](./ROLE_ROUTING.md) | Backend routing rules |
|
|
261
289
|
|
|
262
|
-
|
|
263
|
-
dt check --strict
|
|
264
|
-
```
|
|
290
|
+
---
|
|
265
291
|
|
|
266
|
-
|
|
292
|
+
## ๐ค Contributing
|
|
267
293
|
|
|
294
|
+
1. **Fork** and **clone** the repo.
|
|
295
|
+
2. **Read** [`AGENTS.md`](./AGENTS.md) โ repo conventions live here.
|
|
296
|
+
3. **Make a feature branch**: `git switch -c feat/your-change`
|
|
297
|
+
4. **Run CI locally**:
|
|
268
298
|
```bash
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
299
|
+
bash -n install.sh
|
|
300
|
+
bash -n orchestrator/scripts/orchestrate.sh
|
|
301
|
+
python -m py_compile mmas/spawn-team.py mmas/hash-edit.py
|
|
302
|
+
python -m json.tool < .claude-plugin/marketplace.json > /dev/null
|
|
272
303
|
```
|
|
304
|
+
5. **Open a PR** โ the CI runs the same checks on the GitHub Actions runners.
|
|
273
305
|
|
|
274
|
-
|
|
306
|
+
### Adding a new component
|
|
275
307
|
|
|
276
|
-
|
|
308
|
+
See [`AGENTS.md`](./AGENTS.md#creating-a-new-component) for the full checklist.
|
|
277
309
|
|
|
278
|
-
###
|
|
310
|
+
### Adding a new sub-skill
|
|
279
311
|
|
|
280
|
-
|
|
312
|
+
Use the scaffolder to bootstrap it:
|
|
281
313
|
|
|
282
314
|
```bash
|
|
283
|
-
|
|
315
|
+
mavis-skill-scaffold --name my-new-skill --description "..." --type workflow
|
|
284
316
|
```
|
|
285
317
|
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
```bash
|
|
289
|
-
dt run "fix the auth bug and run the related tests" --backend vertexcoder
|
|
290
|
-
```
|
|
291
|
-
|
|
292
|
-
For a large multi-module task:
|
|
293
|
-
|
|
294
|
-
```bash
|
|
295
|
-
dt run "plan and implement the billing module with tests" --team
|
|
296
|
-
```
|
|
297
|
-
|
|
298
|
-
For a direct team workflow with stricter defaults:
|
|
299
|
-
|
|
300
|
-
```bash
|
|
301
|
-
dt metagpt "plan and implement the billing module with tests" --workspace-only --no-install
|
|
302
|
-
```
|
|
303
|
-
|
|
304
|
-
### Brief quality rules
|
|
305
|
-
|
|
306
|
-
A good delegation brief should include the goal, files or modules involved, constraints, acceptance criteria, and tests to run.
|
|
307
|
-
|
|
308
|
-
Keep the requested change small enough to review. Prefer focused patches over broad rewrites.
|
|
309
|
-
|
|
310
|
-
Do not include secrets, tokens, private keys, unrelated files, or hidden user data in the brief.
|
|
311
|
-
|
|
312
|
-
### Review rules after delegation
|
|
318
|
+
---
|
|
313
319
|
|
|
314
|
-
|
|
315
|
-
2. Review the actual git diff.
|
|
316
|
-
3. Run the relevant tests, or ask the user before running expensive commands.
|
|
317
|
-
4. Reject or revise the result if it produced no meaningful diff, touched unrelated files, weakened security, or changed behavior outside the requested scope.
|
|
318
|
-
5. Commit only after explicit user approval.
|
|
320
|
+
## ๐ฃ๏ธ Roadmap
|
|
319
321
|
|
|
320
|
-
|
|
322
|
+
- [x] **v2.0.0** โ supersystem release (`/mavis-ship` + scaffolder + MMAS + integrations)
|
|
323
|
+
- [x] **v2.1.0** โ Skills.sh + Claude Code marketplace compatibility
|
|
324
|
+
- [x] **v2.1.1** โ orchestrate.sh regex routing fixes (BUILD/PUBLISM rule)
|
|
325
|
+
- [ ] **v2.2.0** โ ATLAS web UI for non-CLI users
|
|
326
|
+
- [ ] **v3.0.0** โ multi-tenant team runs + per-project skill isolation
|
|
327
|
+
- [ ] **v3.x.x** โ Webhook-driven CI feedback loop (autoresearch auto-iterate on test fail)
|
|
321
328
|
|
|
322
|
-
|
|
323
|
-
.
|
|
324
|
-
โโโ package.json # Package setup & CLI global mappings
|
|
325
|
-
โโโ src/ # TypeScript Source Code
|
|
326
|
-
โ โโโ cli.ts # CLI Entry Point
|
|
327
|
-
โ โโโ commands/ # CLI Commands (run, setup)
|
|
328
|
-
โ โโโ proxy/ # LLM Gateway Proxy Server
|
|
329
|
-
โ โโโ ...
|
|
330
|
-
โโโ dist/ # Generated after npm run build, not committed
|
|
331
|
-
โโโ delegate-team/ # Master coordinator logic (Relay, routers, guidelines)
|
|
332
|
-
โ โโโ SKILL.md # Unified orchestrator instructions
|
|
333
|
-
โ โโโ scripts/ # Core routing, relay & fallback systems
|
|
334
|
-
โโโ vertex-coder/ # Python agent code. Local .venv is created by dt setup
|
|
335
|
-
โ โโโ SKILL.md # VertexCoder execution directives
|
|
336
|
-
โ โโโ vertex_direct_coder.py # Direct single-file coding agent
|
|
337
|
-
โ โโโ vertex_interactive_agent.py # Autonomous multi-file developer loop
|
|
338
|
-
โโโ LICENSE # MIT Permissive License
|
|
339
|
-
โโโ README.md # Developer documentation
|
|
340
|
-
```
|
|
329
|
+
---
|
|
341
330
|
|
|
342
|
-
##
|
|
331
|
+
## ๐ Acknowledgments
|
|
343
332
|
|
|
344
|
-
|
|
345
|
-
- Some backends require local tools or credentials
|
|
346
|
-
- Team artifacts are still evolving
|
|
347
|
-
- Human approval queue is planned but not fully implemented
|
|
348
|
-
- Security controls are local policy gates, not a sandboxed VM
|
|
333
|
+
Built on top of amazing open-source work:
|
|
349
334
|
|
|
350
|
-
|
|
335
|
+
- [obra/superpowers](https://github.com/obra/superpowers) โ the methodology layer
|
|
336
|
+
- [tw93/Waza](https://github.com/tw93/Waza) โ the 8-skills framework
|
|
337
|
+
- [uditgoenka/autoresearch](https://github.com/uditgoenka/autoresearch) โ the metric loop
|
|
338
|
+
- [imMamdouhaboammar/unslop-preflight](https://github.com/imMamdouhaboammar/unslop-preflight) โ the UI quality gate
|
|
339
|
+
- [vercel-labs/skills](https://github.com/vercel-labs/skills) โ the registry infrastructure
|
|
340
|
+
- [pbakaus/impeccable](https://github.com/pbakaus/impeccable), [addyosmani/best-practices](https://github.com/addyosmani) โ design discipline
|
|
341
|
+
- And 1800+ curated skills at `~/.agents/skills/` powering the global arsenal.
|
|
351
342
|
|
|
352
|
-
|
|
353
|
-
- Human approval queue
|
|
354
|
-
- Stronger role-to-backend contracts
|
|
355
|
-
- More security regression tests
|
|
356
|
-
- npm package release
|
|
357
|
-
- Optional upstream MetaGPT compatibility
|
|
343
|
+
---
|
|
358
344
|
|
|
359
|
-
##
|
|
345
|
+
## ๐ License
|
|
360
346
|
|
|
361
|
-
|
|
347
|
+
MIT โ see [`LICENSE`](./LICENSE).
|
|
362
348
|
|
|
363
|
-
|
|
364
|
-
```bash
|
|
365
|
-
npm run typecheck
|
|
366
|
-
npm run build
|
|
367
|
-
npm test
|
|
368
|
-
dt check
|
|
369
|
-
```
|
|
349
|
+
---
|
|
370
350
|
|
|
371
|
-
|
|
372
|
-
- workspace boundary
|
|
373
|
-
- command allowlist
|
|
374
|
-
- proxy auth
|
|
375
|
-
- dependency install gates
|
|
351
|
+
<div align="center">
|
|
376
352
|
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
3. Commit your Changes (`git commit -m 'Add an EpicEnhancement'`).
|
|
380
|
-
4. Push to the Branch (`git push origin feature/EpicEnhancement`).
|
|
381
|
-
5. Open a Pull Request.
|
|
353
|
+
<sub>If this repo saved you time, [star it โญ](https://github.com/imMamdouhaboammar/delegate-team) or
|
|
354
|
+
[open an issue](https://github.com/imMamdouhaboammar/delegate-team/issues/new).</sub>
|
|
382
355
|
|
|
383
|
-
|
|
356
|
+
<sub>Built by <strong>Mamdouh Aboammar</strong> ยท Cairo, Egypt ๐ช๐ฌ</sub>
|
|
384
357
|
|
|
385
|
-
|
|
358
|
+
</div>
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "delegate-team",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "Agentic engineering supersystem. One CLI to run the full /mavis-ship chain
|
|
3
|
+
"version": "2.2.0",
|
|
4
|
+
"description": "Agentic engineering supersystem. One CLI to run the full /mavis-ship chain โ design + plan + execute (autoresearch / multi-model / multi-agent) + verify + ship. Bundles a `dt` delegation gateway that routes Claude Code tasks to backends (Codex, MiniMax via mmx, Gemini, MetaGPT), plus a complete orchestrator framework installable via `npx skills add`. Companion frameworks: superpowers, Waza, unslop-preflight, autoresearch.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/cli.js",
|
|
7
7
|
"bin": {
|
|
@@ -83,4 +83,4 @@
|
|
|
83
83
|
"dependencies": {
|
|
84
84
|
"commander": "^15.0.0"
|
|
85
85
|
}
|
|
86
|
-
}
|
|
86
|
+
}
|