Codex CLI Adapter

Asset adapter for Codex CLI via AGENTS.md.

Recommended: npm init

cd your-project
npm install rstack-agents
npx rstack-agents init --framework custom --profile business-flex

init creates .rstack/ and scaffolds AGENTS.md, SOUL.md, and HEARTBEAT.md from the package templates. Existing files are never overwritten.

Manual asset copy (optional)

export RSTACK_HOME=/path/to/SDLC-rstack
mkdir -p .rstack/vendor/rstack
cp -R "$RSTACK_HOME/agents"  .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/skills"  .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/plugins" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/prompts" .rstack/vendor/rstack/

AGENTS.md configuration

Run init, or copy the canonical templates:

cp node_modules/rstack-agents/templates/bootstrap/AGENTS.md ./AGENTS.md
cp node_modules/rstack-agents/templates/bootstrap/SOUL.md ./SOUL.md
cp node_modules/rstack-agents/templates/bootstrap/HEARTBEAT.md ./HEARTBEAT.md

File	Purpose
AGENTS.md	Codex/universal bootstrap — asset paths, Node bridge, skill routing
SOUL.md	Governance identity — team roles, contracts, evidence
HEARTBEAT.md	Optional standby checks — approvals, budget, stalled tasks

The template includes a ## Skill routing section that maps .rstack/rstack.config.json enabled domains and plugins to skill selection.

Then run Codex CLI from that project directory.