specrail-install

# SpecRail Install Use this skill for agent-facing SpecRail setup. The skill is the entrypoint; CLI tools are deterministic helpers the agent runs after selecting the setup route. ## Routes - `doctor`: inspect current setup without writing files. - `install_local_skills`: install or update local Codex skills. - `install_global_guidance`: add or update global agent guidance. - `adopt_repo`: plan or perform SpecRail pack adoption in a target repository. ## Steps 1. Identify the route from the user's request. If the user only asks whether SpecRail is installed, choose `doctor`. 2. Read the active repo instructions and `AGENT_USAGE.md`. 3. Run dry-run checks before any write: ```sh python3 tools/install_codex_skills.py --repo . python3 checks/check_workflow.py --repo . ``` 4. For `install_local_skills`, use `--apply` only when the user explicitly asks to install or update local Codex skills: ```sh python3 tools/install_codex_skills.py --repo . --apply ``` 5. For `install_global_guidance`, update `~/.codex/AGENTS.md` only after an explicit user request. Use a small managed SpecRail section or update the existing SpecRail section; do not rewrite unrelated global instructions. 6. For `adopt_repo`, first report the target repo, files to copy, files that would be preserved, and validation commands. Do not copy pack files into a target repo unless the user explicitly asks. 7. Verify after writes: ```sh python3 checks/check_workflow.py --repo . python3 -m pyt...