AGENTS.md@mirrord/tui · git:20260903.bdcd91b · 2026-09-03 · sha256 1d430c18bd963387

AGENTS.md@mirrord/tui git:20260903.bdcd91bA

Immutable. This exact content is served forever at /api/v1/blob/1d430c18bd963387.

# Agent instructions

## Keep SPEC.md in sync with the code

`SPEC.md` describes the behavior that exists in this repository today. It is the source of truth for "what does this project currently do."

**Whenever you generate, modify, or remove code in this repository, you should update `SPEC.md` in the same change so that it continues to accurately describe the current functionality.**

This applies to any code change which alters user-viewable behaviour, including:

### How to update

1. Make the code change.
2. Open `SPEC.md` and edit the affected sections so they describe the new state of the app — not the diff, and not aspirational behavior.
3. Do not add speculative or planned behavior to `SPEC.md`. It documents what the code does right now.

### When a code change does *not* require a SPEC.md update

- Pure refactors that do not change observable behavior, module boundaries listed in the spec, or the dependency list.
- Formatting, comment, or rename changes with no behavioral effect.
- Changes to files the spec does not describe (e.g. `flake.nix`, `rustfmt.toml`, CI config, this file).

If you are unsure whether a change is observable, err on the side of updating `SPEC.md`.