<metadata>
purpose: Complete system overview of 12 Leverage Points in Agentic Coding
type: foundational-knowledge
domain: agentic-coding
phase: phase-2-sdlc
audience: LLM-optimized
last-updated: 2025-09-30
</metadata>

<overview>
The 12 Leverage Points represent systematic intervention points in Phase 2 Software Development Lifecycle where developers can dramatically amplify agent performance. These leverage points transform traditional coding from manual implementation to orchestrated agent collaboration through strategic control points.
</overview>

<core-concept>
<name>Phase 2 Software Development Lifecycle</name>
<definition>
The paradigm shift where software development transitions from human-written code to AI-agent-orchestrated code generation. Humans become conductors, agents become implementers.
</definition>

<lifecycle-evolution>
  <phase1>
    <era>1950s-2023</era>
    <model>Human writes code → Machine executes</model>
    <bottleneck>Human typing speed and cognitive load</bottleneck>
  </phase1>

  <phase2>
    <era>2023-present</era>
    <model>Human orchestrates → Agent writes → Machine executes</model>
    <bottleneck>Agent context, communication, and tooling</bottleneck>
    <unlock>12 Leverage Points address these bottlenecks</unlock>
  </phase2>
</lifecycle-evolution>
</core-concept>

<tactic-two>
<name>Adopt Your Agent's Perspective</name>
<priority>critical</priority>
<category>mindset-shift</category>

<principle>
Your agent is brilliant but blind. It possesses vast knowledge but zero context about your specific codebase, requirements, or environment until you provide it. Every interaction starts from nothing.
</principle>

<agent-limitations>
  <limitation type="ephemeral">
    <description>No persistent memory between sessions</description>
    <implication>Must rebuild context every conversation</implication>
  </limitation>

  <limitation type="contextual">
    <description>Cannot see files unless explicitly shown</description>
    <implication>Must provide relevant code/docs proactively</implication>
  </limitation>

  <limitation type="environmental">
    <description>No knowledge of your tools, versions, setup</description>
    <implication>Must specify environment details</implication>
  </limitation>

  <limitation type="temporal">
    <description>Knowledge cutoff date limits awareness</description>
    <implication>May not know latest APIs, libraries, patterns</implication>
  </limitation>
</agent-limitations>

<perspective-shift>
  <from>
    "My agent should figure this out"
  </from>
  <to>
    "What does my agent need to see to succeed?"
  </to>
</perspective-shift>

<adoption-checklist>
  <checkpoint>What context is missing for this task?</checkpoint>
  <checkpoint>Which files/docs would help my agent understand?</checkpoint>
  <checkpoint>What assumptions am I making that my agent doesn't know?</checkpoint>
  <checkpoint>How can I make this task easier for my agent?</checkpoint>
  <checkpoint>What tools does my agent need to complete this?</checkpoint>
</adoption-checklist>
</tactic-two>

<leverage-points-overview>
<structure>
  <in-agent-points count="4">
    Direct control within agent system
  </in-agent-points>
  <through-agent-points count="8">
    Indirect influence through environment
  </through-agent-points>
</structure>

<in-agent-category>
<title>Core Four: In-Agent Leverage Points (1-4)</title>
<description>
Direct manipulation of agent's operational parameters. These are immediate, high-impact interventions.
</description>

<point number="1">
  <name>CONTEXT</name>
  <question>What can your agent see?</question>
  <impact>Determines agent's situational awareness</impact>
  <control>Files shown, conversation history, documentation provided</control>
</point>

<point number="2">
  <name>MODEL</name>
  <question>Which LLM powers your agent?</question>
  <impact>Determines reasoning capability and token limits</impact>
  <control>GPT-4, Claude Sonnet, Gemini, etc.</control>
</point>

<point number="3">
  <name>PROMPT</name>
  <question>How are you communicating?</question>
  <impact>Determines agent understanding and response quality</impact>
  <control>Instructions, examples, constraints, tone</control>
</point>

<point number="4">
  <name>TOOLS</name>
  <question>What can your agent execute?</question>
  <impact>Determines agent's action capabilities</impact>
  <control>File operations, shell commands, API calls, MCP servers</control>
</point>
</in-agent-category>

<through-agent-category>
<title>Through-Agent Leverage Points (5-12)</title>
<description>
Indirect optimization of agent environment. These compound over time and scale across multiple agents/tasks.
</description>

<point number="5">
  <name>DOCUMENTATION</name>
  <question>What agent-specific context exists?</question>
  <impact>Persistent knowledge base for agent consumption</impact>
  <examples>CLAUDE.md, UFC context files, project READMEs</examples>
</point>

<point number="6">
  <name>TYPES</name>
  <question>Is information structured?</question>
  <impact>Agent can validate and catch errors automatically</impact>
  <examples>TypeScript, Zod schemas, database schemas</examples>
</point>

<point number="7">
  <name>ARCHITECTURE</name>
  <question>Can agent navigate your code?</question>
  <impact>Agent understands system boundaries and dependencies</impact>
  <examples>Modular structure, clear naming, separation of concerns</examples>
</point>

<point number="8">
  <name>TESTS</name>
  <question>Can agent validate its own work?</question>
  <impact>Agent self-corrects without human intervention</impact>
  <examples>Unit tests, integration tests, validation scripts</examples>
</point>

<point number="9">
  <name>PLANNING</name>
  <question>Does agent organize work systematically?</question>
  <impact>Reduces hallucination and improves consistency</impact>
  <examples>TodoWrite, task decomposition, memory checkpoints</examples>
</point>

<point number="10">
  <name>AI DEVELOPER WORKFLOWS (ADWs)</name>
  <question>Are repeatable patterns captured?</question>
  <impact>One-shot success for common scenarios</impact>
  <examples>PR creation, debugging, feature implementation flows</examples>
</point>

<point number="11">
  <name>AGENTIC CODING KPIs</name>
  <question>How do you measure agent effectiveness?</question>
  <impact>Data-driven optimization decisions</impact>
  <examples>First-attempt success rate, context utilization, hallucination rate</examples>
</point>

<point number="12">
  <name>ONE-SHOT SUCCESS</name>
  <question>Can agent succeed without iteration?</question>
  <impact>Maximum velocity, minimum frustration</impact>
  <requires>All 11 previous leverage points optimized</requires>
</point>
</through-agent-category>
</leverage-points-overview>

<two-types-explanation>
<in-agent-type>
  <definition>Direct manipulation of agent's runtime environment</definition>
  <characteristics>
    <characteristic>Immediate effect on current task</characteristic>
    <characteristic>Session-specific, must be repeated</characteristic>
    <characteristic>High granular control</characteristic>
    <characteristic>Visible in conversation or config</characteristic>
  </characteristics>
  <when-to-use>Tactical adjustments during active development</when-to-use>
</in-agent-type>

<through-agent-type>
  <definition>Shaping agent's external environment for sustained improvement</definition>
  <characteristics>
    <characteristic>Compounding benefits over time</characteristic>
    <characteristic>Persistent across sessions</characteristic>
    <characteristic>Scales to multiple agents/developers</characteristic>
    <characteristic>Embedded in codebase/tooling</characteristic>
  </characteristics>
  <when-to-use>Strategic investments for long-term velocity</when-to-use>
</through-agent-type>

<synergy>
In-Agent points provide immediate tactical wins.
Through-Agent points create strategic infrastructure.
Maximum effectiveness requires optimizing both simultaneously.
</synergy>
</two-types-explanation>

<system-thinking>
<principle>
The 12 Leverage Points are not isolated tactics but an interconnected system. Optimizing one point amplifies the effectiveness of others.
</principle>

<example-cascade>
  <scenario>Implementing a new feature</scenario>
  <cascade>
    <step point="5">Documentation: CLAUDE.md provides agent project context</step>
    <step point="1">Context: Agent sees relevant files automatically</step>
    <step point="7">Architecture: Agent knows where to add feature</step>
    <step point="9">Planning: Agent breaks down implementation steps</step>
    <step point="3">Prompt: Clear requirements enable focused work</step>
    <step point="4">Tools: Agent writes files and runs tests</step>
    <step point="8">Tests: Agent validates implementation</step>
    <step point="12">One-Shot: Feature complete in single attempt</step>
  </cascade>
  <result>
    Without leverage points: 5-10 iterations, 2 hours
    With leverage points: 1 iteration, 15 minutes
  </result>
</example-cascade>
</system-thinking>

<implementation-priority>
<beginner-focus>
  Start with Core Four (1-4): Immediate impact, minimal investment
</beginner-focus>

<intermediate-focus>
  Add Documentation (5), Tests (8), Planning (9): Force multipliers
</intermediate-focus>

<advanced-focus>
  Integrate Types (6), Architecture (7), ADWs (10), KPIs (11), One-Shot (12): Mastery
</advanced-focus>

<path>
Progressive optimization beats premature perfection.
Master one leverage point before adding the next.
Measure impact to guide prioritization.
</path>
</implementation-priority>

<key-insights>
  <insight>Agents are not autonomous - they require orchestration</insight>
  <insight>Your bottleneck shifted from typing to context provision</insight>
  <insight>Small improvements in leverage points = exponential velocity gains</insight>
  <insight>Agent perspective is the meta-skill that unlocks all 12 points</insight>
  <insight>Phase 2 SDLC is not about replacing developers, but amplifying them</insight>
</key-insights>

<next-steps>
  <step>Study Core Four In-Agent points (core-four-in-agent.md)</step>
  <step>Learn Through-Agent points (through-agent-points.md)</step>
  <step>Adopt Agent Perspective mindset (agent-perspective-mindset.md)</step>
  <step>Master Elite Context engineering (lesson-09-elite-context.md)</step>
</next-steps>