vector-os-nano CLAUDE.md

Vector OS Nano — Project Constitution

North Star — read this first (the goal every session serves)

Vector OS is an agent-orchestration runtime built around models, for physical AI. The four things models do unreliably on their own are exactly the OS's job: (1) plan the task, (2) route each instruction to the right model AND skill, (3) verify every step of execution, (4) recover automatically on failure. It orchestrates general large models, specialized small models, classical skills, and atomic actions into one deployable whole that is cross-hardware, cross-model, cross-system — always the best tool for each job. The agent's value is in choosing right, sequencing right, verifying right, and recovering when wrong — NOT in re-implementing navigation or manipulation itself.

Further, Vector OS is a programmable platform: developers build physical AI the way they write code (code physical AI) — any model, any skill, any robot, plug and play.

Current focus — sim. In a high-quality simulator, an agent is commanded in natural language to:

• switch embodiment — go2, go2 + arm, g1, … on demand;
• route each task to the right specialized model / skill pack, then close the loop (execute → verify → recover):
  • explore → nav stack TARE
  • navigate to a point → planner (FAR, …)
  • VLN (semantic navigation) → SysNav
  • manipulation → VLA, or the classical route VLM + point-cloud localization + IK

Robots are the end; sim is the current means of building and proving it. Verification only ever gets stricter, never looser — every step must prove it happened, never merely claim it.

Acceptance interface (NON-NEGOTIABLE). The owner tests EVERYTHING by typing bare vector-cli + natural language — no pytest/python/flags/scripts. Every capability must be reachable + demonstrable through the bare REPL by NL (launch/switch sim+embodiment by NL, command the task, the honest verdict surfaces in that conversation). pytest/PTY harnesses are INTERNAL only. A capability that only works behind a flag or -p and is unreachable from bare vector-cli + NL is NOT done.