# Dev

Development process: repo layout, running it from source, tests and lint, how a change lands.

- [adding-a-card-type.md](https://beebox.run/docs/dev/adding-a-card-type.md): How a new card type is defined, worked example included.
- [adding-api-endpoints.md](https://beebox.run/docs/dev/adding-api-endpoints.md): Adding an HTTP endpoint: tRPC by default, raw Fastify for the exceptions.
- [agent-coding.md](https://beebox.run/docs/dev/agent-coding.md): Entirely agent-coded under one maintainer's direction, and the strictness and checks around that.
- [agent-testing.md](https://beebox.run/docs/dev/agent-testing.md): Testing what agents know and do: knowledge audits, the verified capability catalog, fakes, smoke, tours.
- [chat-review.md](https://beebox.run/docs/dev/chat-review.md): Nightly chat titles and summaries.
- [chat-session-lifecycle.md](https://beebox.run/docs/dev/chat-session-lifecycle.md): Chat session state and recovery.
- [claude-md.md](https://beebox.run/docs/dev/claude-md.md): The engine's agent instruction file: what the maintainer's own coding agent reads first.
- [client-debug-log.md](https://beebox.run/docs/dev/client-debug-log.md): The browser and iOS debug log format.
- [code-style.md](https://beebox.run/docs/dev/code-style.md): Code conventions: types, errors, lint, naming, file limits.
- [composer-input-machine.md](https://beebox.run/docs/dev/composer-input-machine.md): Composer input validation and submission logic.
- [composer-states.md](https://beebox.run/docs/dev/composer-states.md): The chat input state machine.
- [contributing.md](https://beebox.run/docs/dev/contributing.md): How a change is made and lands: setup, tests, lint, docs, where things live.
- [developer-install.md](https://beebox.run/docs/dev/developer-install.md): From-source install for contributors.
- [development-process.md](https://beebox.run/docs/dev/development-process.md): How development happens here: one maintainer directing coding agents; workstreams, issues, plans, skills, verification, schedules, and what it is like.
- [development-workflow.md](https://beebox.run/docs/dev/development-workflow.md): Workstreams in their own worktrees and sessions, the issue queue, planning, recurring work, document comments, and exhibits.
- [engineering-principles.md](https://beebox.run/docs/dev/engineering-principles.md): The durable design principles the code style implements.
- [event-bus.md](https://beebox.run/docs/dev/event-bus.md): The in-process pub/sub event system.
- [example-names.md](https://beebox.run/docs/dev/example-names.md): The fictional roster docs and tests use instead of real names.
- [frontend.md](https://beebox.run/docs/dev/frontend.md): Frontend conventions: UI primitives, palette, the className rule.
- [health-checks.md](https://beebox.run/docs/dev/health-checks.md): Health-check runbooks for a deployed server.
- [image-orientation.md](https://beebox.run/docs/dev/image-orientation.md): The EXIF orientation contract.
- [image-transforms.md](https://beebox.run/docs/dev/image-transforms.md): Image transform operations.
- [knowledge-audits.md](https://beebox.run/docs/dev/knowledge-audits.md): Tests that prompt a real box agent and check what it knows.
- [knowledge-taxonomy.md](https://beebox.run/docs/dev/knowledge-taxonomy.md): Where each kind of box knowledge lives.
- [maintenance.md](https://beebox.run/docs/dev/maintenance.md): Periodic code cleanup: dead code, circular deps.
- [migrations.md](https://beebox.run/docs/dev/migrations.md): How box data migrations are applied and written.
- [mobile-parity.md](https://beebox.run/docs/dev/mobile-parity.md): iOS versus Android capability matrix.
- [module-map.md](https://beebox.run/docs/dev/module-map.md): The lib/shared/types boundary diagram.
- [monorepo-claude-md.md](https://beebox.run/docs/dev/monorepo-claude-md.md): The monorepo's working instructions: where to work, how to work safely in a checkout, how to verify, record, and land.
- [prompt-audits.md](https://beebox.run/docs/dev/prompt-audits.md): Lens catalog for reviewing what an agent is shown.
- [prompt-logging.md](https://beebox.run/docs/dev/prompt-logging.md): Capturing full agent API traffic for debugging.
- [prompt-surface-review.md](https://beebox.run/docs/dev/prompt-surface-review.md): Workflow for auditing agent context.
- [server-operations.md](https://beebox.run/docs/dev/server-operations.md): Runbooks for a deployed server.
- [technologies.md](https://beebox.run/docs/dev/technologies.md): The stack, and every outside AI service the system can be configured to use.
- [testing.md](https://beebox.run/docs/dev/testing.md): Testing philosophy and the doctest tiers.
- [tours.md](https://beebox.run/docs/dev/tours.md): Browser walk-throughs for UI and accessibility review.