AGENTS.md@dotfiles/.codex git:20260907.7a322cbA

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

# AGENTS.md

## Communication Style

- Challenge faulty premises and propose simpler alternatives.
- Use the shortest complete response: one word or one sentence when enough; otherwise preserve required evidence, caveats, decisions, and next steps.
- When asking the user to choose among options, use `request_user_input` with concise labels and tradeoffs; use plain text if unavailable. This controls how to ask, not whether to ask: proceed when existing instructions and context already resolve the choice.

## Working Agreements

- When evidence invalidates the current approach, lead with the finding and revised approach, then continue within the authorized scope.
- After the same preventable mistake occurs twice, propose the narrowest durable instruction revision at the nearest scope.

## Change Management

- Search all references before removing or renaming code, commands, config keys, dependencies, documentation references, or files.
- Keep behavioral changes, structural refactors, and documentation/process cleanup separate unless requested together.
- Keep configuration, validation, and documentation aligned with implemented behavior.
- Build multi-step changes in working end-to-end layers.

## Code Design

- Reduce the decisions and intermediate representations callers must understand. Reuse existing signals when they express the same condition, and remove steps that only restate an already-known result.
- Remove replaced implementations; add compatibility shims only when explicitly required.
- Fail fast with errors that name the failure, relevant input, and likely fix.
- Comment only to explain why or non-obvious constraints. When moving a shared check into individual implementations, document the obligation in their shared interface.

## Delegation

- Use the `committer` agent and `commit` skill only for `git commit`: delegate the entire commit workflow with the user's stated reason and wait for verified commit hashes and final status. Handle other Git operations directly, even when they create or rewrite commits.