Field Guide

Use the optional Field Guide plugin when you want agents to remember durable preferences, corrections, and recurring lessons across sessions.

Stores in: ~/.field-guide, local and untracked
Hosts: Claude Code and Codex
Needed by: Nothing. Workflow does not depend on it.

What it keeps

Capture: The agent saves a clear, durable correction or preference automatically and tells you in one line.
Ask: If scope or wording is unclear, the agent asks one question. It saves nothing until you answer.
Skip: Anything task-specific, tentative, sensitive, or already covered by your instructions or the code.

It stores short paraphrases, never transcripts, prompts, credentials, or code dumps. Your current request and the live code always outrank anything it remembers.

Local analytics are off until you turn them on. They record metadata only, never prompts or guidance text.

How it works

Session start. With an initialized guide, the hook adds up to eight stored records for the current repository. It also adds a one-line list of other subjects the agent can look up.
First prompt. The hook searches with your prompt and adds up to three matching records not already in context.
Before each final reply. The agent chooses capture, ask, or skip. The hook adds this reminder, with a short rule for each choice, to each prompt, but nothing enforces the decision.

Later prompts get only that last reminder until the next session start, /clear, or compaction.

When the agent looks up guidance itself, it searches for the concrete thing your request implies, and it looks guidance up again before quoting it after compaction. The skill has the exact rules.

Install

If you haven't added the marketplace, follow the overview first. Then run the command for your host.

Claude Code

claude plugin install field-guide@filip-stack

Codex

codex plugin add field-guide@filip-stack

Installing the plugin enables its session hooks. Codex runs them only after you review and trust them. Leave it uninstalled to keep that context out of your sessions.

Manage what it remembers

Do this	What happens
`/field-guide:field-guide audit`	Lists stored guidance without changing it.
`Say “undo that learning”`	Reverses the last saved learning.
`filip-stack field-guide-sync`	Imports shared preferences from `~/.config/filip-stack/field-guide.json` if present, then exports local shared guidance to that file. Sync it between machines with your dotfile manager. See Sync your Field Guide preferences.

The dotfile uses $XDG_CONFIG_HOME when set. filip-stack apply imports it only if it exists.