aios CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Path Conventions (路径约定)

IMPORTANT: All relative paths in this document are relative to the PROJECT ROOT (current working directory), NOT AIOS_ROOT.

Two Key Paths

1. AIOS_ROOT / AIOS_ROOT_DIR - AIOS framework installation location

   • Contains scripts/, package.json, core framework code
   • Example: /Users/rex/.rexcil/aios or ~/aios-framework
   • Set via environment variable or auto-detected

2. Project Root - Your current working directory where you run AIOS commands

   • Contains .aios/, .claude/skills/, docs/plans/, project-specific state
   • This is where pwd points when you run aios commands
   • All paths in this document like .aios/context-db/, .claude/skills/ are relative to this directory

Why This Matters

• If your AIOS_ROOT=/Users/rex/.rexcil/aios but you're working in /Users/rex/my-project/:
  • .aios/context-db/ means /Users/rex/my-project/.aios/context-db/ (✓ correct)
  • NOT /Users/rex/.rexcil/aios/.aios/context-db/ (✗ wrong)
• Framework scripts live in $AIOS_ROOT/scripts/
• Your project state lives in $(pwd)/.aios/

Verification Commands

# Check your project root
pwd

# Check AIOS framework location
echo $AIOS_ROOT

# List your project's AIOS directories
ls -la .aios/ .claude/skills/ docs/plans/

Evaluate the AIOS workflow policy before creating a plan, selecting a skill, or dispatching work.

1. direct and noop turns do not create a persistent plan or invoke a skill chain.
2. guarded turns use only the required edit and verification gates.
3. planned turns create or reuse one work-item plan, then execute only the Provider selected by the current rex Command.
4. Do not insert a global bootstrap or compatibility skill chain. aios-workflow-router helps classify work but does not replace the Provider selected by the current Rex Capability Command.
5. Invoke the selected Provider rather than paraphrasing it; use verification-before-completion before claiming a changed behavior is complete.