itismixian/orrery/codex

Orrery Codex Adapter

This is a thin Codex adapter. It requires the separately installed project-orrery CLI declared in adapter-manifest.json; it does not contain Orrery templates, schema, compatibility rules, or project facts.

Route the task

1. Read the target repository's root AGENTS.md and follow its local reading

order and safety boundaries before touching project files.

1. Before invoking the CLI, run this Adapter's

scripts/check_cli_dependency.py with the Python interpreter that resolves project-orrery. If the check exits nonzero, report its dependency error instead of falling back to copied templates or inferred rules.

1. Before the first product write, run `project-orrery worktree route --target

<repo> --adapter-manifest <this-adapter>/adapter-manifest.json --platform-session-id <current-session-id> --json. If the runtime does not expose its session ID, stop with the returned continuation brief. When the route requires attach, run the corresponding worktree session attach command and rerun the route. Continue only when the route returns allow`; never bypass dirty-primary recovery or silently rebind an existing session.

1. Use the CLI command that matches the request:

• project-orrery scaffold --target <repo> --title <title> --dry-run
• project-orrery validate --target <repo>
• project-orrery check-update --target <repo>

1. Keep adapter installation separate from target-project scaffolding,

Observatory tool upgrades, and authored-document migration.

1. Never claim that an accepted decision is implemented, that an installed

scaffold is integrated, or that Agent self-report proves files were read.

For established repositories, inspect existing documentation roles and review the dry-run before any mutation. Never silently overwrite authored documents. Only use --upgrade-tools when the user explicitly asks to update managed Observatory files and has reviewed the planned backups.

After implementation or validation work, update the authority layers required by the target repository's own AGENTS.md. Do not create a parallel state summary in Codex-specific files.