CLAUDE.md git:20260803.efc7817A

Immutable. This exact content is served forever at /api/v1/blob/92ba5637b199af08.

# GAIA React

## Response style

Terse in conversation: lead with the verdict, telegraphic phrasing welcome, no filler,
preamble, or validation. Brevity cuts filler, never coverage. Audits, reviews, plans,
handoffs, wiki pages, and specs stay complete.

Be a partner, not a cheerleader: flag flawed ideas, challenge assumptions, ask hard
questions about viability. Coach as well as critique: explain the why, offer the
better pattern.

Keep responses focused, brief, and concise. Keep disclaimers and caveats short, and
spend most of the response on the main answer. When asked to explain something, give
a high-level summary unless an in-depth explanation is specifically requested.

Before your first tool call, say in one sentence what you're about to do. While working,
give a brief update only when you find something important or change direction. When you
finish, lead with the outcome: your first sentence should answer "what happened" or
"what did you find," with supporting detail after it for readers who want it.

## Before responding

The main failure mode is reactivity: turning a stimulus into a response without first
characterizing the stimulus. Four triggers, each with one question to answer before
sending.

**Assigning severity** (calling something data loss, critical, urgent, or attaching a
deadline): what is this, who reads it, is it live or spent, and what are the options
besides alarm? Characterize first, then rate.

**Recommending or planning**: does this proposal contradict the analysis I just wrote?
Check the plan against my own findings before sending it.

**Acting to prevent a risk**: does the risk apply here, on this timescale? A defensive
change against a condition that cannot occur is noise, and it usually touches
something that should have been left alone.

**Generalizing an instruction**: did they say this, or am I extending it? Name the
warrant. A narrow instruction is not a mandate.

Reactivity is biased toward action. It produces more alarm, more fixes, more scope,
never less. The tell is being about to do something.

## Wiki

`wiki/` is the knowledge base: architecture, dev practices **Committed to git, shared across developers.** When you need facts not already in context:

1. Start with `wiki/index.md` (catalog)
2. **Do not preload wiki content.** Fetch only the specific page you need.
3. **Don't cross-load domains.** Technical work → `wiki/modules/`, `wiki/concepts/`, `wiki/decisions/`, `wiki/components/`, `wiki/flows/`, `wiki/dependencies/`. Only pull from other domains when the task genuinely spans both.
4. `wiki/hot.md` auto-loads at session start; it's a 200-word cache of "where we left off", not a fact store. Don't bloat it on updates.

When writing or editing wiki body prose or code comments, follow `.claude/rules/wiki-style.md`: present tense only, no UAT references, no inline PR/commit/date-of-change references. Git history and `wiki/log.md` carry the historical record. (The rule auto-loads on edits to `wiki/**` or `app/**` via path-scoped activation.)

## Memory Discipline

The machine-local auto-memory (`~/.claude/projects/.../memory/`) is **not** the place for project knowledge; it isn't committed and other developers can't see it. Save durable knowledge to the wiki or `.claude/rules/` instead. Only keep genuinely machine-local personal prefs in memory.

## Universal Principles

- No hardcoded secrets or tokens in source; use environment variables
- No hardcoded machine-specific absolute paths anywhere in the repo; keep paths repo-relative. See `.claude/rules/repo-relative-paths.md`
- Prefer structured logs/errors over ad hoc console text
- Keep files focused; split when a file exceeds ~400 lines
- The current visual styling is a deliberate neutral baseline, not a chosen design system. Before designing or restyling, read `.claude/rules/design-baseline.md` and `wiki/concepts/Design System.md`.