# CLAUDE.md

This repo is managed with **fastpace** — a trust harness that gives you opinionated skills, agents, hooks, and persistent domain context. Before you write code here:

## Start every session with context

1. Read `fastpace/context/architecture.md` — high-level layout and entry points.
2. Read `fastpace/context/conventions.md` — naming, commits, test layout.
3. Read `fastpace/context/decisions.md` and `fastpace/docs/adr/` — respect prior decisions. These are **append-only**; propose new decisions via `/fp-write-adr` or `/fp-remember`, never edit old ones.
4. Read `fastpace/context/learnings.md` — avoid repeating past mistakes.

## When in doubt, use the fastpace skills

- `/fp-ask <question>` — grounded answers using this repo's context.
- `/fp-new-feature "<description>"` — structured lifecycle (planning → spec → tests → implement → PR) with approval gates. Quote the description.
- `/fp-review-pr <n>` — review a PR against decisions, patterns, and guardrails.
- `/fp-remember <fact>` — capture a decision, term, learning, or pattern.
- `/fp-write-adr <slug>` — write a full numbered Architectural Decision Record.
- `/fp-status-report` — produce a stakeholder update from this repo's artifacts.

`fastpace help` lists the rest in the terminal.

## Guardrails are on by default

Hooks in `.claude/hooks/` will block:
- Writes containing secrets (API keys, tokens, private keys)
- Dangerous commands (`rm -rf /`, `curl | sh`, force-push to protected branches)
- Commits to protected branches (`main`, `master`, `release/*`)
- Commit messages that don't follow the configured style (default: conventional)

Hook config lives in `fastpace/fastpace.config.yaml`. Audit trail at `fastpace/audit.log`.

## Persistence

Feature work persists to `fastpace/watch-cards/` so any AI (this one tomorrow, a different one next week) can resume exactly where the previous session left off.

**The repo is the source of truth.** Context is plain markdown, committed to git — not tied to any model's memory. You can swap models, onboard new engineers, and the institutional knowledge survives.