delegate-team 2.1.1 โ 2.3.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 +279 -289
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,385 +1,375 @@
|
|
|
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
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
|
16
|
-
|
|
7
|
+
```text
|
|
8
|
+
/mavis-ship "Make API p95 < 200ms"
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
**Waza `/think` โ unslop audit โ superpowers writing-plans โ**
|
|
12
|
+
**autoresearch | `/delegate-team` | `/mavis-team` โ Waza `/check` โ quality-guard โ SHIP**
|
|
13
|
+
|
|
14
|
+
[](https://www.npmjs.com/package/delegate-team)
|
|
15
|
+
[](https://www.npmjs.com/package/delegate-team)
|
|
16
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/releases)
|
|
17
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/blob/master/LICENSE)
|
|
18
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/stargazers)
|
|
19
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/actions/workflows/ci.yml)
|
|
20
|
+
[](https://github.com/imMamdouhaboammar/delegate-team/actions/workflows/npm-publish.yml)
|
|
21
|
+
[](https://skills.sh/imMamdouhaboammar/delegate-team)
|
|
22
|
+
[](https://nodejs.org)
|
|
23
|
+
[](https://python.org)
|
|
24
|
+
[](https://www.gnu.org/software/bash/)
|
|
25
|
+
|
|
26
|
+
</div>
|
|
27
|
+
|
|
28
|
+
> **The complete agentic engineering supersystem.** One open-source repo. Six
|
|
29
|
+
> components. Four routing layers. One **(`/mavis-ship "<task>")** command that
|
|
30
|
+
> orchestrates them all. Built on top of superpowers, Waza, unslop-preflight,
|
|
31
|
+
> and autoresearch. Designed to work with Claude Code, Codex, Cursor, Copilot,
|
|
32
|
+
> Windsurf, Gemini CLI, OpenCode, and 60+ more coding agents via Skills.sh.
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## โก What is this?
|
|
17
37
|
|
|
18
|
-
**
|
|
38
|
+
**delegate-team** is the bridge between a natural-language request and a
|
|
39
|
+
multi-model, multi-stage engineering pipeline. Instead of picking tools by hand,
|
|
40
|
+
type one command and let the supersystem decide:
|
|
41
|
+
|
|
42
|
+
| Without delegate-team | With delegate-team |
|
|
43
|
+
|---|---|
|
|
44
|
+
| Pick a model โ craft a prompt โ wait โ review โ fix the prompt โ repeat | `/mavis-ship "X"` and watch the chain run |
|
|
45
|
+
| Architect **or** implement **or** review per turn | Brainstorm โ plan โ TDD โ execute โ verify โ ship |
|
|
46
|
+
| Each agent works alone | 8 specialized agents (Atlas / Forge / Scout / Oracle / Librarian / Reviewer / Visionary / Sentinel) collaborate |
|
|
47
|
+
| "Best practice" depends on which LLM answered | Methodology encoded as skills: superpowers ยท Waza ยท unslop-preflight ยท autoresearch |
|
|
48
|
+
|
|
49
|
+
**Sounds good? Try it:**
|
|
19
50
|
|
|
20
51
|
```bash
|
|
21
52
|
git clone https://github.com/imMamdouhaboammar/delegate-team
|
|
22
53
|
cd delegate-team
|
|
23
54
|
./install.sh --all
|
|
55
|
+
./install.sh --verify # sanity check
|
|
24
56
|
```
|
|
25
57
|
|
|
26
|
-
After install: type `/mavis-ship "<task>"` (or `dt run "<task>"`) in any session.
|
|
27
|
-
|
|
28
58
|
---
|
|
29
59
|
|
|
30
|
-
## Quick
|
|
31
|
-
|
|
32
|
-
- [`orchestrator/README.md`](./orchestrator/README.md) โ `/mavis-ship` skill + orchestrate.sh
|
|
33
|
-
- [`scaffolder/README.md`](./scaffolder/README.md) โ `mavis-skill-scaffold` CLI
|
|
34
|
-
- [`mmas/README.md`](./mmas/README.md) โ multi-agent team framework
|
|
35
|
-
- [`integrations/README.md`](./integrations/README.md) โ companion frameworks
|
|
36
|
-
- [`DT.md`](./DT.md) โ `dt` CLI specifics (the original delegation gateway)
|
|
37
|
-
- [`INSTALL.md`](./INSTALL.md) โ full install guide
|
|
38
|
-
- [`CHANGELOG.md`](./CHANGELOG.md) โ release notes
|
|
60
|
+
## ๐ฆ Quick install
|
|
39
61
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
## What `dt` is
|
|
62
|
+
**Four installation paths. Pick your favorite.**
|
|
43
63
|
|
|
44
|
-
|
|
64
|
+
### Path A โ npm (the fastest โ just the `dt` CLI)
|
|
45
65
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
66
|
+
```bash
|
|
67
|
+
# Global install (preferred for a CLI on your PATH)
|
|
68
|
+
npm install -g delegate-team
|
|
69
|
+
dt --version # โ 2.2.0
|
|
70
|
+
dt run "<task>"
|
|
50
71
|
|
|
51
|
-
|
|
72
|
+
# Or run without installing
|
|
73
|
+
npx delegate-team --help
|
|
74
|
+
```
|
|
52
75
|
|
|
53
|
-
-
|
|
54
|
-
- It does not commit code automatically
|
|
55
|
-
- It does not guarantee every backend is available
|
|
56
|
-
- It does not make untrusted agent output safe without review
|
|
76
|
+
Releases auto-publish from the `npm-publish.yml` GitHub Action on every `v*` tag push.
|
|
57
77
|
|
|
58
|
-
|
|
78
|
+
### Path B โ Skills.sh CLI (skill discovery + global install)
|
|
59
79
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
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. |
|
|
80
|
+
```bash
|
|
81
|
+
npx skills add imMamdouhaboammar/delegate-team -a claude-code -g -y
|
|
82
|
+
```
|
|
67
83
|
|
|
68
|
-
|
|
84
|
+
This installs all 8 sub-skills to your Claude Code (or any of 68 supported agents)
|
|
85
|
+
and makes `delegate-team`, `mavis-ship`, `mmas`, `skill-scaffold`, `dt`, etc.
|
|
86
|
+
all invocable by name.
|
|
69
87
|
|
|
70
|
-
|
|
88
|
+
### Path C โ Claude Code marketplace (native plugin install)
|
|
71
89
|
|
|
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
|
|
90
|
+
```bash
|
|
91
|
+
/plugin marketplace add imMamdouhaboammar/delegate-team
|
|
92
|
+
/plugin install delegate-team@delegate-team
|
|
88
93
|
```
|
|
89
94
|
|
|
90
|
-
|
|
91
|
-
- ๐ [Role Routing](./ROLE_ROUTING.md): How MetaGPT roles are dynamically mapped to specific models via capability tags.
|
|
92
|
-
- ๐ต๏ธ [Trace Schema](./TRACE_SCHEMA.md): JSON schema to prevent circular delegation, control depth, and avoid cost explosions.
|
|
95
|
+
### Path D โ Bootstrap script (everything, including companion frameworks)
|
|
93
96
|
|
|
94
|
-
|
|
97
|
+
```bash
|
|
98
|
+
git clone https://github.com/imMamdouhaboammar/delegate-team
|
|
99
|
+
cd delegate-team
|
|
100
|
+
./install.sh --all # everything
|
|
101
|
+
./install.sh --orchestrator # just /mavis-ship
|
|
102
|
+
./install.sh --mmas # just the multi-agent framework
|
|
103
|
+
./install.sh --integrations # just companion frameworks
|
|
104
|
+
./install.sh --verify # check what's installed
|
|
105
|
+
```
|
|
95
106
|
|
|
96
|
-
|
|
97
|
-
- npm
|
|
98
|
-
- Python 3.10+
|
|
99
|
-
- Optional: gcloud CLI for VertexCoder
|
|
100
|
-
- Optional: provider credentials for configured backends
|
|
107
|
+
After install, every component is idempotent and verifiable.
|
|
101
108
|
|
|
102
|
-
|
|
109
|
+
---
|
|
103
110
|
|
|
104
|
-
|
|
105
|
-
# Clone the repository
|
|
106
|
-
git clone https://github.com/imMamdouhaboammar/delegate-team.git
|
|
107
|
-
cd delegate-team
|
|
111
|
+
## ๐งฉ Components
|
|
108
112
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
113
|
+
| Component | Path | Language | Status | What it does |
|
|
114
|
+
|---|---|---|---|---|
|
|
115
|
+
| **dt CLI** | [`src/`](./src), [`dist/`](./dist) |  |  | Delegation gateway with policy + failover + MetaGPT teams |
|
|
116
|
+
| **`/mavis-ship`** | [`orchestrator/`](./orchestrator/) |  |  | Single-command orchestrator with regex routing |
|
|
117
|
+
| **Skill scaffolder** | [`scaffolder/`](./scaffolder/) |  |  | `mavis-skill-scaffold` generator |
|
|
118
|
+
| **MMAS** | [`mmas/`](./mmas/) |  |  | 8-agent multi-agent team framework |
|
|
119
|
+
| **God Agent** | [`god-agent/`](./god-agent/) |  |  | Codex + opencode dispatcher |
|
|
120
|
+
| **MiniMax Coder** | [`minimax-coder/`](./minimax-coder/) |  |  | MiniMax via `mmx` CLI |
|
|
121
|
+
| **Vertex Coder** | [`vertex-coder/`](./vertex-coder/) |  |  | Gemini via google-genai |
|
|
122
|
+
| **MetaGPT team** | [`metagpt/`](./metagpt/) |  |  | Multi-role team runner |
|
|
112
123
|
|
|
113
|
-
|
|
114
|
-
npm link
|
|
124
|
+
### Companion frameworks (separate install, see [`integrations/`](./integrations/))
|
|
115
125
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
126
|
+
| Framework | Stars | What it adds |
|
|
127
|
+
|---|---|---|
|
|
128
|
+
| [superpowers](https://github.com/obra/superpowers) |  | Methodology โ 14 skills, brainstorm-first hard gate |
|
|
129
|
+
| [Waza](https://github.com/tw93/Waza) |  | Entry-point โ 8 habits-engineering skills |
|
|
130
|
+
| [unslop-preflight](https://github.com/imMamdouhaboammar/unslop-preflight) |  | UI quality gate โ 23 reasoning gates |
|
|
131
|
+
| [autoresearch](https://github.com/uditgoenka/autoresearch) |  | Metric-driven iteration loop |
|
|
120
132
|
|
|
121
|
-
|
|
133
|
+
---
|
|
122
134
|
|
|
123
|
-
|
|
124
|
-
# Run the autopilot setup to build Python environments and configure cloud dependencies
|
|
125
|
-
dt setup
|
|
135
|
+
## ๐ The /mavis-ship chain (how it works)
|
|
126
136
|
|
|
127
|
-
|
|
128
|
-
|
|
137
|
+
Type one command. The orchestrator inspects the task and routes through the
|
|
138
|
+
right stages.
|
|
129
139
|
|
|
130
|
-
|
|
131
|
-
|
|
140
|
+
```text
|
|
141
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
142
|
+
โ /mavis-ship "<your task>" โ
|
|
143
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
144
|
+
โ
|
|
145
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
146
|
+
โ Waza /think โ pressure-test + design
|
|
147
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ (NEVER skip โ hard gate)
|
|
148
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
149
|
+
โ
|
|
150
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
151
|
+
โ unslop audit (BLOCKING) โ score โฅ70 to proceed
|
|
152
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ for UI tasks only
|
|
153
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
154
|
+
โ
|
|
155
|
+
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโ
|
|
156
|
+
โ superpowers writing-plans โ plan with checkpoints
|
|
157
|
+
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
158
|
+
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
|
|
159
|
+
โ
|
|
160
|
+
โโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโ
|
|
161
|
+
โ โ โ
|
|
162
|
+
โโโโโผโโโโโโโโโโโ โโโโโโโโผโโโโโโโ โโโโโโโโโโโโผโโโโโโโโโ
|
|
163
|
+
โ autoresearch โ โ /delegate- โ โ /mavis-team โ
|
|
164
|
+
โ plan + loop โ โ team โ โ MMAS (Atlas+) โ
|
|
165
|
+
โ metric-drivenโ โ multi-modelโ โ parallel agents โ
|
|
166
|
+
โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโ โโโโโโโโโโฌโโโโโโโโโโโ
|
|
167
|
+
โ โ โ
|
|
168
|
+
โโโโผโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโ
|
|
169
|
+
โ Waza /check โ quality-guard (Mavis) โ SHIP โ
|
|
170
|
+
โ review + 5-layer pre-delivery check โ
|
|
171
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
132
172
|
```
|
|
133
173
|
|
|
134
|
-
|
|
174
|
+
**Routing logic** (live in [`orchestrator/scripts/orchestrate.sh`](./orchestrator/scripts/orchestrate.sh)):
|
|
135
175
|
|
|
136
|
-
|
|
176
|
+
| Task signature | Route |
|
|
177
|
+
|---|---|
|
|
178
|
+
| Has measurable metric (e.g. "p95 < 200ms") | autoresearch loop |
|
|
179
|
+
| UI task (frontend, page, modal, shadcn) | unslop BLOCKING โ /delegate-team |
|
|
180
|
+
| Multi-agent signals (squad, spawn team, swarm) | /mavis-team MMAS |
|
|
181
|
+
| Bug / broken / failing | systematic-debugging โ /delegate-team |
|
|
182
|
+
| Heavy multi-file / refactor / migrate | /delegate-team |
|
|
183
|
+
| Research / understand / learn | Waza /read + /learn |
|
|
184
|
+
| Trivial (rename, bump) | handle locally, skip chain |
|
|
137
185
|
|
|
138
|
-
|
|
186
|
+
---
|
|
139
187
|
|
|
140
|
-
|
|
141
|
-
|---|---|
|
|
142
|
-
| Small focused fix | `dt run "fix the auth bug"` |
|
|
143
|
-
| Force one backend | `dt run "..." --backend vertexcoder` |
|
|
144
|
-
| Large multi-module task | `dt run "..." --team` |
|
|
145
|
-
| Direct team workflow | `dt metagpt "..." --workspace-only --no-install` |
|
|
146
|
-
| Check setup | `dt check --strict` |
|
|
147
|
-
|
|
148
|
-
### Smart Multi-Backend Dispatch
|
|
149
|
-
Cast a complex task. The routing analyzes it and selects the optimal backend, complete with automated failover.
|
|
150
|
-
```bash
|
|
151
|
-
dt run "Write a pytest suite in test_auth.py checking JWT login boundaries"
|
|
152
|
-
```
|
|
188
|
+
## ๐ Usage
|
|
153
189
|
|
|
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
|
-
```
|
|
190
|
+
### Slash command (in any Claude Code session)
|
|
159
191
|
|
|
160
|
-
### Interactive Vertex AI Agent (Autonomous Multi-File)
|
|
161
|
-
Summon an autonomous entity to write code, install packages, run tests, and self-correct over multiple files:
|
|
162
192
|
```bash
|
|
163
|
-
|
|
193
|
+
/mavis-ship "Build a CLI to convert CSV to JSON"
|
|
194
|
+
/mavis-ship "The mobile header is rendering wrong on Safari iOS 17"
|
|
195
|
+
/mavis-ship "Make API p95 < 200ms"
|
|
196
|
+
/mavis-ship "Design the auth flow before I implement it"
|
|
164
197
|
```
|
|
165
198
|
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
Run:
|
|
199
|
+
### CLI router (shell โ returns routing decision without execution)
|
|
169
200
|
|
|
170
201
|
```bash
|
|
171
|
-
|
|
202
|
+
mavis-orchestrate "Build a landing page with shadcn components"
|
|
172
203
|
```
|
|
173
204
|
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
-
|
|
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.
|
|
184
|
-
|
|
185
|
-
## Security model
|
|
186
|
-
|
|
187
|
-
- `dt` is local-first
|
|
188
|
-
- Agent output is treated as untrusted until reviewed
|
|
189
|
-
- Claude Code or the human keeps final commit authority
|
|
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
|
|
205
|
+
Output:
|
|
206
|
+
```
|
|
207
|
+
# /mavis-ship route for: "Build a landing page with shadcn components"
|
|
194
208
|
|
|
195
|
-
|
|
209
|
+
Stages (descending score):
|
|
210
|
+
โข unslop audit (UI gate) (score=3)
|
|
211
|
+
โข /think (Waza) (score=2)
|
|
212
|
+
โข /delegate-team (multi-model) (score=1)
|
|
213
|
+
โข /check (Waza) (score=2)
|
|
214
|
+
โข quality-guard (Mavis) (score=2)
|
|
196
215
|
|
|
197
|
-
|
|
216
|
+
# Verdict:
|
|
217
|
+
UI DELIVERY path โ unslop audit is BLOCKING before /delegate-team.
|
|
218
|
+
```
|
|
198
219
|
|
|
199
|
-
|
|
220
|
+
### dt CLI (low-level delegation)
|
|
200
221
|
|
|
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
222
|
```bash
|
|
203
|
-
dt
|
|
223
|
+
dt run "Refactor the user model for multi-tenancy"
|
|
224
|
+
dt run "<task>" --backend minimax-coder # force a specific backend
|
|
225
|
+
dt run "<task>" --team # MetaGPT-style multi-role
|
|
226
|
+
dt setup # first-time setup
|
|
227
|
+
dt doctor # health check
|
|
204
228
|
```
|
|
205
229
|
|
|
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.
|
|
230
|
+
### Multi-agent team (MMAS โ boss mode)
|
|
212
231
|
|
|
213
|
-
## Local proxy
|
|
214
|
-
|
|
215
|
-
Start a local LLM Gateway Proxy server on port `3000` to connect tools directly to `dt`:
|
|
216
232
|
```bash
|
|
217
|
-
|
|
233
|
+
python3 ~/.mavis/agents/mavis/multi-agent/spawn-team.py --atlas
|
|
234
|
+
# Atlas autonomously picks team composition based on the task signature
|
|
218
235
|
```
|
|
219
236
|
|
|
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.
|
|
237
|
+
---
|
|
243
238
|
|
|
244
|
-
|
|
239
|
+
## ๐๏ธ Architecture
|
|
245
240
|
|
|
246
|
-
|
|
241
|
+
```
|
|
242
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
243
|
+
โ USER TASK (natural lang) โ
|
|
244
|
+
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
|
|
245
|
+
โ
|
|
246
|
+
โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโ
|
|
247
|
+
โ /mavis-ship orchestrator โ
|
|
248
|
+
โ (orchestrator/SKILL.md) โ
|
|
249
|
+
โโโโโโโฌโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโ
|
|
250
|
+
โ โ
|
|
251
|
+
โโโโโโโโโโโโโผโโโ โโโโโโโโโผโโโโโโโโโโ
|
|
252
|
+
โ Methodology โ โ Execution โ
|
|
253
|
+
โ โโโโโโโโโโโ โ โ โโโโโโโโโโโโ โ
|
|
254
|
+
โ Waza โ โ /delegate-team โ
|
|
255
|
+
โ superpowers โ โ /mavis-team โ
|
|
256
|
+
โ unslop โ โ autoresearch โ
|
|
257
|
+
โ โ โ (each routes โ
|
|
258
|
+
โ โ โ to a back- โ
|
|
259
|
+
โ โ โ end agent) โ
|
|
260
|
+
โโโโโโโโโโโโโโโโ โโโโโโโโโโโฌโโโโโโโโ
|
|
261
|
+
โ
|
|
262
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโ
|
|
263
|
+
โ โ โ
|
|
264
|
+
โโโโโโโโผโโโโโโโ โโโโโโโโโผโโโโโโ โโโโโโโโผโโโโโโโ
|
|
265
|
+
โ God Agent โ โ MiniMax โ โ Vertex โ
|
|
266
|
+
โ codex / โ โ Coder โ โ Coder โ
|
|
267
|
+
โ opencode โ โ mmx CLI โ โ Gemini โ
|
|
268
|
+
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
|
|
269
|
+
|
|
270
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
271
|
+
โ VERIFICATION (Waza /check) โ
|
|
272
|
+
โ + quality-guard 5-layer check โ
|
|
273
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
274
|
+
```
|
|
247
275
|
|
|
248
|
-
|
|
276
|
+
---
|
|
249
277
|
|
|
250
|
-
|
|
278
|
+
## โ Why not just use...?
|
|
251
279
|
|
|
252
|
-
|
|
280
|
+
| Comparison | Use this when |
|
|
281
|
+
|---|---|
|
|
282
|
+
| `autoresearch` alone | You have ONE measurable metric + bounded scope. Skip the planning. |
|
|
283
|
+
| `/delegate-team` alone | You know which model + backend you want. Skip orchestration. |
|
|
284
|
+
| `/mavis-team` alone | You want a specific team composition. Skip auto-picking. |
|
|
285
|
+
| LLM directly (no agents) | Trivial edits. Use `:edit` mode. |
|
|
286
|
+
| **`delegate-team` / `/mavis-ship`** | Anything else. Let the orchestrator decide. |
|
|
253
287
|
|
|
254
|
-
|
|
288
|
+
---
|
|
255
289
|
|
|
256
|
-
|
|
257
|
-
dt --help
|
|
258
|
-
```
|
|
290
|
+
## ๐ Documentation
|
|
259
291
|
|
|
260
|
-
|
|
292
|
+
| Doc | What's inside |
|
|
293
|
+
|---|---|
|
|
294
|
+
| [`INSTALL.md`](./INSTALL.md) | Full installation guide + verification matrix |
|
|
295
|
+
| [`CHANGELOG.md`](./CHANGELOG.md) | v1 โ v2 โ v2.1 release notes |
|
|
296
|
+
| [`DT.md`](./DT.md) | Original `dt` CLI specifics (gateway internals) |
|
|
297
|
+
| [`orchestrator/README.md`](./orchestrator/README.md) | `/mavis-ship` details |
|
|
298
|
+
| [`scaffolder/README.md`](./scaffolder/README.md) | `mavis-skill-scaffold` reference |
|
|
299
|
+
| [`mmas/README.md`](./mmas/README.md) | Multi-agent team framework |
|
|
300
|
+
| [`integrations/README.md`](./integrations/README.md) | Companion frameworks overview |
|
|
301
|
+
| [`AGENTS.md`](./AGENTS.md) | Repo conventions for contributors |
|
|
302
|
+
| [`CLAUDE.md`](./CLAUDE.md) | Claude-Code-specific guidance |
|
|
303
|
+
| [`DELEGATION_PROTOCOL.md`](./DELEGATION_PROTOCOL.md) | Lean Token Protocol spec |
|
|
304
|
+
| [`SECURITY.md`](./SECURITY.md) | Auth + scope policy |
|
|
305
|
+
| [`ROLE_ROUTING.md`](./ROLE_ROUTING.md) | Backend routing rules |
|
|
261
306
|
|
|
262
|
-
|
|
263
|
-
dt check --strict
|
|
264
|
-
```
|
|
307
|
+
---
|
|
265
308
|
|
|
266
|
-
|
|
309
|
+
## ๐ค Contributing
|
|
267
310
|
|
|
311
|
+
1. **Fork** and **clone** the repo.
|
|
312
|
+
2. **Read** [`AGENTS.md`](./AGENTS.md) โ repo conventions live here.
|
|
313
|
+
3. **Make a feature branch**: `git switch -c feat/your-change`
|
|
314
|
+
4. **Run CI locally**:
|
|
268
315
|
```bash
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
316
|
+
bash -n install.sh
|
|
317
|
+
bash -n orchestrator/scripts/orchestrate.sh
|
|
318
|
+
python -m py_compile mmas/spawn-team.py mmas/hash-edit.py
|
|
319
|
+
python -m json.tool < .claude-plugin/marketplace.json > /dev/null
|
|
272
320
|
```
|
|
321
|
+
5. **Open a PR** โ the CI runs the same checks on the GitHub Actions runners.
|
|
273
322
|
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
5. Do not run `dt link-skill` automatically. Ask first, because it creates or updates local skill links in agent tool directories.
|
|
277
|
-
|
|
278
|
-
### Delegation examples
|
|
323
|
+
### Adding a new component
|
|
279
324
|
|
|
280
|
-
|
|
325
|
+
See [`AGENTS.md`](./AGENTS.md#creating-a-new-component) for the full checklist.
|
|
281
326
|
|
|
282
|
-
|
|
283
|
-
dt run "fix the auth bug and run the related tests"
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
For a specific backend:
|
|
287
|
-
|
|
288
|
-
```bash
|
|
289
|
-
dt run "fix the auth bug and run the related tests" --backend vertexcoder
|
|
290
|
-
```
|
|
327
|
+
### Adding a new sub-skill
|
|
291
328
|
|
|
292
|
-
|
|
329
|
+
Use the scaffolder to bootstrap it:
|
|
293
330
|
|
|
294
331
|
```bash
|
|
295
|
-
|
|
332
|
+
mavis-skill-scaffold --name my-new-skill --description "..." --type workflow
|
|
296
333
|
```
|
|
297
334
|
|
|
298
|
-
|
|
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
|
|
335
|
+
---
|
|
313
336
|
|
|
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.
|
|
337
|
+
## ๐ฃ๏ธ Roadmap
|
|
319
338
|
|
|
320
|
-
|
|
339
|
+
- [x] **v2.0.0** โ supersystem release (`/mavis-ship` + scaffolder + MMAS + integrations)
|
|
340
|
+
- [x] **v2.1.0** โ Skills.sh + Claude Code marketplace compatibility
|
|
341
|
+
- [x] **v2.1.1** โ orchestrate.sh regex routing fixes (BUILD/PUBLISM rule)
|
|
342
|
+
- [ ] **v2.2.0** โ ATLAS web UI for non-CLI users
|
|
343
|
+
- [ ] **v3.0.0** โ multi-tenant team runs + per-project skill isolation
|
|
344
|
+
- [ ] **v3.x.x** โ Webhook-driven CI feedback loop (autoresearch auto-iterate on test fail)
|
|
321
345
|
|
|
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
|
-
```
|
|
346
|
+
---
|
|
341
347
|
|
|
342
|
-
##
|
|
348
|
+
## ๐ Acknowledgments
|
|
343
349
|
|
|
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
|
|
350
|
+
Built on top of amazing open-source work:
|
|
349
351
|
|
|
350
|
-
|
|
352
|
+
- [obra/superpowers](https://github.com/obra/superpowers) โ the methodology layer
|
|
353
|
+
- [tw93/Waza](https://github.com/tw93/Waza) โ the 8-skills framework
|
|
354
|
+
- [uditgoenka/autoresearch](https://github.com/uditgoenka/autoresearch) โ the metric loop
|
|
355
|
+
- [imMamdouhaboammar/unslop-preflight](https://github.com/imMamdouhaboammar/unslop-preflight) โ the UI quality gate
|
|
356
|
+
- [vercel-labs/skills](https://github.com/vercel-labs/skills) โ the registry infrastructure
|
|
357
|
+
- [pbakaus/impeccable](https://github.com/pbakaus/impeccable), [addyosmani/best-practices](https://github.com/addyosmani) โ design discipline
|
|
358
|
+
- And 1800+ curated skills at `~/.agents/skills/` powering the global arsenal.
|
|
351
359
|
|
|
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
|
|
360
|
+
---
|
|
358
361
|
|
|
359
|
-
##
|
|
362
|
+
## ๐ License
|
|
360
363
|
|
|
361
|
-
|
|
364
|
+
MIT โ see [`LICENSE`](./LICENSE).
|
|
362
365
|
|
|
363
|
-
|
|
364
|
-
```bash
|
|
365
|
-
npm run typecheck
|
|
366
|
-
npm run build
|
|
367
|
-
npm test
|
|
368
|
-
dt check
|
|
369
|
-
```
|
|
366
|
+
---
|
|
370
367
|
|
|
371
|
-
|
|
372
|
-
- workspace boundary
|
|
373
|
-
- command allowlist
|
|
374
|
-
- proxy auth
|
|
375
|
-
- dependency install gates
|
|
368
|
+
<div align="center">
|
|
376
369
|
|
|
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.
|
|
370
|
+
<sub>If this repo saved you time, [star it โญ](https://github.com/imMamdouhaboammar/delegate-team) or
|
|
371
|
+
[open an issue](https://github.com/imMamdouhaboammar/delegate-team/issues/new).</sub>
|
|
382
372
|
|
|
383
|
-
|
|
373
|
+
<sub>Built by <strong>Mamdouh Aboammar</strong> ยท Cairo, Egypt ๐ช๐ฌ</sub>
|
|
384
374
|
|
|
385
|
-
|
|
375
|
+
</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.3.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
|
+
}
|