A Field-Tested Method for Managing a 700,000-Line Codebase with Claude Code

·Toolin Editorial Team

Build a three-layer context system with CLAUDE.md, Skills, and MCP so the AI truly understands your codebase — with a comparison against OpenAI's Symphony parallel-orchestration approach

A Field-Tested Method for Managing a 700,000-Line Codebase with Claude Code

A 700,000-line C# codebase. The core developer graduated and left. Feature modules sat frozen for three years, too risky for anyone to touch. Brendan MacLean, lead developer at the MacCoss Lab at the University of Washington, used Claude Code to finish this abandoned build in two weeks. His method wasn't making the AI smarter — it was giving the AI a complete context system, the way you'd bring up an intern. This article breaks down exactly how he did it, alongside a comparison with Symphony, the parallel orchestration scheme OpenAI shipped the same day.

The Core Idea: Bring Up the AI Like an Intern

Brendan's insight is plain: every time a newcomer joins the lab, they don't know the project's full picture, how the code fits together, or the unwritten rules. The difference is that a newcomer learns over time, while Claude forgets everything the moment a conversation ends.

So his core strategy: turn tacit knowledge into explicit, AI-readable assets.

The Three-Layer Context System

Layer 1: CLAUDE.md — the Project's Terrain Map

Brendan set up a separate repository, pwiz-ai, dedicated to context written for the AI to read. The CLAUDE.md at the root is the 'terrain map,' telling Claude:

  • What the project is and what it's for
  • The codebase structure
  • How to build it
  • The testing workflow

Project address: github.com/ProteoWizard/pwiz-ai

The key principle: CLAUDE.md solves 'knowing where things are.' It does not solve 'knowing how to do the work.'

Layer 2: Skills — the Domain Knowledge Base

The real domain expertise lives in skills. Brendan wrote a debugging skill, for example, described as 'always load when investigating bugs, failures, or unexpected behavior' — it forces Claude to do root-cause analysis before acting, instead of blind guessing and poking.

Layer 3: MCP — Let the AI See Real Data

Through MCP (Model Context Protocol) integration, Claude can read real test data, exception reports, and user tickets. With all three layers stacked, every interaction starts from 'already understands' instead of 'blank slate.'

The context system in action

Results in Practice

With the context in place, Brendan began clearing years of accumulated technical debt:

  • A three-year abandoned module: a test-management module written in Java, on a stack completely different from the main C# codebase. Done with Claude Code in a day.
  • 2,000+ tutorial screenshots: once maintained entirely by hand, now fully automated and nearly 100% reproducible.
  • A daily automatic report: generated by Claude, summarizing overnight test failures, exceptions, and unresolved tickets.
  • A brand-new feature dashboard: the developer in the lab least interested in AI coding tools built and shipped a brand-new data-visualization dashboard with Claude Code.

OpenAI's Answer: Symphony

The same week, OpenAI released the open-source project Symphony (over 18,000 stars on GitHub already).

Project address: github.com/openai/symphony

Symphony takes a completely different approach: it turns a Linear project board into the control center for AI coding. Every Issue in the Open state gets an Agent assigned automatically; the Agent keeps running in its own workspace and restarts automatically if it crashes.

In some teams' first three weeks on Symphony, the number of successfully merged PRs surged 500%.

The Symphony workflow

Choosing Between the Two Routes

DimensionClaude Code (deep context)Symphony (parallel orchestration)
Core philosophyContext quality decides everythingOrchestration efficiency decides everything
AnalogyMaster and apprenticeRunning an automated factory
Best forLarge legacy codebases, complex business logicTeam-level new projects, many parallel tasks
How knowledge is capturedCLAUDE.md + SkillsWORKFLOW.md + SPEC.md
Human's roleTeaching the AI the projectReviewing the results on the board

Shared finding: what used to travel by word of mouth and muscle memory now has to be written down in black and white before the AI can carry it. Whichever route you take, turning tacit knowledge into explicit assets is a step you cannot skip.

What You Can Do Now

If you're coding with AI assistance, three things worth doing today, whatever the tool:

  1. Write a CLAUDE.md (or your equivalent context file): project structure, build commands, test workflow, red-line rules — spelled out line by line.
  2. Turn common operations into Skills: debugging procedures, code-review checklists, deployment steps — so the AI never starts from zero.
  3. Keep the docs current: code on iteration 7 or 8 with docs still at version 1.0 is far too common. Stale docs are more dangerous than no docs.

Related articles

Xiaomi MiMo API Prices Cut Up to 99% for Good: How Developers Can Grab the Deal
AI Products

Xiaomi MiMo API Prices Cut Up to 99% for Good: How Developers Can Grab the Deal

Xiaomi's MiMo-V2.5 series API gets a permanent price cut of up to 99%, Token Plan allowances grow 5-8x, and pricing now squarely matches DeepSeek

Toolin Editorial Team
Darwin Skill 2.0: Let Your AI Skills Evolve on Their Own
AI Products

Darwin Skill 2.0: Let Your AI Skills Evolve on Their Own

darwin-skill 2.0 is an open-source Skill/Prompt auto-optimization tool that distills the best of two Microsoft papers, using multi-judge independent review plus human checkpoints to lift your AI skill documents from 80 points to over 90.

Toolin Editorial Team
An Open-Source Social Card Skill: Say Goodbye to AI-Looking Images
AI Products

An Open-Source Social Card Skill: Say Goodbye to AI-Looking Images

guizang-social-card-skill is an open-source AI text-and-image card generator with 11 built-in content category adaptations, a magazine-grade layout engine, and free commercial-use image libraries, helping you one-click generate RedNote-grade card images.

Toolin Editorial Team
Hy-Memory: Give Your AI Agent a Supercharged Memory
AI Products

Hy-Memory: Give Your AI Agent a Supercharged Memory

Hy-Memory is an OpenClaw memory plugin from Tencent. With a three-part architecture — a 6-layer memory framework, System1/System2 dual processing, and evolution chains — it lets an Agent truly remember your preferences, decisions, and history, cutting memory fragments by over 70%.

Toolin Editorial Team
PilotDeck: The Open-Source Agent Operating System from Tsinghua
AI Products

PilotDeck: The Open-Source Agent Operating System from Tsinghua

PilotDeck is an open-source Agent operating system jointly released by Tsinghua University's THUNLP Lab and partner teams, featuring independently isolated WorkSpaces, white-box memory management, smart routing that saves money, and Always-on proactive execution.

Toolin Editorial Team
Five Models Tested: Is Qwen3.7 Max Actually Good at Coding
AI Tutorials

Five Models Tested: Is Qwen3.7 Max Actually Good at Coding

Qwen3.7 Max climbed to second place globally on competitive coding leaderboards, behind only Claude Opus 4.7. Using four tasks — liquid simulation, hexagonal 2048, a metro museum, and a browser operating system — this hands-on test compares the coding performance of Qwen3.7 Max, GPT-5.5, Gemini 3.5 Flash, DeepSeek V4, and Claude Opus 4.7.

Toolin Editorial Team