docs: supervisor prompt + agent-profile ideas + supervisor-lab port plan#37
Merged
Conversation
Four AgentProfile sketches for the research/knowledge domain (researcher worker, verifier driver, research supervisor, thin dedup-verifier), informed by emilkowalski/skills' skill shape and the dedup insight (the verifier is a thin lens over the deterministic validator, not a heavy re-judge). Each sketch names the real primitive it composes in agent-knowledge or supervisor-lab. Records supervisor-lab status (exists at tangle-network/supervisor-lab, the two-agent loop is already ported as bench/supervise-topology.ts) and a concrete plan to land these profiles + wire the thin verifier gate into it.
tangletools
approved these changes
Jun 25, 2026
tangletools
left a comment
Contributor
There was a problem hiding this comment.
✅ Auto-approved PR — 292a41db
Blanket team auto-approval is enabled for this reviewer service.
The full PR reviewer audit still runs separately and will publish findings if it detects issues.
tangletools · auto-approval · reason: blanket_auto_approve · 2026-06-25T01:18:57Z
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
docs/supervisor-profiles.md— a design doc with fourAgentProfilesketches for the research/knowledge domain, informed byemilkowalski/skillsand the existing Tangle supervisor stack.What's in it
Four profile sketches (system prompt + tools + when-to-use), each naming the real primitive it composes (so building is "assemble", not "invent"):
grounded-researcher(leaf worker) — already exists twice (researcherProfilehere,grounded-researcher.tsin supervisor-lab); the doc is the canonical shape both converge on.verifier-driver(the gate, not the judge) — composesagent-runtime'sverify({implement, verifier})combinator; selector ≠ judge.research-supervisor(ground → fan-out → gate → fuse → recurse) — the research-specialized merge of supervisor-lab's existing driver archetypes.dedup-verifier(thin, cheap, mostly deterministic) — the emilkowalski dedup lesson as a profile: the "taste" lives in the deterministic validator (createResearcherValidator, thelint/validateCLI), the verifier is a thin lens that runs the cheap check first and escalates to an LLM only for the one semantic residual.What we borrowed from the skills repo
Tight two-field frontmatter, terse non-negotiable numbered rules over prose, "default to flagging; approval is earned" (verifier posture),
disable-model-invocation(verifier is routed, not auto-invoked), and cheap-because-narrow (generate vs. judge separation — the reason the judge can be thin).supervisor-lab status
It exists (
tangle-network/supervisor-lab) and the two-agent loop is already ported asbench/supervise-topology.ts(supervisor mounts the coordination MCP over a liveScope/Supervisor, authors worker profiles as code, spawns/drains/steers, grades on a real judge; OFFLINE $0 + LIVE paths). The doc records this and gives a concrete plan to land the two new profiles + wire the thin verifier gate into the existing harness (newBENCH=researcharm grading viacreateResearcherValidator), rather than rebuilding anything.Docs-only.
CI=true pnpm installclean; merges cleanly intomain. Do not merge — for review.