conductor_for_codex

Portable Conductor-style bootstrap for Codex, using transparent plain markdown skill files.

Start Here

If you are new to Conductor, read what_is_conductor.md first.

Install Once, Use Everywhere

This repo uses a two-step model:

1. Run one installer script once per machine/user (global install).
2. Run codex_conductor_init inside any repo you want to initialize (repo init).

The global install gives you reusable skills and a global init command. The repo init adds only local project files needed for Conductor-style workflow.

Transparency

This repo includes:

• Skill content as plain markdown files under skills/

• Conductor templates under templates/ (workflow + code style guides)

• No encoded/base64 skill payloads are used for installation.

• Both installers copy from skills//SKILL.md so users can inspect everything before running.

What Gets Installed

Global install (user profile, offline):

• Skills in global Codex home:
  • conductor-setup
  • conductor-status
  • conductor-implement
  • conductor-newTrack
  • conductor-revert
  • conductor-review
  • conductor-update
• Templates in global Codex home:
  • Windows: %USERPROFILE%\.codex\conductor\templates\...
  • Linux: $HOME/.codex/conductor/templates/...
• Global init command:
  • Windows: %USERPROFILE%\.codex\bin\codex_conductor_init.cmd
  • Linux: $HOME/.local/bin/codex_conductor_init
• Skill recommendation catalog:
  • Windows: %USERPROFILE%\.codex\conductor\skills\catalog.md
  • Linux: $HOME/.codex/conductor/skills/catalog.md

What Happens in a Repo

When you run repo init, it creates/updates local files in that repo:

• .codex/skills//SKILL.md (copied from global install)
• conductor/templates/... (copied from global templates; non-destructive)
• conductor/skills/catalog.md (copied from the global catalog; non-destructive)
• AGENTS.md rule line:
  • Always run $conductor-status before doing anything else.
• .gitignore line:
  • conductor/

Why there are two styleguide locations?

• conductor/templates/code_styleguides/ is the template library (the available guides to choose from).
• conductor/code_styleguides/ is the active project guides created during $conductor-setup.

Safety (Non-Destructive by Design)

This setup is intentionally non-destructive:

• It never deletes your project files.
• It never overwrites existing repo skill folders under .codex/skills/.
• For AGENTS.md:
  • If missing, create it.
  • If present, append the required conductor-status rule only if missing.
• For .gitignore:
  • If missing, create it.
  • If present, append conductor/ only if missing.

In short: append-only when needed, no destructive replacement.

Requirements

Windows:

• PowerShell 5.1+

Linux:

• bash

Install on Windows

Run from the folder containing conductor_for_codex.ps1: