AI Coding
What separates AI coding environments that amplify output from ones that slow you down?
The answer is signal discipline — less context, not more. Most setups fail by adding too much.
Providers
- Config Architecture — Agent-agnostic setup: rules, hooks, skills
- Claude Code — Hooks, settings, Claude-specific patterns
- Gemini CLI — 1M+ context window, repo-wide analysis
- Codex CLI — AGENTS.md standard, second-opinion verification
Principles
- Agent Context Prompts
- Command Prompts
- Skills
Context Files
Agent MD files (CLAUDE.md, AGENTS.md) shape what the model sees. Used well, they correct consistent errors. Overused, they add noise: LLM-generated context files decrease performance by 3% on average and increase costs by 20%+.
| Principle | What to Do |
|---|---|
| Minimize context | Include only essential information — irrelevant context distracts |
| Correct consistent errors only | Add rules when the model reliably makes the same mistake |
| Prioritize codebase | If the model struggles, fix the codebase first — move confused elements, improve tests |
| Read agent struggles | Confusion signals an unclear codebase, not a prompting problem |
| Watch outputs | Note what files the agent reads and how long tasks take — builds intuition |
Agent Prompts
System prompt (Mindset)
Command Prompts
Instructions (JTBD)
Skills
- skills.sh — Open source AI coding skills library
Hooks
Dev Workflow
AI agents operate in the same two-stream pattern as human engineers. See Dev Workflow for the full worktrees pattern.
| Stream | Agent reads | Agent produces |
|---|---|---|
| Build | PRD spec → project-from-prd | New capabilities |
| Fix | Issues Log → fix-from-issues | Bug fixes |
Rule: One session, one stream. Never mix building new features with fixing existing issues in the same agent context.
Context
- Dev Workflow — Two-worktree pattern: build vs fix
- Issues Log — Active issues queue for the fix stream
- Business Factory — PRD specs for the build stream
- Config Architecture — Rules, hooks, skills setup
Questions
What happens when the agent's context file corrects errors the codebase should prevent?
- If agent confusion signals an unclear codebase, how do you measure codebase clarity?
- When does adding a rule to CLAUDE.md become a substitute for fixing the actual code?