Charlie Hills ๐ฆฉ's Post
Charlie Hills ๐ฆฉ ยท article ยท 2026-04-16 source โ Reader ๐ฅ๏ธ
Agent SkillsAgentic EngineeringCapability Provisioning (right-sizing to the task)Claude CodeAgent Context Files (CLAUDE.md / AGENTS.md)Context Rot & Context LimitsGuardrailsMulti-Agent OrchestrationPrompting as Communication
Effective use of Claude Code requires deliberate setup, disciplined workflow habits, context management, precise prompting, and exploitation of power features โ and learning these on day one would save weeks of friction.
practical ยท expository โ A listicle of 32 practical tips for using Claude Code, organized into five thematic sections. No argumentation or narrative โ pure prescriptive advice.
Structure
| Part | Role |
|---|---|
| Introduction (experience claim + framing) | Establishes authority (47 days daily use) and sets up the listicle premise |
| Section 1: Setup (5 tips) | Foundation layer โ configure CLAUDE.md, commands, skills, integrations, updates |
| Section 2: Workflow (10 tips) | Process discipline โ git hygiene, scope limits, planning, review cadence |
| Section 3: Context management (6 tips) | Session hygiene โ compacting, model selection, task isolation |
| Section 4: Prompting (6 tips) | Input quality โ specificity, error-pasting, step-by-step thinking |
| Section 5: Power moves (5 tips) | Advanced techniques โ subagents, hooks, voice, fast mode |
| Closing (links + engagement ask) | Social media engagement pattern; pointers to deeper resources |
Key terms
- CLAUDE.md Agent Context Files (CLAUDE.md / AGENTS.md)
A project-level configuration file that sets persistent rules and context for every Claude Code session - /commands
User-defined reusable shortcuts within Claude Code (slash commands) - /skills Agent Skills
Specialist agent configurations within Claude Code, each scoped to a particular job - scope limit Guardrails
Restricting Claude Code's file access to only explicitly named files to prevent unwanted changes - /compact Context Rot & Context Limits
A Claude Code command that summarizes and compresses the conversation context to free up token budget - subagents Multi-Agent Orchestration
Parallel Claude Code agent instances that can handle separate tasks concurrently
Propositions
- explicitcorroboratedCLAUDE.md sets persistent rules that apply across every Claude Code session in a project.conf: highsupports โClaude Code: Best practices for agentic coding ยท p2 โ This guide is the canonical source for CLAUDE.md as an auto-loaded file carrying persistent per-session, per-project rules.
- explicitMost people lose time due to poor workflow discipline, not poor prompting.conf: high
- explicitYou should commit your code before letting Claude make changes, to preserve a known-good state.conf: high
- implicitcorroboratedLong Claude Code sessions degrade output quality because context becomes polluted.conf: mediumrefines โ[FULL WORKSHOP] AI Coding For Real Engineers - Matt Pocock, AI Hero ยท p2 โ Pocock supplies the mechanism behind the long-session tip: attention degrades quadratically with context length, collapsing around ~100k tokens.supports โClaude Code: Best practices for agentic coding ยท p12 โ This guide is the canonical source of the claim that long sessions degrade output because context fills with irrelevant content, and prescribes /clear as the remedy.
- explicitdevelopedUsing Opus for planning/thinking and Sonnet for implementation is the optimal model allocation strategy.conf: mediumrefines โ[FULL WORKSHOP] AI Coding For Real Engineers - Matt Pocock, AI Hero ยท p26 โ Agrees on asymmetric model allocation but assigns the strong model to review rather than planning, with the cheap model implementing.extends โ[FULL WORKSHOP] AI Coding For Real Engineers - Matt Pocock, AI Hero ยท p26 โ Pocock generalizes Hills's Opus-plans/Sonnet-builds heuristic into a principle: assign the stronger model wherever judgment concentrates, including review.extends โGitHub - musistudio/claude-code-router: Use Claude Code as the foundation for coding infrastructure, allowing you to decide how to interact with the model while enjoying updates from Anthropic. ยท p9 โ Generalizes and automates the manual 'Opus for planning, Sonnet for implementation' allocation into config-driven per-scenario routing across arbitrary providers, plus /model, custom router, and subagent pinning.
- explicitDescribing the problem rather than prescribing a solution produces better Claude Code output.conf: high
- explicitPasting raw error output is more effective than describing errors in natural language.conf: high
- explicitReviewing every diff line before approval is necessary to maintain code quality when using Claude Code.conf: high
- implicitcorroboratedRunning two subagents in parallel can double throughput on independent tasks.conf: mediumsupports โAndroid Studio Quail 2 Redesigns Agent Mode, Streamlines AI-Assisted Coding ยท p1 โ Android Studio productizing parallel independent-task agent conversations corroborates the claim that parallelizing independent agent work increases throughput.
- explicitLetting Claude interview you before writing code produces better results than immediately briefing it.conf: medium
Arguments
You should adopt these 32 practices to be effective with Claude Code from day one. strength: low
Explicit premises:
- The author has used Claude Code daily for 47 days.
- These are things he wishes he knew on day 1.
Implicit premises:
- 47 days of daily use constitutes sufficient experience to generalize.
- What works for one user's workflow generalizes to other users.
- The cost of not knowing these tips is significant wasted time.
Inferences:
- Authority from personal experience transfers to prescriptive advice.
Workflow discipline matters more than prompting technique. strength: medium
Explicit premises:
- Workflow is where most people lose time.
- The workflow section has 10 tips (the largest section).
Implicit premises:
- The author has observed other users struggling primarily with workflow, not prompting.
- Time lost is the primary cost metric for Claude Code usage.
Inferences:
- Structural emphasis (most tips) reflects relative importance.
Narratives
- The author's 47-day daily usage journey, from day 1 ignorance to current competence.
โ Establishes credibility and frames the tips as hard-won lessons rather than theoretical advice.
Questions addressed
- โ
What should a new Claude Code user know to avoid common mistakes and wasted time?
32 categorized tips covering setup, workflow, context, prompting, and power features. - โ
How should Claude Code sessions be structured for maximum effectiveness?
One task per session, commit before changes, branch per task, review each change, compact or clear when context degrades. - โญ Which tips matter most or in what order should they be adopted?
Implicit ordering (setup first, then workflow, etc.) but no explicit prioritization within sections.
Gaps
- incompleteNo evidence or reasoning is provided for any of the 32 claims. Every tip is stated as flat assertion. There is no explanation of WHY each practice works, what failure mode it prevents, or how the author discovered it. This makes it impossible to evaluate which tips generalize vs. which are idiosyncratic to the author's workflow.
Read next: Look for experience reports or controlled comparisons of Claude Code workflows (e.g., with vs. without CLAUDE.md, with vs. without branching per task). - incompleteThe 'Use Opus to think and Sonnet to build' tip assumes a specific model availability and pricing structure that may not hold. No discussion of when this heuristic breaks down or what 'think' vs 'build' means operationally.
Read next: Anthropic's own model guidance; benchmarks comparing Opus vs Sonnet on code generation vs. planning tasks.closed by[FULL WORKSHOP] AI Coding For Real Engineers - Matt Pocock, AI Hero โ Gives the operational rationale for asymmetric model assignment โ cheap/fast model for implementation, strong model for review โ clarifying what 'think' vs 'build' means and why the split works. - uninformedNo acknowledgment that optimal Claude Code practices may differ significantly by project type (greenfield vs. legacy, frontend vs. backend, solo vs. team), programming language, or codebase size. The tips are presented as universal.
Read next: Domain-specific Claude Code usage guides; team-based AI-assisted development workflows.closed byHow Microsoft Developers Use AI in Real-World Coding | BRK103 โ Provides a concrete, detailed counter-case of solo (not team), legacy-codebase AI usage โ showing the practice differs sharply from greenfield 'vibe coding': ideation-and-verify rather than autonomous authorship โ directly illustrating the context-dependence this gap says is missing, albeit for Copilot/ChatGPT rather than Claude Code specifically. - incompleteThe social media format (LinkedIn listicle) constrains depth. Tips like 'Set a scope limit to only the files you name' and 'Replan at halfway to reset the goal' are operationally vague โ a reader new to Claude Code would not know how to implement them.
Read next: The author's own linked guides (beginner-to-advanced, design-in-code) likely expand on these compressed tips.
Related documents
- Agent Harness Engineering
- [FULL WORKSHOP] AI Coding For Real Engineers - Matt Pocock, AI Hero
- Claude Code: Best practices for agentic coding
- Software Teaming in the Age of AI with James Herr and Woody Zuill
- Agent Skills: Google-Backed AI Coding Agent Workflow
- Have your agent record video demos of its work with shot-scraper video
- Accelerating Delivery: How AI Agents Can Own the Initial Code Draft
- Alex Wang's Post
- The Anatomy of an Agent Harness
- Harness design for long-running application development