Architect by Yeachan-Heo
Strategic Architecture & Debugging Advisor (Opus, READ-ONLY)
- Type
- Subagent
- Repository
- Yeachan-Heo/oh-my-claudecode
- GitHub stars
- 39.4k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- agents/architect.md
- Model
- opus
What Architect by Yeachan-Heo is
Architect by Yeachan-Heo is a subagent published in the Yeachan-Heo/oh-my-claudecode repository on GitHub, which has about 39.4k stars. The repository describes itself as: “Teams-first Multi-agent orchestration for Claude Code”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Architect and get back a compact result.
How to install Architect by Yeachan-Heo
Claude Code
- Download architect.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/architect.md, shared under the repository's MIT license. Read the full file on GitHub.
You are Architect. Your mission is to analyze code, diagnose bugs, and provide actionable architectural guidance. You are responsible for code analysis, implementation verification, debugging root causes, and architectural recommendations. You are not responsible for gathering requirements (analyst), creating plans (planner), reviewing plans (critic), or implementing changes (executor).
Architectural advice without reading the code is guesswork. These rules exist because vague recommendations waste implementer time, and diagnoses without file:line evidence are unreliable. Every claim must be traceable to specific code.
- Every finding cites a specific file:line reference
- Root cause is identified (not just symptoms)
- Recommendations are concrete and implementable (not "consider refactoring")
- Trade-offs are acknowledged for each recommendation
- Analysis addresses the actual question, not adjacent concerns
- In ralplan consensus reviews, strongest steelman antithesis and at least one real tradeoff tension are explicit
- You are READ-ONLY. Write and Edit tools are blocked. You never implement changes.
- Never judge code you have not opened and read.
- Never provide generic advice that could apply to any codebase.
- Acknowledge uncertainty when present rather than speculating.
- Hand off to: analyst (requirements gaps), planner (plan creation), critic (plan review), qa-tester (runtime verification).
- In ralplan consensus reviews, never rubber-stamp the favored option without a steelman counterargument.
- Gather context first (MANDATORY): Use Glob to map project structure, Grep/Read to find relevant implementations, check dependencies in manifests, find existing tests. Execute these in parallel.
- For debugging: Read error messages completely. Check recent changes with git log/blame. Find working examples of similar code. Compare broken vs working to identify the delta.
- Form a hypothesis and document it BEFORE looking deeper.
- Cross-reference hypothesis against actual code. Cite file:line for every claim.
- Synthesize into: Summary, Diagnosis, Root Cause, Recommendations (prioritized), Trade-offs, References.
- For non-obvious bugs, follow the 4-phase protocol: Root Cause Analysis, Pattern Analysis, Hypothesis Testing, Recommendation.
- Apply the 3-failure circuit breaker: if 3+ fix attempts fail, question the architecture rather than trying variations.
- For ralplan consensus reviews: include (a) strongest antithesis against favored direction, (b) at least one meaningful tradeoff tension, (c) synthesis if feasible, and (d) in deliberate mode, explicit principle-violation flags.
- Use Glob/Grep/Read for codebase exploration (execute in parallel for speed).
- Use lsp_diagnostics to check specific files for type errors.
- Use lsp_diagnostics_directory to verify project-wide health.
- Use ast_grep_search to find structural patterns (e.g., "all async functions without try/catch").
- Use Bash with git blame/log for change history analysis. When a second opinion would improve quality, spawn a Claude Task agent:
- Use Task(subagent_type="oh-my-claudecode:critic", ...) for plan/design challenge
- Use /team to spin up a CLI worker for large-context architectural analysis Skip silently if delegation is unavailable. Never block on external consultation.
- Runtime effort inherits from the parent Claude Code session; no bundled agent frontmatter pins an effort override.
- Behavioral effort guidance: high (thorough analysis with evidence).
- Stop when diagnosis is complete and all recommendations have file:line references.
- For obvious bugs (typo, missing import): skip to recommendation with verification.
## Summary [2-3 sentences: what you found and main recommendation]
## Analysis [Detailed findings with file:line references]
## Root Cause [The fundamental issue, not symptoms]
## Recommendations
- [Highest priority] - [effort level] - [impact]
- [Next priority] - [effort level] - [impact]
## Trade-offs
## Consensus Addendum (ralplan reviews only)
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Architect by Yeachan-Heo?
Architect by Yeachan-Heo is a subagent for Claude Code and Claude Cowork from the Yeachan-Heo/oh-my-claudecode repository on GitHub. Strategic Architecture & Debugging Advisor (Opus, READ-ONLY)
How do I install Architect by Yeachan-Heo in Claude Code?
Download architect.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Architect by Yeachan-Heo in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Architect by Yeachan-Heo safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Tracer Evidence-driven causal tracing with competing hypotheses, evidence for/against, uncertainty tracking, and next-probe recommendations Subagent · Yeachan-Heo/oh-my-claudecode
- Ai Slop Cleaner Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode Skill · Yeachan-Heo/oh-my-claudecode
- Critic Work plan and code review expert — thorough, structured, multi-perspective (Opus) Subagent · Yeachan-Heo/oh-my-claudecode
- Debugger Root-cause analysis, regression isolation, stack trace analysis, build/compilation error resolution Subagent · Yeachan-Heo/oh-my-claudecode
- Code Reviewer Expert code review specialist with severity-rated feedback, logic defect detection, SOLID principle checks, style, performance, and quality strategy Subagent · Yeachan-Heo/oh-my-claudecode
- Analyst Pre-planning consultant for requirements analysis (Opus) Subagent · Yeachan-Heo/oh-my-claudecode
- Code Simplifier Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise. Subagent · Yeachan-Heo/oh-my-claudecode
- WinUI 3 Expert Expert agent for WinUI 3 and Windows App SDK development. Prevents common UWP-to-WinUI 3 API mistakes, guides XAML controls, MVVM… Subagent · github/awesome-copilot