Dev

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

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