fabro/CLAUDE.md
Bryan Helmkamp f0dd4f5053 Document --no-retro flag for faster workflow testing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-07 21:40:31 -05:00

829 B

Arc

Dev servers

  1. arc serve — starts the Rust API server (demo mode is per-request via X-Arc-Demo: 1 header)
  2. cd apps/arc-web && bun run dev — starts the React dev server

API workflow

The OpenAPI spec at docs/api-reference/arc-api.yaml is the source of truth for the arc-api HTTP interface.

  1. Edit docs/api-reference/arc-api.yaml
  2. cargo build -p arc-types — build.rs regenerates Rust types via typify
  3. Write/update handler in crates/arc-api/src/server.rs, add route to build_router()
  4. cargo test -p arc-api — conformance test catches spec/router drift
  5. cd packages/arc-api-client && bun run generate — regenerates TypeScript Axios client

Testing workflows

When manually testing workflows with arc run start, use --no-retro to skip the retro step and finish faster.