Felix Pinkston
Apr 28, 2026 17:04
MacCoss Lab’s revolutionary use of Claude Code remodeled its method to managing a 700,000-line legacy codebase, accelerating growth and lowering tech debt.

MacCoss Lab, primarily based on the College of Washington, has spent 17 years sustaining Skyline, an open-source software program instrument used for protein evaluation. With over 700,000 traces of C# code and over 200,000 automated nightly assessments, the codebase is a behemoth that has challenged generations of builders. However Brendan MacLean, principal developer and Claude Developer Ambassador, discovered a novel strategy to handle this legacy: treating Claude Code, an AI-powered coding instrument, as he would a brand new developer.
Skyline’s longevity means its codebase carries many years of amassed technical debt. Builders rotating out and in typically left partially accomplished tasks or untouched code areas. In line with MacLean, onboarding new builders was important to maintain the undertaking practical—and now that very same methodology is being utilized to AI instruments.
AI as a “Trainee Developer”
Initially skeptical about whether or not Claude Code may deal with the nuances of Skyline’s complicated codebase, MacLean examined it by isolating small issues. The outcomes have been underwhelming. Each interplay with Claude felt like ranging from scratch as a result of lack of undertaking context. However this sparked an concept: What if he onboarded Claude as if it have been a brand new developer?
To attain this, MacLean created a separate repository, pwiz-ai, to deal with all AI-related context. A fastidiously maintained CLAUDE.md file offers an summary of the undertaking atmosphere, whereas particular person “abilities”—task-specific capabilities—assist Claude sort out points systematically. For instance, a debugging ability prompts Claude to concentrate on root trigger evaluation as an alternative of trial-and-error fixes.
With this construction, Claude began contributing meaningfully. A protracted-abandoned undertaking to create a Information View panel in Skyline was accomplished in simply two weeks, with ultimate commits co-authored by Claude. MacLean famous comparable success in updating Skyline’s nightly take a look at administration module, which had sat untouched for 3 years after the unique developer left.
Reworking Growth Workflows
Claude Code’s impression at MacCoss Lab goes past finishing unfinished options. The lab now makes use of the instrument to automate tedious duties like regenerating Skyline’s 2,000+ tutorial photos and creating each day error summaries. MacLean even credit Claude with writing an MCP (Message Management Protocol) server in Python to unify knowledge streams from numerous sources, enabling a centralized abstract of take a look at failures and help points every morning.
One of many lab’s builders, initially skeptical of AI instruments, efficiently constructed a mobilogram pane for visualizing ion mobility knowledge. MacLean says the instrument has allowed builders to tackle tasks they beforehand averted attributable to time constraints or complexity.
Recommendation for Managing Legacy Codebases
MacLean’s expertise gives worthwhile classes for builders grappling with growing old codebases:
- Context is essential: Preserve an in depth context repository, separate from the primary codebase if wanted, to make sure continuity throughout branches and developer turnover.
- Construct a ability library: Use AI abilities to encode area information and task-specific directions. Hold these light-weight and straightforward to keep up by linking to central documentation.
- Leverage MCP integrations: When AI instruments want real-time entry to knowledge, construct integrations to unify numerous knowledge streams. This method allowed MacLean’s lab to automate workflows and enhance developer effectivity.
A Mannequin for Open Supply Initiatives
MacLean’s method has broader implications, particularly for open-source tasks the place institutional reminiscence is scarce. By investing in a structured context layer, tasks can guarantee continuity and scalability, whilst contributors come and go. The pwiz-ai repository itself is open supply, designed to learn the undertaking and its contributors over the long run.
MacLean’s key takeaway? Treating AI as a trainee developer—with correct onboarding and context—can unlock its potential in ways in which go far past easy code era. For groups managing sprawling legacy codebases, this technique might be a game-changer.
Picture supply: Shutterstock
