Skip to content

GitHub Copilot Instructions

Vox uses AGENTS.md in the repository root as its single source of truth for cross-tool policy. Ensure you review it.

  • Use vox-orchestrator, NOT vox-dei.
  • Use vox-openclaw-runtime, NOT vox-ars.
  • Use vox-gamify, NOT vox-ludus.
  • Use vox-compiler, NOT vox-lexer, vox-parser, vox-hir, vox-typeck.
  • Use component Name() {}, NOT @component fn Name().
  • Use VOX_DB_URL / VOX_DB_TOKEN, NOT TURSO_URL / VOX_TURSO_URL / VOX_TURSO_TOKEN.
  • Use MemoryManager::lookup_fact_by_key (or RAG retrieval), NOT deprecated recall() / recall_async().
  • For writing facts, use MemoryManager::persist_fact; sync_to_db() bulk-syncs MEMORY.md → DB only (not a drop-in for persist_fact).
  • NEVER read secrets from environment variables directly (e.g., std::env::var).
  • ALWAYS use vox_secrets::resolve_secret(...).
  • Skeleton code (stub/todo, unimplemented!(), empty bodies) is blocked by CI.
  • Do NOT modify contracts/ without extreme care.
  • Do NOT write to archive/ or docs/src/archive/.
  • Do NOT create .py files in scripts/; prefer Rust tooling.