Documentation

Everything you need to install, configure, and use AgentC with Claude Code.

Installation

AgentC is a Claude Code plugin. Installation takes about 30 seconds.

Prerequisites

  • Claude Code CLI installed (claude-code command available)
  • Node.js 18+ (for plugin support)

Install the Plugin

# Add AgentC as a Claude Code plugin
claude plugins add agentc@zero2one-turg

# Verify installation
claude
> /status
AgentC v1.1 loaded. No north stars defined.

Note: After installation, AgentC commands are available in any Claude Code session. Your data is stored in agentc/agentc.json in your project root.

Quick Start

Get productive in under 5 minutes with the core workflow.

1. Define Your North Star

Start with Socratic questioning to unearth your guiding direction.

/add-north-star

What does the future look like when this is working?
> A shipping dashboard that shows real-time delivery status

What becomes possible then?
> Customers stop calling support to ask "where is my order"

North Star added: ns1 "Shipping Dashboard"

2. Create a Goal

Goals are concrete, completable objectives with deadlines.

/add-goal ns1

What's your wish for this goal?
> Build MVP with tracking number lookup

Goal added: g1 with 3 milestones

3. Get Your Task

/next

TASK [3 points | Est: 2 blocks]
Create tracking number input component
Advances: ShippingDashboard → MVP

4. Execute with Discipline

/do

=== Milk Quality: SEMI-SKIMMED ===
Timer started
TDD RED: Writing failing test...

5. Mark Complete

/done

=== Task Complete ===
Velocity: 1.5 points/block
Run /next for your next task.

Configuration

AgentC works out of the box, but you can customize behavior.

agentc.json Structure

{
  "version": "1.1",
  "northStars": [...],
  "goals": [...],
  "current": { ... },
  "velocity": { ... },
  "journal": []
}

Command: /next

Analyzes your codebase and goals to surface the ONE optimal task.

/next           # Default: "out" energy (mechanical tasks)
/next in        # "in" energy (complex/creative tasks)
/next out       # "out" energy (simple/routine tasks)

Command: /do

Starts the timer and enforces TDD discipline.

/do                     # Default: semi-skimmed quality
/do --tier skimmed      # Fast, minimal tests
/do --tier semi         # Balanced (default)
/do --tier full         # Thorough, comprehensive

Milk Quality Tiers

Tier TDD Code Review Use When
skimmed Basic Quick scan Urgent fixes, config changes
semi Standard Full review Most development work
full Comprehensive Deep review Critical paths, public APIs

Command: /done

Marks task complete after verification passes.

/done

# AgentC verifies:
✓ Tests pass
✓ Code review clear
✓ Timer recorded

=== Task Complete ===
Estimated: 2 blocks | Actual: 2 blocks
Velocity: 1.5 points/block

Command: /status

Shows progress across all north stars and goals.

/status

=== AgentC Status ===

North Stars:
  ns1: Shipping Dashboard (active)
    └─ g1: Build MVP [▓▓▓░░] 60%
       Due: Dec 25 (2 days)

Velocity: 1.5 points/block
Total shipped: 12 points

North Stars

North Stars are guiding directions you navigate toward. They never complete—they're the horizon.

/add-north-star    # Create via Socratic questioning
/focus ns1         # Set "front of mind" priority
/focus clear       # Remove focus

Goals

Goals are concrete, completable objectives using WOOP methodology:

  • Wish — What you want to achieve
  • Outcome — How you'll know you're done
  • Obstacles — What might get in the way
  • Plan — If-then responses to obstacles
/add-goal ns1      # Create goal for north star ns1

Skills Overview

AgentC includes 22 embedded skills that activate automatically when needed.

All Skills

Skill Trigger
test-driven-development When implementing features
systematic-debugging When encountering bugs
brainstorming When creating or designing
root-cause-tracing When errors occur deep in execution
verification-before-completion Before claiming work is done
requesting-code-review After completing features
using-git-worktrees When starting isolated work
dispatching-parallel-agents When facing 3+ independent issues
writing-plans When design is complete

See the full list of 22 skills with /status or in your Claude Code session.