# AGENTS

## Memory Bank Requirements
- **Always read the Memory Bank before starting any task.**
- Memory Bank lives in `memory-bank/` and contains:
  - `projectbrief.md`
  - `productContext.md`
  - `systemPatterns.md`
  - `techContext.md`
  - `activeContext.md`
  - `progress.md`
- The Memory Bank is the single source of project context. If a user requests **update memory bank**, review every file in the directory before making changes.
- After significant work or when insights are gained, update `activeContext.md` and `progress.md`. Create additional files in `memory-bank/` when useful for organizing new documentation.

## Development Guidelines
- **Language:** Go using modules.
- **Formatting:** run `gofmt -w` on modified Go files.
- **Testing:** practice TDD and run `go test ./...` before committing, also Test the Application interactively, to ensure the UI is also correct.
- **Linting:** run `golangci-lint run` when available.
- **Structure:** keep application code inside `internal/` packages and follow existing patterns for `core`, `tui`, and `utils`.
- **Error Handling:** return errors instead of panicking and provide clear messages.

## Commit Process
- Ensure Memory Bank is updated when project state changes.
- Run the formatting, lint, and test commands above.
- Commit only when the worktree is clean and all commands pass.