# AGENTS.md

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

## Setup

```
yarn install
```

## Commands

```
yarn test                        # run the test suite, must pass before any commit
yarn lint                        # lint
yarn welcome
yarn catalog:check
yarn catalog:sync
yarn command-registry:generate
yarn command-registry:write
yarn command-registry:check
```

## Layout

- `tests/`   262 source files
- `scripts/` 258 source files
- `skills/`  53 source files
- `src/`     20 source files
- `ecc2/`    17 source files
- `docker/`  7 source files

## Conventions

- Tests live alongside the code they cover, following `.github/workflows/reusable-test.yml`.
- CI defines what passing means. See `.github/workflows/ci.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `ecc2/src/tui/dashboard.rs` is 528KB. It will not fit comfortably in context, so read it in parts.
- Copy `.env.example` before running anything that needs configuration.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.