# AGENTS.md

Write HTML. Render video. Built for agents.

## Setup

```
bun install
```

## Commands

```
bun dev                         # run locally
bun build                       # produce a build
bun test                        # run the test suite, must pass before any commit
bun lint                        # lint
bun format                      # format
bun build:producer
bun studio
bun build:hyperframes-runtime
```

## Layout

- `packages/` 2600 source files
- `skills/`   250 source files
- `scripts/`  78 source files
- `docs/`     10 source files
- `examples/` 10 source files
- `registry/` 10 source files

## Conventions

- Tests live alongside the code they cover, following `.agents/skills/changelog-video/references/build-spec.md`.
- CI defines what passing means. See `.github/workflows/canary-sunset.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `skills/embedded-captions/scripts/make-theme.cjs` is 449KB. 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.