# Lemon Agent

> Free tools, honest measurements, agentic services. A small portfolio
> house for working with agents: three field guides, two numbered
> failure lists (installable as agent skills), and services agents can
> call directly.

House rule: nothing ships without a working answer to "how would a user
actually use this, today?" Everything is v0; guide step slugs and list
entry ids (PF-NN / AF-NN) are stable and citable. Provenance: mostly
AI-generated, human-guided and reviewed.

## The guides

Human-first: adopt one step at a time; every chapter names its
traditional-engineering ancestor and ends with an optional
paste-into-Claude setup block. Each guide's step 0 is its baseline in
one paste. Guide index: /guides/

### Working with Coding Agents (№ 3), raw at /guides/coding-agents/*.md

- [Step 0: The one-paste baseline](/guides/coding-agents/full-setup.md)
- [Step 1: Write down what bit you](/guides/coding-agents/working-agreements.md)
- [Step 2: Prove it before and after](/guides/coding-agents/verification-loop.md)
- [Step 3: Make the agent interview you](/guides/coding-agents/design-before-code.md)
- [Step 4: Reviews that try to kill the work](/guides/coding-agents/adversarial-review.md)
- [Step 5: Fan out, then funnel](/guides/coding-agents/fan-out.md)
- [Step 6: Build lots of small tools](/guides/coding-agents/build-tools.md)
- [Step 7: Views on demand, not apps](/guides/coding-agents/jit-ui.md)
- [Step 8: Graduate protocol to hooks](/guides/coding-agents/graduate-to-hooks.md)

### Shipping Software with Git + Claude Code (№ 4), raw at /guides/git/*.md

- [Step 0: The one-paste repo baseline](/guides/git/full-setup.md)
- [Step 1: Checkpoint commits](/guides/git/commit-small.md)
- [Step 2: Branches bound the blast radius](/guides/git/branch-blast-radius.md)
- [Step 3: Write history for the next reader](/guides/git/history-for-the-next-reader.md)
- [Step 4: Review the diff, not the summary](/guides/git/review-the-diff.md)
- [Step 5: Recovery is cheap. Use it.](/guides/git/cheap-recovery.md)

### Keeping a Vault (№ 5), raw at /guides/vault/*.md

- [Step 0: The one-paste vault](/guides/vault/full-setup.md)
- [Step 1: Plain files in a repo](/guides/vault/plain-files.md)
- [Step 2: Location is state](/guides/vault/location-is-state.md)
- [Step 3: Capture now, sort later](/guides/vault/capture-now.md)
- [Step 4: The daily log](/guides/vault/daily-log.md)
- [Step 5: Teach the agent the shape](/guides/vault/teach-the-shape.md)
- [Step 6: Run a doctor](/guides/vault/run-a-doctor.md)

## Interactive examples

Branching mini-conversations: pick the agent's next move, see where it
leads (baseline vs correct vs plausible-but-wrong, each with its
downstream outcome and AF/PF citations). Every pattern chapter embeds
one; each is also standalone at /examples/<id>/ with raw JSON at
/examples/<id>.json:

- coding-agents: clean-probe (verification) · unnamed-fork (design
  forks) · borrowed-rules (working agreements) · review-that-refutes
  (adversarial review) · vanishing-findings (fan-out) ·
  third-time-tool (small tools) · dashboard-that-rots (JIT views) ·
  promise-vs-hook (hooks)
- git: wall-of-diff (checkpoint commits) · experiment-on-main
  (branches) · weird-retry-loop (history) · merge-on-summary (diff
  review) · broken-main (recovery)
- vault: app-or-files (plain files) · status-field-rot (location is
  state) · idea-mid-work (capture) · log-it (daily log) ·
  twice-corrected (teach the shape) · doctor-first-run (doctor)

## Lists (the guides' watch-out reference)

- [The Prose Failure List](/lists/prose-failure-list.md): 24 numbered
  failures of AI-assisted prose (PF-01…PF-24), run as a subtraction
  pass. Paste-ready prompt in the page's "How to use it" section.
- [The Agent Workflow Failure List](/lists/agent-workflow-failure-list.md):
  18 numbered failures of agent-assisted engineering (AF-01…AF-18), each
  grounded in a measured incident. Entries marked ⚙ are
  executable-advisory candidates.

## Install as skills (Claude Code)

Clone https://github.com/chronick/lemon-agent and copy either directory
into `~/.claude/skills/`:

- `skills/prose-failure-list`: subtraction pass over a draft
- `skills/agent-workflow-failure-list`: verification pass over a
  session, PR, or report

Run the lists as advisory passes: they report, they never gate.

## Services

- [pathgrip](https://pathgrip.net): a bookmark + provenance store with
  content-addressed snapshots, drift detection, per-agent bearer tokens,
  and an MCP surface. Operator instance today; public docs and
  self-serve keys are the next ship.

## Machine catalog

- [catalog.json](/catalog.json): every member with tier, kind, status,
  chapters, install path, and URLs.