Documentation Index
Fetch the complete documentation index at: https://agentic.proxify.io/llms.txt
Use this file to discover all available pages before exploring further.
You’ll learn: the mindset shift, how to size tasks for delegation, when to step in, and how to match autonomy to risk.
Mindset
Most engineers treat Claude Code like a chatbot. Vague request in, vague result out, blame the tool. The engineers getting 10x results are doing something different — they’ve stopped writing code and started designing systems that write code reliably.The job changed
| What | Status | |
|---|---|---|
| Software development | Writing code, running tests, committing changes | Automated. ~$10/hr, 24/7, never tired. |
| Software engineering | Building rails, managing failure domains, creating verification loops | Still you. |
The questions change
| Before | After |
|---|---|
| How do I write this code? | How do I specify this so an agent writes it correctly? |
| How do I review this PR? | How do I build verification that catches issues before review? |
| How do I debug this issue? | How do I patch my system so this class of issue stops happening? |
Earn trust through engineering
Every objection to agent autonomy — “what if it breaks production?”, “what if it makes bad decisions?” — is an engineering problem, not a reason to avoid delegation. Engineer rollback mechanisms. Engineer verification loops. Engineer back-pressure. The job is to engineer away the concerns. But don’t reach for the jackhammer before you’ve mastered the screwdriver. Start manual, understand why things work, then graduate to higher autonomy. If you skip straight to full automation without understanding the fundamentals, you’ll get terrible results.User vs. practitioner — The user fixes bugs. The practitioner fixes the system that produced the bug. Every correction is a signal: what’s missing from my system that let this happen? That discipline is what compounds. See system evolution.
Delegation Levels
Match autonomy to risk. Start at Draft until you trust the agent’s output in your codebase.| Level | You do | Agent does | Example |
|---|---|---|---|
| Suggest | Decide + implement | Analyze and recommend | ”What’s the best caching approach here?” |
| Draft | Review + approve | Plan and implement | ”Add pagination to the users endpoint.” |
| Execute | Verify after | Plan, implement, and verify | ”Fix this failing test. All tests must pass.” |
| Autonomous | Spot check | Full cycle including PR | Background agents, CI agents |
Task Sizing
Not every task is a good fit for delegation. Good agent tasks are:- Well-defined — clear success criteria the agent can verify
- Scoped — fits within one context window without losing important details
- Testable — has tests or a verifiable output
- Reversible — if it goes wrong, you can undo it (commit before starting)
Context
The agent’s effectiveness is bounded by what it knows. You control that through three levers:CLAUDE.md
Project-level context that persists across every session — commands, architecture, conventions, warnings. See the CLAUDE.md guide.Skills
Domain knowledge that loads when relevant. Instead of explaining your testing philosophy every session, encode it in a skill. See the skills stack for how to get started.Conversation
What you tell Claude in the current session. Be specific. Include error messages, file paths, expected vs. actual behavior. The agent can’t read your mind, but it can read your codebase — point it in the right direction.When to Intervene
| Let it run | Step in |
|---|---|
| Making steady progress toward the goal | Going in circles (same failed approach) |
| Changes are small, incremental, and testable | Making changes you didn’t ask for |
| You can verify the output | Approach is fundamentally wrong |
| About to do something irreversible |
Brownfield
Most real work is brownfield — existing codebases with history, tech debt, and implicit knowledge.- A good CLAUDE.md — the agent needs your conventions, gotchas, and architecture
- Tests — the safety net that lets the agent make changes confidently
- Incremental changes — small PRs that are easy to review, not massive rewrites
- Git discipline — commit before delegating, branch for risky changes, review diffs carefully