The argument in one line.
Running three AI sub-agents with separate context windows that document their reasoning to a shared file lets you make decisions based on competing perspectives without the sycophancy that plagues single-agent advice.
Read if. Skip if.
- You're a founder or product manager making strategic decisions and want multiple independent perspectives on ideas before committing without groupthink or agreement bias.
- A Claude Code user who's hitting context window limits on long projects and needs a way to parallelize thinking tasks while keeping your main session clean.
- You're experimenting with AI workflows beyond chat and want a concrete, replicable pattern for building decision-making systems that show their work.
- You've never used Claude Code before — this assumes comfort with the platform's basics and focuses on advanced agent architecture, not foundational setup.
- You're looking for ways to deploy this in production or integrate it into customer-facing applications — this is a personal/internal decision-making tool pattern.
The full version, fast.
Claude Code sub-agents have a non-obvious use case beyond code review: running parallel reasoning sessions for business decisions with each agent working in a fresh context window rather than a single bloated conversation. The setup involves creating three named sub-agents — an optimist, a devil's advocate, and a neutral analyst — each configured in the project's .claude folder. A shared_reasoning.md file acts as a monitoring layer where each agent documents its thinking in real time. When a decision prompt is submitted, all three run in parallel, write their conclusions to the shared file, and the main session synthesizes across them without sycophancy bias. The result is structured multi-perspective analysis on any idea, business question, or plan — with no technical coding required.
Chat with this breakdown — free.
Sign in and you get 23 free chat messages on us — ask for the hook, quote a framework, find the exact transcript moment, generate a markdown action plan. Bring your own key when you want unlimited.
Create a free account →Where the time goes.

01 · Cold open: the gap nobody covers
Sub-agents for nontechnical decision-making: brainstorming, planning, product decisions. Teases the monitoring trick.

02 · Why sub-agents beat one long context
Hallucination climbs past 40-50% context fill. Each agent gets a fresh 200K window. Compaction is nondeterministic.

03 · Architecture: the council + shared_reasoning.md
Optimist (best case), Devil's Advocate (stress-test), Neutral (synthesize). Shared file = paper trail of agent thoughts.

04 · Terminal demo: /agents + Create new agent
Asks Claude to list built-in sub-agents. Navigates to /agents, manage configuration, create new agent at project level.

05 · Building the Optimist Strategist
2-sentence brief, Claude writes the full system prompt. Assigns Sonnet, picks green. Agent file at .claude/agents/optimist-strategist.md.

06 · Building the Devil's Advocate
Same flow: pessimistic but with nuance. Red color, Sonnet. Description: stress-testing, blind spots, hidden risks.

07 · /initialize + CLAUDE.md + agents gather trigger
Claude writes CLAUDE.md documenting the council. Mark adds agents gather trigger phrase and shared_reasoning.md documentation requirement.

08 · Adding the Neutral Analyst (blue)
Claude auto-reads existing agent files, writes neutral-analyst.md. Updated council: green/red/blue.

09 · Critical: test in a fresh session
Context contamination from the build session causes false positives. Always open a new Claude Code instance before stress-testing CLAUDE.md.

10 · Live demo: AI Avatar Academy
Real business idea submitted: cron job scrapes AI news, HeyGen clones avatar, auto-generates lessons. All three agents invoked in parallel.

11 · Council report + convergence
Optimist: real-time AI literacy infrastructure. Devil's Advocate: HeyGen costs $60-80/min, ToS scraping issues, legal gray. Neutral: technical high, market low-medium. Consensus: validate-first.

12 · Make them fight + shared_reasoning.md reveal
Agents debate each other in a second pass. shared_reasoning.md shows structured per-agent reasoning with confidence levels.

13 · CTA
Agent MD files + prompts in description link 2. Paid community in link 1.
Lines worth screenshotting.
- A three-agent AI council (optimist, neutral, devil's advocate) running in parallel sub-agents produces better decisions than a single Claude session because each agent operates in a fresh context window without sycophantic contamination.
- Each sub-agent writes its reasoning to a shared markdown file (shared_reasoning.md) so the main session can synthesize all perspectives without collapsing them into a single biased thread.
- Sub-agents can simulate a structured debate — one agent argues for, one argues against, one stays neutral — and Claude synthesizes across those positions without defaulting to agreement with the user.
- Hallucination and quality degradation become measurable problems at 40-50% context window usage — sub-agents with fresh windows are the architectural fix, not prompt engineering.
- Sub-agent tasks should be independent (no dependencies between them) or sequential (one baton-passes to the next) — mixing these patterns produces coordination failures.
- The shared reasoning file approach is a low-complexity monitoring system: you can watch what agents are doing without building a dashboard by simply reading the file as it updates.
- Using sub-agents for nontechnical work (brainstorming, business validation, decision analysis) is underexplored — most documentation focuses on code review and parallel test runs.
- Treating Claude like ChatGPT in a single long conversation causes compaction to make nondeterministic choices about what context to keep, which degrades later output in ways that are hard to diagnose.
- The optimum sub-agent hire rate is the same as the optimum hire rate for a bootstrapped startup — only when the task is clearly independent and the value of parallel execution exceeds the coordination overhead.
- Creating sub-agents through the slash agents → manage configuration → create new agent flow gives project-level agents (scoped to the repo) or global agents (persistent across all projects).
- Having an agent generate its sub-agent prompt via dictation (describing the role in plain language) produces better-scoped agent instructions than manually writing the system prompt.
- A validated business idea tested against an optimist, a neutral, and a devil's advocate before committing to build it is faster and cheaper than building, launching, and discovering the problems after.
Three brains, zero sycophancy.
The AI Council is the structural fix for the yes-man problem: three agents with opposing mandates, all writing reasoning to a shared file before the main session synthesizes.
- Create three agent files: Optimist, Devil's Advocate, Neutral Analyst. Each gets a 2-sentence brief; Claude writes the full system prompt.
- Add 'agents gather' as a trigger phrase in CLAUDE.md — maps to parallel Task-based launch of all three agents.
- Require each agent to document its thinking in shared_reasoning.md as it works, not just at the end.
- Always stress-test in a fresh session — the build session context will mask a broken CLAUDE.md.
- Let them fight: a second pass where agents debate each other surfaces the convergence zone.
- Apply to any product or offer decision before building — costs 150K tokens and 5 minutes.
Terms worth knowing.
- Sub-agent
- A separate AI assistant spawned by a main coding assistant to handle a specific task in its own isolated context window. Sub-agents can run in parallel and report results back without cluttering the main session.
- Claude Code
- Anthropic's command-line coding assistant that runs in a terminal and can execute multi-step tasks, edit files, and spawn sub-agents. Often used as a primary development environment instead of a traditional IDE chat panel.
- Context window
- The total amount of text a language model can hold in working memory during a single conversation. Once it fills up, earlier content must be compressed or dropped, which often degrades response quality.
- Compaction
- An automatic process that compresses a long conversation into a shorter summary so the session can continue without exceeding the context window. The model decides what to keep, which can be unpredictable and lossy.
- Vibe coding
- An informal style of building software by describing intent in natural language and letting an AI assistant generate and edit the code, rather than writing it line by line. Speed and iteration are prioritized over manual craftsmanship.
- Hallucination
- When a language model produces confident output that is factually wrong or invented. The risk rises as the context window fills up and the model loses focus on the original task.
- Markdown file
- A plain-text file using lightweight formatting symbols for headings, lists, and emphasis. Commonly used by AI tools as a shared scratchpad because both humans and models can read and edit it easily.
- Sycophancy
- A language model's tendency to agree with and flatter the user instead of pushing back. It produces validating answers even when a critical or contrary response would be more useful.
- Dangerously skip permissions
- A Claude Code flag that lets the assistant run shell commands and file edits without asking for confirmation on each action. It speeds up workflows but removes the safety prompt before potentially destructive operations.
- Slash command
- A shortcut typed with a leading forward slash inside an AI coding tool to trigger a built-in action, such as `/agents` to manage sub-agents or `/init` to scaffold a project file.
- MCP
- Model Context Protocol, an open standard that lets AI assistants connect to external tools, data sources, and APIs through a consistent interface. It is how sub-agents and main sessions gain capabilities like web search or database access.
- Sonnet
- A mid-tier Anthropic Claude model that balances speed and cost against the more expensive Opus tier. Often chosen for sub-agents that don't require the deepest reasoning.
- Opus
- Anthropic's top-tier Claude model, used when maximum reasoning quality matters. It costs more per token than Sonnet or Haiku and is typically reserved for complex planning or writing tasks.
- CLAUDE.md
- A project-level instructions file that Claude Code reads at the start of every session in that folder. It defines persistent rules, conventions, and orchestration logic the assistant should follow.
- Cron job
- A scheduled task that runs automatically at fixed times or intervals on a server. Used here to describe an automated process that continuously checks for new AI announcements to scrape.
- HeyGen
- A platform that generates realistic AI video avatars from a short recording of a real person. Its API lets developers programmatically produce talking-head videos at scale without filming.
- API
- An application programming interface, the contract that lets one piece of software call another. Developers use a service's API to automate it instead of clicking through its website.
- Token
- The unit of text a language model reads and generates, roughly equivalent to a short word or word fragment. Context windows, pricing, and usage limits are all measured in tokens.
Things they pointed at.
Lines you could clip.
“Claude typically loses focus, starts its hallucination nation journey around 40 to 50% of the context window being used.”
“Hire a sub agent the same way you would hire an employee if you were a bootstrap startup.”
“Make them fight each other. I told you. It's very scientific.”
Word for word.
Don't just watch it. Burn it in.
See every word as it's spoken — crank it to 2× and still catch all of it. The same dual-channel trick behind Amazon's Kindle + Audible.
The bait, then the rug-pull.
The nontechnical use of sub-agents is the gap nobody is covering. While developers run parallel code reviews, Mark Kashef is spinning up a three-voice AI council to make better business and product decisions without inflating a single context window.
Named ideas worth stealing.
The AI Council Pattern
- Optimist Strategist (green)
- Devil's Advocate (red)
- Neutral Analyst (blue)
- shared_reasoning.md audit log
- agents gather trigger phrase
Three complementary sub-agents run in parallel on any decision. Each documents reasoning in a shared file. Main session synthesizes without sycophancy bias.
Context Window Economics
Hallucination risk climbs past 40-50% context fill. Three agents at 50K tokens each = 150K total across three prime-condition sessions. One session doing the same work hits 80-90%.
Fresh Session Stress Test
Always open a brand new Claude Code session before testing your CLAUDE.md orchestration. The build session has context in memory and will execute even with a broken config.
How they asked for the click.
“I'll make them available to you in the second link in the description below”
Dual CTA: free agent files + prompts in link 2, paid community in link 1. Clean and non-pushy.



































































