CLAUDE.md@demo · git:20260118.04d5605 · 2026-01-18 · sha256 5852a833a03ff2c4

CLAUDE.md@demo git:20260118.04d5605A

Immutable. This exact content never changes and is served at /api/v1/blob/5852a833a03ff2c4.

# CLAUDE.md — Claude Code Instructions

Instructions for Claude Code when working in this demo project.

**Source of truth**: See [AGENTS.md](AGENTS.md) for the complete agent workflow. This file provides Claude-specific commands.

## Install decider (if missing)

If `decider` is not available, install the pinned version:

```bash
# macOS/Linux
./scripts/install-decider.sh
export PATH="$PWD/tools/decider:$PATH"

# Windows PowerShell
.\scripts\install-decider.ps1
$env:PATH = "$PWD\tools\decider;$env:PATH"
```

## Daily Pre-flight (Required)

Before starting work, run:

```bash
decider check adr --dir docs/adr
```

When touching `docs/adr/`, templates, or index files, use strict mode:

```bash
decider check adr --dir docs/adr --strict
```

**Do not proceed if ADR checks fail.** Fix issues first.

## Before Making Changes

1. Find applicable ADRs for files you'll modify:
   ```bash
   decider list --dir docs/adr --path "src/db/users.go"
   ```

2. Read the constraints and invariants in applicable ADRs

3. Ensure your changes comply with all constraints

## After Making Changes

Re-run the ADR check:

```bash
decider check adr --dir docs/adr --strict
```

## Commands Reference

```bash
# Validate ADRs
decider check adr --dir docs/adr --strict

# List all ADRs
decider list --dir docs/adr

# Show ADR details
decider show ADR-0001 --dir docs/adr

# Find ADRs by path
decider list --dir docs/adr --path "src/api/**"

# Find ADRs by tag
decider list --dir docs/adr --tag database
```

## What NOT To Do

- Do not proceed if `decider check adr` fails
- Do not ignore ADR constraints
- Do not edit `index.yaml` manually (use `decider index --dir docs/adr`)
- Do not skip the pre-flight check