Colin Bouvry’s Post

Claude Code: what your repo structure says about your workflow We talk a lot about the limits of AI agents. But rarely about what we actually give them to work with. An agent like Claude Code has no memory between sessions. It starts from scratch every time. That's not a flaw — it's its architecture. And it fundamentally changes how we should integrate it into a project. Give it structured context, and you get consistent outputs. Give it nothing, and it does its best with what it has — and "its best" has real limits. That's where the .claude/ directory makes all the difference: CLAUDE.md lays the foundation: stack, conventions, architecture. The onboarding document you should have written anyway — for any new collaborator, human or not. rules/ lets you modularize guidelines by domain (style, testing, API design). Easier to maintain, easier to evolve alongside your codebase. skills/ goes one step further: instead of loading all context upfront, skills are auto-triggered based on task context. Only what's needed, when it's needed — keeping the context window lean and the outputs relevant. hooks/ automates checks: linters, tests, guardrails. Not to control the AI, but to secure the workflow — the same way you would with any other tool. agents/ is where it gets interesting. Specialized sub-agents — security auditor, PR reviewer, deployment checker — each with their own isolated context. Two levels of parallelization: → Within a single prompt: Claude can spawn and orchestrate multiple sub-agents simultaneously, each handling a different task in the same session. → Across Git worktrees: multiple agents running on separate branches at the same time, without stepping on each other. This changes the economics entirely. It's no longer one AI doing one thing at a time — it's a coordinated, parallel workflow where specialization and isolation are built into the repo structure itself. The real question isn't "is AI reliable?" It's "have I built the environment where it can be?" These files, versioned in Git, evolve with your architecture. Neglect them, and they become a liability. Maintain them, and they become leverage. How are you handling context and parallelization with your agents today? #ClaudeCode #SoftwareEngineering #DevOps #AI #CleanCode #GitWorktree

  • No alternative text description for this image

tu as des flow favoris ?

Like
Reply

To view or add a comment, sign in

Explore content categories