Setting Up Pi Subagents Because I Keep Doing 2 Dumb Things
The creator installs the npm 'sub-agents' package onto the lean Pi agent harness to fix two habits — a bloating main system prompt and spawning a new terminal tab per task — by delegating scoped work to named sub-agents (scout, oracle, reviewer, researcher, planner, worker) that run in the background and report results back via intercom.
Eric MichaudWatchTranscript found
Quick learning frame
Read this before watching.
A model becomes useful when it is wrapped in a harness: tools, state, permissions, memory, routing, and verification.
New playlist item from Eric Michaud; queued for transcript-backed review, topic mapping, and a practical learning artifact.
Skill you build: Setting up and orchestrating Pi sub-agents so a lean main agent delegates scoped tasks to background workers, keeping the system prompt minimal and context-window usage low.
Watch for the shift from claim to mechanism. The learning value is the point where the transcript reveals a repeatable action, tool boundary, context move, review habit, or artifact.
Concept diagram
Where this video fits.
01Intent
02Model
03Harness
04Tools
05Verifier
06Artifact
Deep lesson
Turn this video into working knowledge.
2,867 cleaned transcript words reviewed across 808 timed caption segments.
Thesis
Setting Up Pi Subagents Because I Keep Doing 2 Dumb Things teaches a practical agent architecture move: The creator installs the npm 'sub-agents' package onto the lean Pi agent harness to fix two habits — a bloating main system prompt and spawning a new terminal tab per task — by delegating scoped work to named sub-agents (scout, oracle, reviewer, researcher, planner, worker) that run in the background and report results back via intercom.
The goal is not to remember the video. The goal is to extract the operating principle, tie it to timestamped evidence, test how far the claim transfers, and make something reusable.
0:20
Why sub-agents
“why to install sub agents onto our pie harness. Let's get into it. All right, quick catch up for those of you still using Claude code or Codex or whatever. Pie is an agent harness just like those...”
Two failure modes motivate this: the Pi system prompt keeps growing as you add skills/MCP servers, and opening a fresh terminal per task just re-passes that same bloated prompt to every session, saving no tokens. Audit your own harness setup and list which skills, MCP servers, and 'remember this' additions have crept into your main system prompt, then mark which could instead live in a scoped sub-agent.
4:04
Install and roles
“different agents that they've got, right? Like um scout, researcher, planner, worker, reviewer, context builder, oracle, delegate, right? So, I think I just want these guys for now. So, this is interesting. It's taking a lot of the...”
Install via 'pie install npm sub-agents'; a version mismatch between an old Pi and the newer sub-agent package breaks it, so update Pi first. Each agent (scout=context summarization, oracle=second opinion/challenge, worker=scoped execution, reviewer) needs the top agent's prompt to define who does what, what context they get, foreground vs background, and success criteria. Run the install, fix any version mismatch, then run sub-agent doctor to inventory the available agents and watch for stray symlinks from prior tools polluting the agent list.
10:38
Background chaining
“main system prompt now, you know, like the one for my baseline pi agent to trim it back and make sure that we're not giving all this extra context to every agent. I'd like you to use the...”
Running '/run scout' lands in foreground (same as one terminal); you must explicitly 'launch scout background' to offload it, and you can dictate chains in plain language (scout gathers context, then oracle critiques it) that run async while intercom sends completed results back to the main session. Practice launching a scout-then-oracle chain in the background by plain-language instruction, then confirm the intercom 'completed' message returns and check your remaining context window percentage.
01
Intent
Start with this video's job: The creator installs the npm 'sub-agents' package onto the lean Pi agent harness to fix two habits — a bloating main system prompt and spawning a new terminal tab per task — by delegating scoped work to named sub-agents (scout, oracle, reviewer, researcher, planner, worker) that run in the background and report results back via intercom. Treat "Intent" as the outcome you are trying to make visible, not a topic label. Anchor it to 0:20, where the video says: “why to install sub agents onto our pie harness. Let's get into it. All right, quick catch up for those of you still using Claude code or Codex or whatever. Pie is an agent harness just like those...”
02
Model
Use "Model" to locate the part of the agent architecture workflow the video is demonstrating. Ask what changes in your real setup if this claim is true. Anchor it to 4:04, where the video says: “different agents that they've got, right? Like um scout, researcher, planner, worker, reviewer, context builder, oracle, delegate, right? So, I think I just want these guys for now. So, this is interesting. It's taking a lot of the...”
03
Harness
Turn "Harness" into the reusable artifact for this lesson: A one-page agent harness map with tool boundaries and proof signals. This is where watching becomes something you can inspect and reuse.
04
Tools
Use "Tools" as the application surface. Decide whether the idea touches a browser flow, a local file, a model choice, a source document, a UI, or a review step.
05
Verifier
Use "Verifier" to prove the lesson. The evidence should connect back to the video title, transcript anchors, and a concrete output, not a generic best-practice claim.
06
Artifact
Use "Artifact" to carry the idea forward: save the prompt, checklist, diagram, or operating rule that would make the next agent run better.
Example
Source-backed work packet
Convert the video into a scoped task that includes the transcript claim, target workflow, acceptance criteria, and proof. The output should be a one-page agent harness map with tool boundaries and proof signals..
Example
Claim vs. demo brief
Separate what the speaker claims, what the demo actually proves, and what still needs outside verification before you adopt the workflow.
Example
Teach-back module
Transform the lesson into a definition, a mechanism diagram, one misconception, one practice exercise, and a check-for-understanding question.
Do not learn it wrong
Treating the title as the lesson without checking what the transcript actually says.
Letting the prompt drift into generic advice that could apply to any video in the playlist.
Copying the tool setup without identifying the operating principle that transfers to your own stack.
Skipping the artifact, which means the learning never becomes operational or inspectable.
Do not count this as learned until these are true.
01
State the transcript-backed claim in your own words: The creator installs the npm 'sub-agents' package onto the lean Pi agent harness to fix two habits — a bloating main system prompt and spawning a new terminal tab per task — by delegating scoped work to named sub-agents (scout, oracle, reviewer, researcher, planner, worker) that run in the background and report results back via intercom.
02
Explain the practical stakes without hype: New playlist item from Eric Michaud; queued for transcript-backed review, topic mapping, and a practical learning artifact.
03
Map the idea onto the Intent -> Model -> Harness -> Tools -> Verifier -> Artifact sequence and name the weakest link.
04
Produce the artifact and include the evidence that proves it: A one-page agent harness map with tool boundaries and proof signals.
Put it into practice
Give this grounded prompt to Codex or Claude after watching.
You are helping me turn one specific YouTube video into real, durable learning.
Source video:
- Title: Setting Up Pi Subagents Because I Keep Doing 2 Dumb Things
- URL: https://www.youtube.com/watch?v=t70YWb03vm0
- Topic: Agent Architecture
- My current learning frame: Install the Pi sub-agents package, define three minimal agents (scout, oracle, reviewer) in your main prompt, then dictate a background scout-to-oracle chain and verify results come back via intercom while your main context window stays under 10%.
- Why this matters: New playlist item from Eric Michaud; queued for transcript-backed review, topic mapping, and a practical learning artifact.
Transcript anchors from this exact video:
- 0:20 / Evidence 1: "why to install sub agents onto our pie harness. Let's get into it. All right, quick catch up for those of you still using Claude code or Codex or whatever. Pie is an agent harness just like those..."
- 2:17 / Evidence 2: "review, right? So, with that, in the top agent system prompt, I need to tell it exactly who does what, what context those agents need, whether it's a foreground or background task, what needs to be reviewed once..."
- 4:04 / Evidence 3: "different agents that they've got, right? Like um scout, researcher, planner, worker, reviewer, context builder, oracle, delegate, right? So, I think I just want these guys for now. So, this is interesting. It's taking a lot of the..."
- 6:07 / Evidence 4: "if it matches where I'm going with the task today. So, the agent reviewer working in the background. Okay, this is working the way that I wanted it to now. Reviewer says Scout is mostly aligned. Today's video..."
- 8:10 / Evidence 5: "one. Sounds great. I don't want to go down this rabbit hole quite yet. I'm just going to see one more thing here, too. Is there a way to assign different models and thinking levels to these different..."
- 10:38 / Evidence 6: "main system prompt now, you know, like the one for my baseline pi agent to trim it back and make sure that we're not giving all this extra context to every agent. I'd like you to use the..."
- 12:12 / Evidence 7: "context on different angles that I want to look up for a YouTube video and then turn that into a brief for me, right? Like these sub-agents are going to be super super good in making sure things..."
Your task:
1. Use the transcript anchors above as the primary source packet. If you add outside context, label it clearly as outside context and keep it secondary.
2. Create a source-check table with columns: timestamp, claim, what the demo proves, confidence, and what still needs verification.
3. Extract the actual teachable claims from the video. Do not invent claims that are not supported by the title, lesson frame, or transcript anchors.
4. Build a reusable learning artifact: A one-page agent harness map with tool boundaries and proof signals.
5. Include:
- a plain-English definition of the core idea
- a diagram or structured model using this sequence: Intent -> Model -> Harness -> Tools -> Verifier -> Artifact
- 3 concrete examples that apply the video idea to real agentic work
- 2 failure modes the video helps prevent
- a checklist I can use the next time I run Codex or Claude
- one practical exercise with a clear done signal
6. Add a "learning transfer" section: what changes in my workflow tomorrow if I actually learned this?
7. Add a "source check" section that cites which transcript anchor supports each major takeaway.
Quality bar:
- Make this specific to "Setting Up Pi Subagents Because I Keep Doing 2 Dumb Things", not a generic Agent Architecture essay.
- Prefer operational examples, failure modes, and reusable artifacts over broad definitions.
- Call out uncertainty instead of smoothing over weak evidence.
- If evidence is weak, say what transcript segment or timestamp needs review instead of guessing.
- Finish with a concise artifact I could paste into my learning app.
Misconceptions
What to stop believing.
A better model automatically makes a better agent.
The model matters, but harness design determines whether the system can act safely and repeatably.
More tools always help.
Every tool increases surface area. Strong agents have the right tools with clear permissions.
Memory means saving everything.
Useful memory is compressed, curated, and tied to future decisions.
Practice studio
Learning only counts when you make something.
01
Transcript evidence map
Separate what the video actually says from what you already believe about the topic.
3 source-backed takeaways with timestamps, confidence, and a transfer note.02
One useful artifact
Apply the video to a real workflow and produce a one-page agent harness map with tool boundaries and proof signals..
A reusable artifact with a done signal and one verification step.03
Teach-back card
Explain the lesson to someone who has not watched the video yet.
A 90-second explanation, one diagram, one example, and one misconception to avoid.
Recall check
Answer first, then reveal — without rewatching.
What two 'dumb things' is the creator trying to fix with Pi sub-agents, and why does opening a new terminal per task fail to solve them?
What broke the sub-agents install, how was it fixed, and what roles do the scout and oracle agents play?
When you run '/run scout', where does it execute by default, and what must you do instead to offload it — and what sends results back?
Source shelf
Use the video as a doorway, then verify with primary sources.