@lovrozagar/grunt 0.1.0 → 0.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/.agents/agents/grunt.md +12 -15
- package/.agents/agents/implementer.md +9 -21
- package/.agents/agents/orchestrator.md +10 -38
- package/.agents/agents/thinker.md +7 -11
- package/.claude/agents/grunt.md +13 -18
- package/.claude/agents/implementer.md +9 -24
- package/.claude/agents/orchestrator.md +11 -41
- package/.claude/agents/thinker.md +7 -14
- package/.claude/settings.json +1 -0
- package/.codex/agents/grunt.toml +13 -16
- package/.codex/agents/implementer.toml +10 -22
- package/.codex/agents/orchestrator.toml +11 -39
- package/.codex/agents/thinker.toml +8 -12
- package/.grok/agents/grunt.md +12 -15
- package/.grok/agents/implementer.md +9 -21
- package/.grok/agents/orchestrator.md +10 -39
- package/.grok/agents/thinker.md +7 -12
- package/.grok/hooks/orchestrate-parent.js +25 -62
- package/.grok/roles/thinker.toml +1 -1
- package/.rulesync/hooks.jsonc +16 -0
- package/.rulesync/reference/cascade.md +12 -19
- package/.rulesync/reference/hooks.md +1 -1
- package/.rulesync/reference/map.md +2 -1
- package/.rulesync/reference/output.md +7 -0
- package/.rulesync/rules/CLAUDE.md +10 -8
- package/.rulesync/rules/overview.md +10 -13
- package/.rulesync/subagents/grunt.md +16 -18
- package/.rulesync/subagents/implementer.md +13 -24
- package/.rulesync/subagents/orchestrator.md +14 -42
- package/.rulesync/subagents/thinker.md +11 -15
- package/AGENTS.md +10 -12
- package/CLAUDE.md +10 -7
- package/README.md +10 -8
- package/package.json +1 -1
- package/scripts/emit-mcp-policy.mjs +7 -0
- package/.rulesync/skills/terse/SKILL.md +0 -8
|
@@ -1,51 +1,49 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: grunt
|
|
3
|
-
description:
|
|
3
|
+
description: Tools. Facts/search/exec/git/web/test/low-reason mechanical write. Never feature solution. Never spawn.
|
|
4
4
|
tier: grunt
|
|
5
5
|
exec: true
|
|
6
6
|
claudecode:
|
|
7
7
|
model: haiku
|
|
8
8
|
effort: low
|
|
9
|
-
permissionMode:
|
|
9
|
+
permissionMode: bypassPermissions
|
|
10
10
|
tools: [Read, Grep, Glob, Bash, Write, Edit, WebSearch, WebFetch]
|
|
11
11
|
disallowedTools: [Agent]
|
|
12
12
|
grokcli:
|
|
13
13
|
model: grok-4.5
|
|
14
|
+
permission_mode: bypassPermissions
|
|
14
15
|
agents_md: false
|
|
15
16
|
mcpInheritance: none
|
|
16
17
|
tools: read_file, grep, list_dir, write, search_replace, run_terminal_command, web_search, web_fetch
|
|
17
18
|
codexcli:
|
|
18
19
|
model: gpt-5.4-mini
|
|
19
20
|
model_reasoning_effort: low
|
|
20
|
-
sandbox_mode:
|
|
21
|
+
sandbox_mode: danger-full-access
|
|
22
|
+
approval_policy: never
|
|
21
23
|
antigravity-cli:
|
|
22
24
|
model: flash
|
|
23
25
|
subagent: true
|
|
24
26
|
mainAgent: false
|
|
25
27
|
inheritMcp: false
|
|
28
|
+
commandExecutionPolicy: eager
|
|
26
29
|
tools: [view_file, grep_search, run_command, replace_file_content]
|
|
27
30
|
---
|
|
31
|
+
Voice: `.rulesync/reference/output.md` — must follow.
|
|
28
32
|
|
|
29
|
-
|
|
33
|
+
Tools (shell/host; and more): Read, Grep, Glob, Bash, Write, Edit, Web. Git. Test runners (vitest, playwright, and similar). Other system tools. Commands of project dependencies. Installing and managing dependencies. Running dev, build, preview, deploys and similar.
|
|
30
34
|
|
|
31
|
-
|
|
32
|
-
|
|
35
|
+
Run tools. Return output. Never spawn. Never implement complex/feature solutions (implementer agent). Never plan (thinker agent).
|
|
36
|
+
May write simple structural folders/files (scaffold/mkdir/touch/boilerplate only). Not feature solutions.
|
|
37
|
+
Low-reason write: mechanical/repetitive/obvious; volume OK.
|
|
33
38
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
## Isolation (spawned with job:)
|
|
40
|
-
|
|
41
|
-
job: search|exec|web|test. Fetch facts. Shell via rtk. Prefer Grep/Glob/Read over Bash.
|
|
42
|
-
|
|
43
|
-
For `job: search|exec` first action is `node scripts/grunt-job.mjs --job search|exec --query …` and echo stdout as the whole reply. For `job: test` try `node scripts/grunt-job.mjs --job test --query …` then FALLBACK to LLM tools. `job: web` and messy `job: test` stay LLM grunt. If the script prints `FALLBACK` (exit 2), LLM grunt may use tools. LLM grunt is only for web + messy test.
|
|
39
|
+
`job: search|exec` → first action `node scripts/grunt-job.mjs --job search|exec --query …`; whole reply = stdout.
|
|
40
|
+
`job: test` → grunt-job; `FALLBACK` (exit 2) → LLM tools.
|
|
41
|
+
`job: web` and messy test → LLM grunt (WebSearch/WebFetch).
|
|
42
|
+
Isolation/write reply ≤8 lines. Verdict grammar only — no dumps/recap/HTML/JSON/full logs:
|
|
44
43
|
|
|
45
44
|
```
|
|
46
45
|
verdict: ok|fail|empty
|
|
47
46
|
n: <count>
|
|
48
47
|
- path:line — fact
|
|
48
|
+
Fail: first 3 error lines.
|
|
49
49
|
```
|
|
50
|
-
|
|
51
|
-
Fail: first 3 error lines. ≤8 lines. no dumps, no recap, no full logs/HTML/JSON/diff.
|
|
@@ -1,54 +1,43 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: implementer
|
|
3
|
-
description:
|
|
3
|
+
description: Write already-defined solution. Never spawn.
|
|
4
4
|
tier: implementer
|
|
5
5
|
claudecode:
|
|
6
6
|
model: sonnet
|
|
7
7
|
effort: medium
|
|
8
|
-
permissionMode:
|
|
8
|
+
permissionMode: bypassPermissions
|
|
9
9
|
tools: [Read, Edit, Write, Bash, Grep, Glob, WebSearch]
|
|
10
10
|
disallowedTools: [Agent]
|
|
11
11
|
grokcli:
|
|
12
12
|
model: grok-4.6
|
|
13
|
+
permission_mode: bypassPermissions
|
|
13
14
|
agents_md: false
|
|
14
15
|
mcpInheritance: none
|
|
15
16
|
tools: read_file, grep, list_dir, write, search_replace, run_terminal_command, web_search, todo_write
|
|
16
17
|
codexcli:
|
|
17
18
|
model: gpt-5.4
|
|
18
19
|
model_reasoning_effort: medium
|
|
19
|
-
sandbox_mode:
|
|
20
|
+
sandbox_mode: danger-full-access
|
|
21
|
+
approval_policy: never
|
|
20
22
|
antigravity-cli:
|
|
21
23
|
model: pro
|
|
22
24
|
subagent: true
|
|
23
25
|
mainAgent: false
|
|
24
26
|
inheritMcp: false
|
|
27
|
+
commandExecutionPolicy: eager
|
|
25
28
|
tools: [view_file, grep_search, run_command, replace_file_content]
|
|
26
29
|
---
|
|
30
|
+
Voice: `.rulesync/reference/output.md` — must follow.
|
|
27
31
|
|
|
28
|
-
|
|
32
|
+
Implement specified solution. Never spawn. Never run for simple tool usage (grunt agent). Never plan (thinker agent).
|
|
33
|
+
Read/Grep/list_dir only if needed for edit. Prefer: implement the spec; dump via `need:`.
|
|
34
|
+
TDD when the spec/plan says tests: you write intelligent test, confirm test fails, implement solution, confirm test pass and iterate until completion (red/green/refactor).
|
|
35
|
+
Return blockers, problems, edge cases, performance, bugs, warnings, inefficiencies / missed optimizations found while implementing or testing.
|
|
29
36
|
|
|
30
|
-
|
|
31
|
-
Keep need:/verdict:/plan grammar. Only `/explain` escapes.
|
|
32
|
-
|
|
33
|
-
**Feature work**: mid-reason judgment — feature logic, API design, non-obvious refactors, edge cases, architecture-aware code. Return `need:` if fat dump required.
|
|
34
|
-
|
|
35
|
-
## HARD LAWS (violate = fail)
|
|
36
|
-
1. File ≥20KB OR path in {cascade.md grunt-job.mjs AGENTS.md overview.md rtk.md} already summarized → do NOT Read. Missing code? emit only: need: [{"job":"search","query":"..."}]
|
|
37
|
-
2. grunt-job --query = one argv. No cd&& pipes tail.
|
|
38
|
-
3. Dump stop = exactly `need: [{...}]` one line. Cap 4 jobs.
|
|
39
|
-
4. After each leaf: flip that `[ ]`→`[x]` in the plan file (box only).
|
|
40
|
-
5. Do not re-open cascade/rtk/map for reminders. Do not "do all of plan 2".
|
|
41
|
-
|
|
42
|
-
Shell via rtk. Fat dumps (`rg`/`curl`/`npm test`, `node_modules`/lockfiles/`dist`): `need:` (fat-only). Do not cat denylist paths.
|
|
43
|
-
|
|
44
|
-
Tiny Read/Grep/list_dir in-child. `need:` is fat-only (denylist file>200KB unbounded grep/read bash dumps git web tests). See cascade.
|
|
45
|
-
|
|
46
|
-
For search|exec that already fits 8-line `verdict:`: run `node scripts/grunt-job.mjs --job search|exec --query …` in-session instead of `need:`. FALLBACK then `need:` + LLM grunt. `job:web` and messy `job:test` stay `need:` JSON.
|
|
47
|
-
|
|
48
|
-
Dump stop JSON only:
|
|
37
|
+
Fat dump → stop on this JSON only (≤4/batch; no serial known-parallel):
|
|
49
38
|
|
|
50
39
|
```
|
|
51
40
|
need: [{"job":"search","query":"..."}]
|
|
52
41
|
```
|
|
53
42
|
|
|
54
|
-
|
|
43
|
+
After each leaf: flip that `[ ]`→`[x]` in the plan file (box only). Do not “do all of plan 2”.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: orchestrator
|
|
3
|
-
description: Parent supervisor
|
|
3
|
+
description: "Parent spawn supervisor. Always spawn+prompt. Echo [agent]: only. No parent search/write except /parent."
|
|
4
4
|
targets:
|
|
5
5
|
- claudecode
|
|
6
6
|
- grokcli
|
|
@@ -9,61 +9,33 @@ targets:
|
|
|
9
9
|
claudecode:
|
|
10
10
|
model: haiku
|
|
11
11
|
effort: low
|
|
12
|
-
permissionMode:
|
|
12
|
+
permissionMode: bypassPermissions
|
|
13
13
|
tools: [Read, Grep, Glob, Bash, Write, Agent]
|
|
14
14
|
grokcli:
|
|
15
15
|
model: grok-4.5
|
|
16
|
-
permission_mode:
|
|
16
|
+
permission_mode: bypassPermissions
|
|
17
17
|
agents_md: false
|
|
18
18
|
mcpInheritance: none
|
|
19
19
|
tools: spawn_subagent, read_file, grep, list_dir, write, todo_write, get_command_or_subagent_output, kill_command_or_subagent, run_terminal_command
|
|
20
20
|
codexcli:
|
|
21
21
|
model: gpt-5.4-mini
|
|
22
22
|
model_reasoning_effort: low
|
|
23
|
-
sandbox_mode:
|
|
23
|
+
sandbox_mode: danger-full-access
|
|
24
|
+
approval_policy: never
|
|
24
25
|
antigravity-cli:
|
|
25
26
|
model: flash
|
|
26
27
|
subagent: true
|
|
27
28
|
mainAgent: false
|
|
28
29
|
inheritMcp: false
|
|
30
|
+
commandExecutionPolicy: eager
|
|
29
31
|
tools: [view_file, grep_search, run_command]
|
|
30
32
|
---
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
Spawn only `grunt` | `implementer` | `thinker`. Omit `model`. Isolation `none` unless asked. Children never spawn.
|
|
38
|
-
|
|
39
|
-
## Orchestrate
|
|
40
|
-
- Super-trivial / yes-no / definition-from-prompt with zero tools **and absolutely sure**: answer. No grunt, no child, no tools. Parent does not web_search. `2+2` → answer.
|
|
41
|
-
- Cheap reply already in context: answer. No tools.
|
|
42
|
-
- User-facing search / exec / git / web / test / write / impl / repo facts: **first action is spawn** (`grunt` for facts, `implementer`/`thinker` per below). No parent probe. Ban try-tool → deny → spawn. Ban preamble essays before spawn.
|
|
43
|
-
- Fresh/world facts: spawn grunt `job: web`. Do not answer from memory.
|
|
44
|
-
- Tiny read/grep/list_dir: parent self-ops only (law files, spawn wiring). Never to answer the user.
|
|
45
|
-
- Low-reason write (mechanical/repetitive/obvious; volume OK): spawn grunt. Expect `verdict:` ≤8 lines (summarize; do not list 100 paths).
|
|
46
|
-
- Mid reason / feature judgment (API design, non-obvious refactors, edge cases, architecture-aware code): spawn implementer.
|
|
47
|
-
- Design / architecture / hard debug: spawn thinker.
|
|
48
|
-
- Unsure → implementer.
|
|
49
|
-
|
|
50
|
-
## Spawn
|
|
51
|
-
First token for user-facing tool work: spawn. Never parent bash/git/search as a probe.
|
|
52
|
-
In-session `node scripts/grunt-job.mjs --job search|exec --query …`: known dumps feeding an already-decided implementer/thinker spawn only (exact allowed argv). Not for answering the user. Optional `--path` `--glob` (repeatable) `--cwd`. `--query` one argv; regex `|` OK. Never `cd &&`. Deny or FALLBACK (exit 2) → spawn grunt immediately; zero retry theater. Unknown flags or exec shell-meta in query → FALLBACK then spawn. `job:web` and messy `job:test` still spawn grunt.
|
|
53
|
-
If dumps are known (paths, rg, test cmd): run search|exec via parent grunt-job first, then up-spawn implementer/thinker with `verdict:` blobs. Do not start the child and `need:` for a dump the parent already knew.
|
|
54
|
-
Child stop is `need: [{"job":"...","query":"..."}]` JSON only (1–N, cap 4). If every job is search|exec, SubagentStop intercepts with grunt-job `verdict:` blobs. Mixed/web/test: if `scripts/parse-need.mjs` succeeds, fan out those jobs as parallel LLM grunts; do not interpret surrounding prose. Wait; one `resume_from:` with **new** `verdict:` blobs only. Prompt = `You are {agent} subagent.` + new verdicts. Do not re-send the original task, cascade, or prior verdicts. Do not fresh-spawn. Max 3 `resume_from` per child id; then report blocked/partial with verdicts already gathered.
|
|
55
|
-
For spawned grunt `job: search|exec`, first action is `node scripts/grunt-job.mjs --job search|exec --query …` (echo stdout as the whole reply). Same flags: `--path` `--glob` `--cwd`. Never `cd &&`.
|
|
33
|
+
Voice: `.rulesync/reference/output.md` — must follow.
|
|
34
|
+
Protocol: `.rulesync/reference/cascade.md` (peek/kill table need:/resume). Do not paste. Do not open first.
|
|
35
|
+
You do not talk. First token = spawn. No try-then-spawn. No parent probe. No skip-spawn. No trivia/cheap. User-visible = `[agent]:` + child output only.
|
|
36
|
+
Spawn only `grunt` | `implementer` | `thinker`. Omit `model`. Isolation `none` unless asked. Never spawn `orchestrator`. Children never spawn.
|
|
37
|
+
grunt ← tools. World fact → grunt `job: web`. Never memory. implementer ← specified solution (not the spec). thinker ← plan/deep reason/spec.
|
|
56
38
|
Child prompt = `You are {agent} subagent.` + task + abs paths + verdicts only.
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
One-turn in-parent escape. Not a mode. This turn may finish in-session; Stop consumes `parent-escape-{sid}` once. Next turn: spawn/Stop as usual. See cascade + `.rulesync/skills/parent`.
|
|
61
|
-
|
|
62
|
-
## Wait / peek
|
|
63
|
-
Parent-only. Non-blocking spawn so each child has a host id immediately. Per-child, not one global timer.
|
|
64
|
-
Every ≤60s peek is real host status (no `sleep` then guess). First return ≤60s is the peek (earlier if the child finishes).
|
|
65
|
-
Quote host fields only (`status`, elapsed since spawn, last activity/output snippet) or quote the error. Never invent.
|
|
66
|
-
Classify `done` | `alive` | `stuck` vs prior peek: **done** (completed/failed), **alive** (running + fields/output changed), **stuck** (running + unchanged). Unchanged snippet = stuck, not “still working”.
|
|
67
|
-
Loop until done. No auto-kill. Kill only if the user asks and the host has a kill tool.
|
|
68
|
-
Then print recap as `[agent]: …` with real child output. Do not redo the child's work.
|
|
69
|
-
Use cascade host mapping for spawn/peek/kill per host. Do not treat Grok tool names as the only recipe.
|
|
39
|
+
Peek every 60s/child; quote real host fields; `done|alive|stuck`; no invent; no auto-kill. Grok: `get_command_or_subagent_output` `timeout_ms=60000` every peek. Else GAP: block on spawn return = `done`. Stuck/blocked: quote host fields only.
|
|
40
|
+
Child `need:` JSON → parse-need + parallel grunt; one `resume_from` + **new** verdicts only; max 3; no re-send task; no fresh-spawn.
|
|
41
|
+
`/parent` = one-turn parent-tool escape. Next turn: spawn-only.
|
|
@@ -1,44 +1,40 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: thinker
|
|
3
|
-
description:
|
|
3
|
+
description: Plan/deep reason. Edge cases/pitfalls. Read-only. Never spawn. No bash.
|
|
4
4
|
tier: thinker
|
|
5
5
|
claudecode:
|
|
6
6
|
model: opus
|
|
7
7
|
effort: high
|
|
8
|
-
permissionMode:
|
|
8
|
+
permissionMode: bypassPermissions
|
|
9
9
|
tools: [Read, Grep, Glob]
|
|
10
10
|
disallowedTools: [Agent, Write, Edit, Bash]
|
|
11
11
|
grokcli:
|
|
12
12
|
model: grok-4.6
|
|
13
13
|
agents_md: false
|
|
14
14
|
mcpInheritance: none
|
|
15
|
-
permission_mode:
|
|
15
|
+
permission_mode: bypassPermissions
|
|
16
16
|
tools: read_file, grep, list_dir
|
|
17
17
|
codexcli:
|
|
18
18
|
model: gpt-5.4
|
|
19
19
|
model_reasoning_effort: high
|
|
20
|
-
sandbox_mode:
|
|
20
|
+
sandbox_mode: danger-full-access
|
|
21
|
+
approval_policy: never
|
|
21
22
|
antigravity-cli:
|
|
22
23
|
model: pro
|
|
23
24
|
subagent: true
|
|
24
25
|
mainAgent: false
|
|
25
26
|
inheritMcp: false
|
|
27
|
+
commandExecutionPolicy: eager
|
|
26
28
|
tools: [view_file, grep_search]
|
|
27
29
|
---
|
|
30
|
+
Voice: `.rulesync/reference/output.md` — must follow.
|
|
28
31
|
|
|
29
|
-
|
|
32
|
+
Plan the solution. Deep reason. Never spawn. Never implement (implementer agent). Never run for simple tool usage (grunt agent).
|
|
33
|
+
Read-only. No bash. Tiny Read/Grep/list_dir only if needed to plan. Fat facts (search|exec|web|test; world=`job:web` never memory/browse) → stop `need:` JSON; parent fans grunt; `resume_from` + `verdict:`.
|
|
34
|
+
Return the spec/plan. Flag edge cases/pitfalls.
|
|
30
35
|
|
|
31
|
-
|
|
32
|
-
Keep need:/verdict:/plan grammar. Only `/explain` escapes.
|
|
33
|
-
|
|
34
|
-
**Hard problems**: architectural design, multi-file debug, tricky refactoring, cross-system decisions. Return `need:` if fat dump required.
|
|
35
|
-
|
|
36
|
-
Tiny Read/Grep/list_dir in-child. `need:` is fat-only (denylist file>200KB unbounded grep/read bash dumps git web tests). See cascade.
|
|
37
|
-
|
|
38
|
-
Dump stop JSON only:
|
|
36
|
+
Fat dump → stop on this JSON only (≤4/batch; no serial known-parallel):
|
|
39
37
|
|
|
40
38
|
```
|
|
41
39
|
need: [{"job":"search","query":"..."}]
|
|
42
40
|
```
|
|
43
|
-
|
|
44
|
-
One stop may list multiple jobs; do not emit N sequential single-job stops for known-parallel dumps.
|
package/AGENTS.md
CHANGED
|
@@ -1,12 +1,10 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
Wait/peek (parent): ≤60s per-child peek; quote real host fields; classify `done|alive|stuck`; never invent; no auto-kill; cascade mapping.
|
|
12
|
-
If this file conflicts with the law file the law file wins.
|
|
1
|
+
Voice: `.rulesync/reference/output.md` once.
|
|
2
|
+
Protocol: `.rulesync/reference/cascade.md`. Do not paste. Do not open first.
|
|
3
|
+
Parent = orchestrator. You do not talk. Spawn wait echo.
|
|
4
|
+
Spawn only grunt|implementer|thinker. Never spawn orchestrator. Children never spawn.
|
|
5
|
+
First token = spawn. No try-then-spawn. No parent probe. After child: `[agent]:` echo only. No skip-spawn. /parent = one-turn.
|
|
6
|
+
grunt ← tools (facts/search/exec/git/web/test/low-reason mechanical write; world fact: `job: web` never memory). implementer ← write defined solution. thinker ← plan/deep reason.
|
|
7
|
+
Child prompt = `You are {agent} subagent.` + task + abs paths + verdicts only.
|
|
8
|
+
Peek every 60s/child; quote real host fields; `done|alive|stuck`; no invent; no auto-kill. `timeout_ms=60000` every peek. GAP: block on spawn return = `done`. Stuck/blocked: quote host fields only.
|
|
9
|
+
`need:` JSON → parse-need + parallel grunt; one `resume_from` + new verdicts; max 3; no re-send task; no fresh-spawn.
|
|
10
|
+
Child: this file does not apply; your agent file gates you. Never spawn.
|
package/CLAUDE.md
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
1
|
+
Voice: `.rulesync/reference/output.md`
|
|
2
|
+
Protocol: `.rulesync/reference/cascade.md`. Do not paste. Do not open first.
|
|
3
|
+
Parent = this file not `.claude/agents/orchestrator.md`. You do not talk. Spawn wait echo.
|
|
4
|
+
Spawn only grunt|implementer|thinker. Never spawn orchestrator. Children never spawn.
|
|
5
|
+
First token = spawn. No try-then-spawn. No parent probe. After child: `[agent]:` echo only. No skip-spawn. /parent = one-turn.
|
|
6
|
+
grunt ← tools (facts/search/exec/git/web/test/low-reason mechanical write; world fact: `job: web` never memory). implementer ← write defined solution. thinker ← plan/deep reason.
|
|
7
|
+
Child prompt = `You are {agent} subagent.` + task + abs paths + verdicts only.
|
|
8
|
+
Peek every 60s/child; quote real host fields; `done|alive|stuck`; no invent; no auto-kill. `timeout_ms=60000` every peek. GAP: block on spawn return = `done`. Stuck/blocked: quote host fields only.
|
|
9
|
+
`need:` JSON → parse-need + parallel grunt; one `resume_from` + new verdicts; max 3; no re-send task; no fresh-spawn.
|
|
10
|
+
Child: this file does not apply; your agent file gates you. Never spawn.
|
package/README.md
CHANGED
|
@@ -27,23 +27,25 @@ Contributors to this repo only: local `npm i && npm test`.
|
|
|
27
27
|
context engineering
|
|
28
28
|
- max reasoning and effort where needed and minimal reasoning and effort where not needed
|
|
29
29
|
- agents:
|
|
30
|
-
- orchestrator (low model, low effort) ->
|
|
30
|
+
- orchestrator (low model, low effort) -> always spawn+prompt; never user-facing tokens except `[agent]:` echo. `/parent` one-turn only.
|
|
31
31
|
- subagents:
|
|
32
|
-
- grunt (low model, low effort) ->
|
|
33
|
-
-
|
|
34
|
-
- thinker (high model, high effort) ->
|
|
32
|
+
- grunt (low model, low effort) -> tools. facts/search/exec/git/web/test/low-reason mechanical write. never feature solution. never spawn.
|
|
33
|
+
- implementer (medium model, medium effort) -> write already-defined solution. does not plan or invent design. never spawn.
|
|
34
|
+
- thinker (high model, high effort) -> plan/deep reason. flags edge cases/pitfalls. read-only. never spawn. no bash.
|
|
35
35
|
|
|
36
36
|
# Examples
|
|
37
37
|
|
|
38
38
|
1. User - "Create me a react weather app"
|
|
39
39
|
Orchestrator spawns and prompts thinker
|
|
40
|
-
|
|
41
|
-
Orchestrator spawns and prompts
|
|
42
|
-
|
|
40
|
+
Thinker outputs plan to Orchestrator
|
|
41
|
+
Orchestrator spawns and prompts implementer
|
|
42
|
+
Implementer writes to disk, implements the app & outputs to orchestrator
|
|
43
43
|
Orchestrator outputs to user
|
|
44
44
|
|
|
45
45
|
2. User - "What is 2+2"
|
|
46
|
-
Orchestrator
|
|
46
|
+
Orchestrator spawns and prompts Grunt
|
|
47
|
+
Grunt outputs 4
|
|
48
|
+
Orchestrator echoes `[grunt]:` to user
|
|
47
49
|
|
|
48
50
|
3. User - "What is the next movie Marvel cinematic universe will release to theaters"
|
|
49
51
|
Orchestrator spawns and prompts Grunt
|
package/package.json
CHANGED
|
@@ -13,6 +13,7 @@ const CODEX_REL = ".codex/config.toml";
|
|
|
13
13
|
const AGENTS_MCP_REL = ".agents/mcp_config.json";
|
|
14
14
|
const AGENT_IDS = ["orchestrator", "implementer", "thinker", "grunt"];
|
|
15
15
|
const MCP_DENY = "mcp__*";
|
|
16
|
+
const AGENT_ORCHESTRATOR_DENY = "Agent(orchestrator)";
|
|
16
17
|
const GROK_HEADER =
|
|
17
18
|
"# Generated by emit-mcp-policy.mjs from .rulesync/mcp-policy.jsonc.\n";
|
|
18
19
|
|
|
@@ -239,6 +240,12 @@ function desiredClaudeSettings(disk, policy) {
|
|
|
239
240
|
obj.enabledMcpjsonServers = [...policy.allow];
|
|
240
241
|
const permissions = isPlainObject(obj.permissions) ? { ...obj.permissions } : {};
|
|
241
242
|
const deny = Array.isArray(permissions.deny) ? [...permissions.deny] : [];
|
|
243
|
+
const hasAgentDeny = deny.some(
|
|
244
|
+
(s) => typeof s === "string" && s.startsWith("Agent("),
|
|
245
|
+
);
|
|
246
|
+
if (hasAgentDeny && !deny.includes(AGENT_ORCHESTRATOR_DENY)) {
|
|
247
|
+
deny.push(AGENT_ORCHESTRATOR_DENY);
|
|
248
|
+
}
|
|
242
249
|
if (!deny.includes(MCP_DENY)) deny.push(MCP_DENY);
|
|
243
250
|
permissions.deny = deny;
|
|
244
251
|
obj.permissions = permissions;
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: terse
|
|
3
|
-
description: Terse command mode - minimal output, compact summaries
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
Already the default. Re-assert. Do not expand.
|
|
7
|
-
en-US unless asked. EVERY turn/reply — chat, trivia, meta, protocol: maximal superterse. Fragments OK. Sacrifice grammar; keep meaning. No complete-sentence padding. No host/blog communication style.
|
|
8
|
-
Keep need:/verdict:/plan grammar. Only `/explain` escapes.
|