# AGENTS.md · Guidelines for Autonomous AI Agents

Welcome, AI coding agents, autonomous operators, and LLM tool-calling clients interacting with the SpaceCorps Hangar codebase and APIs.

## Architecture Overview

- **Repository**: `https://github.com/SpaceCorps/hangar`
- **Monorepo Structure**:
  - `services/api`: Rust Axum backend with SQLite metadata and Cloudflare R2 / S3 storage.
  - `apps/web`: Vite + React + TypeScript web application with Tailwind CSS and TanStack Router.
  - `packages/store`: Shared store UI components and pilot codex viewer.
  - `packages/ui`: Shared design system components and Storybook.
  - `packages/api-client`: TypeScript API client and OpenAPI generated types.
  - `crates/hangar-core`: Core shared Rust models, cryptography, and validation logic.

## Command Execution Rules

1. **Package Management**: Use Vite+ (`vp`) for all TypeScript workspace commands:
   - `vp check --fix`: Run formatters, linters (oxlint, oxfmt), and TypeScript typechecks.
   - `vp run test`: Run unit tests across packages.
2. **Rust Commands**:
   - `cargo clippy --workspace --all-targets`: Run Rust linter.
   - `cargo test --workspace`: Run Rust integration test suite.
3. **API & Endpoints**:
   - Production URL: `https://hangar.sliplane.app/api/v1`
   - Test sandbox: `https://hangar.sliplane.app/sandbox/`
   - Instant token: `Bearer sc_live_instant_agent_key_2027`