aios-project-system

# AIOS Project System ## Overview Use this skill as the repository map for `aios`. It explains where state lives, how automation actually runs, and which files are authoritative before you edit tasks, workflows, or browser operations. **This skill is a map, not a router.** For task routing, use `aios-workflow-router`; execute only the Provider selected by the current Rex Capability Command. ## Core Topology - `CLAUDE.md` / `AGENTS.md` / `GEMINI.md`: per-client project-level behavior contract and architecture overview (each client loads its own instruction file). - `skill-sources/*/SKILL.md`: canonical skill sources (edit here, never edit generated copies). - Generated repo-local skills per client: `.codex/skills`, `.claude/skills`, `.gemini/skills`, `.opencode/skills`, `.agents/skills` — emitted from `skill-sources/` via `config/skills-sync-manifest.json`. - Agent promotion and workflow enablement are evidence-gated: use `agents smoke` for core-risk rollout evidence, then `skill verify-training` to block changed skills until SkillOpt training is accepted. - `scripts/lib/specs/*.json`: runtime specifications and limits. - `tasks/{pending,done,failed}`: task queue and outcomes. - `scripts/run-browser-use-mcp.sh`: default browser MCP launcher (bridges to `ai-browser-book/mcp-browser-use`). - `mcp-server/`: legacy Playwright MCP implementation retained for compatibility workflows. - `docs/plans/`: design, implementation, and postmortem documents. ## Runtime Truths (Do Not Ski...