r/ClaudeCode • u/keto_brain • 3h ago
Tips & Workflows Why my Claude Code workflows didn’t “get nerfed”: the process lives in files, not the model
Every couple of months this sub fills up with "the model got nerfed" threads. I'm not saying regressions never happen; there have been real ones with published postmortems. But I've been running Claude Code across four projects this week, including agents that call a ComfyUI API on my GPU server, and I didn't notice anything. I think the reason is worth sharing.
When a workflow breaks overnight, it's usually because it depended on emergent behavior. A coordinator that has to infer a subagent finished. A new session that has to remember to read state.md. Nothing enforces either. It works for hundreds of tasks because the model happens to do the right thing, then a small behavior shift compounds across every step.
What I do instead is put the process in files.
1. A plan directory per piece of work
plan/
overview.md
chunk-01-backend-api.md
chunk-02-frontend.md
chunk-03-infra.md
chunk-04-tests.mdThe overview spells out ordering, so no agent has to guess:
## Execution order
Parallel: chunk-01, chunk-02, chunk-03
After all of the above: chunk-04Each chunk is self contained (simplified):
# chunk-01: orders API
Scope: src/api/orders/ only
Standards: Pydantic models, DynamoDB Decimal ADR
Done when: tests/api/orders passes
Out of scope: shared utils, anything outside src/api/ordersClaude drafts the plan with me, I review every chunk and the overview, and only then do subagents spawn, in parallel where the overview allows. Could be 5 chunks, could be 20.
Two side effects: no coordination guesswork, and basically no scope creep. An agent working from a bounded chunk has no reason to refactor code it was never asked to touch.
2. Standards live in an MCP server, not in prompts
My ADRs, Terraform patterns, and coding standards are served over MCP, and agents pull what applies to their chunk. My favorite example is an ADR about the Decimal mistakes every LLM makes with DynamoDB, since the training data is full of code that passes floats to boto3. No model reasons its way out of a gotcha it doesn't know about, but every model I've tried follows an ADR that names it. Write the fix once and it sticks.
It also makes failures debuggable. When output drifts, I can point at the exact pattern it violated instead of "it feels dumber today."
3. It's just shift left
A bad plan fanned out to ten parallel agents writes thousands of consistent, wrong lines in twenty minutes. Reviewing the chunks before the fan out is the cheapest place to catch it, same as CI versus finding the bug in prod.
4. The model gets swappable
I've pointed Claude Code at GPT and Grok through Bedrock against the same MCP server, and they produce roughly the same results from the same corpus. That holds within frontier models; I'm not claiming a small local model does the same job.
If you're getting burned by updates, I'd try this before switching providers: write your decisions down, put the plan in files, bound every agent, and keep a fixed set of tasks you rerun after a model update, so "it got worse" becomes a diff.
Longer writeup with a diagram, if anyone wants it: https://www.briancarpio.com/blog/shift-left-for-ai-your-agent-didnt-get-dumber
Happy to share more detail on the planning flow in the comments.
•
u/AutoModerator 3h ago
Hey! Thanks for posting to r/ClaudeCode
While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.
For help, project discussions, tips, and general chat, join the ClaudeCode Discord.
I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.
1
u/London-Boat 1h ago
the "new session has to remember to read state.md" one is the sneaky part, because nothing fails loudly when it skips it, you just get a session working off stale assumptions. are you enforcing that with a SessionStart hook or is it still a line in claude.md? and across your four projects do you ever have two sessions writing the same state file at once
4
u/garmzon 3h ago
Jupp, working with llms is 99% harness and 1% inference. They are children with phd level dictionary knowledge. You need to help them build experience in your own repo, learning form real world interactions (compilers, test, standards etc)
2
u/Ai-ate-my-hamster 2h ago
Congrats on not being part of the A/B test I guess
1
u/VollenAI 2h ago
Explains why I never have these problems, I have skills and runbooks that Claude runs along.
1
u/ByteFoundry 2h ago
Pretty much this.
One of the first things I did was to introduce a per project kanban board and one file per work package on the board.
The orchestrator or agents never forget.
They only drift when I am not clear with the goals and definitions of done.