Install & Integrate¶

Installation differs by assistant/platform. Codex CLI and Claude Code use different local "skills" directories; Antigravity Kit-style projects load skills from .agent/skills/; tool-agnostic assistants often work best by vendoring this repo into the app repo.

Codex CLI¶

Codex CLI is OpenAI's terminal-based coding agent: https://github.com/openai/codex

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/bricerising/enterprise-software-playbook/refs/heads/main/.codex/INSTALL.md

Manual install (shell):

Clone this repo anywhere you like.
Symlink (or copy) the skill folders into $CODEX_HOME/skills (commonly ~/.codex/skills).

Example (symlinks; installs every skill folder in this repo):

git clone https://github.com/bricerising/enterprise-software-playbook.git ~/.codex/enterprise-software-playbook
mkdir -p ~/.codex/skills
for f in ~/.codex/enterprise-software-playbook/skills/*/SKILL.md; do
  ln -s "${f%/SKILL.md}" ~/.codex/skills/
done
ln -sf ~/.codex/enterprise-software-playbook/specs/skills-manifest.json ~/.codex/skills/skills-manifest.json

Claude Code¶

Claude Code is Anthropic's terminal-based coding agent: https://docs.anthropic.com/en/docs/claude-code

Tell Claude Code:

Fetch and follow instructions from https://raw.githubusercontent.com/bricerising/enterprise-software-playbook/refs/heads/main/.claude/INSTALL.md

Manual install (shell):

Clone this repo anywhere you like.
Symlink (or copy) the skill folders into your Claude Code skills directory (commonly ~/.claude/skills).

Example (symlinks; installs every skill folder in this repo):

git clone https://github.com/bricerising/enterprise-software-playbook.git ~/.claude/enterprise-software-playbook
mkdir -p ~/.claude/skills
for f in ~/.claude/enterprise-software-playbook/skills/*/SKILL.md; do
  ln -s "${f%/SKILL.md}" ~/.claude/skills/
done
ln -sf ~/.claude/enterprise-software-playbook/specs/skills-manifest.json ~/.claude/skills/skills-manifest.json

Antigravity¶

Antigravity Kit-style projects load skills from .agent/skills/ in the project root.

Tell Antigravity:

Fetch and follow instructions from https://raw.githubusercontent.com/bricerising/enterprise-software-playbook/refs/heads/main/.antigravity/INSTALL.md

Manual install (shell):

Vendor this repo into your project (submodule or clone).
Symlink tools/enterprise-software-playbook/skills/* into .agent/skills/*.
Symlink tools/enterprise-software-playbook/specs/skills-manifest.json to .agent/skills/skills-manifest.json.

Tool-agnostic: vendor it into your project¶

Many assistants can only reliably follow rules that live inside the repo they're editing. A simple approach is to add this repo as a submodule (or just copy the files), then point your assistant at the specific skill(s) you want.

git submodule add https://github.com/bricerising/enterprise-software-playbook.git tools/enterprise-software-playbook

Then reference files like tools/enterprise-software-playbook/skills/typescript/SKILL.md in your assistant's project instructions.

Bundled Tools (Optional)¶

Some skills (archobs, intel, forecast) depend on bundled tools. Install them if you plan to use those skills.

archobs (architecture observability)¶

Requires Codanna for dependency extraction:

# macOS
brew install codanna
# Linux / other
curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | sh

Then install archobs itself:

pip install -e 'tools/archobs[full]'

intelligence (intel + forecast external engine)¶

cd tools/intelligence && npm install && npm run build && npm link

After linking, the intel CLI is available on PATH. See skills/intel/SKILL.md and skills/forecast/SKILL.md for configuration details.