# AGENTS.md

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

## Setup

```
npm install
```

## Commands

```
npm run test   # run the test suite, must pass before any commit
```

## Layout

- `benchmarks/`   17 source files
- `tests/`        15 source files
- `hooks/`        7 source files
- `scripts/`      5 source files
- `pi-extension/` 3 source files
- `ponytail-mcp/` 3 source files

## Conventions

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

## Gotchas

- Copy `.env.example` before running anything that needs configuration.
- No lockfile is committed, so an install here may not match what CI produced.

---

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.