OpenAI Codex

Prodscope ships as a native Codex plugin with a repo-scoped marketplace. Codex detects the plugin automatically and runs the full Builder-Breaker loop on every task.

Install

Option A: Native plugin (recommended)

Codex detects the plugin automatically when the manifest and marketplace files are present. Copy them into your project:

git clone https://github.com/ashokdudhade/prodscope.git /tmp/prodscope
cp -r /tmp/prodscope/.codex-plugin ./
cp -r /tmp/prodscope/.agents ./
cp /tmp/prodscope/AGENTS.md ./
cp -r /tmp/prodscope/skills ./
cp /tmp/prodscope/mcp-config.json ./

Codex reads .codex-plugin/plugin.json to register Prodscope, and .agents/plugins/marketplace.json installs it by default. No manual activation needed.

Option B: Shell installer

Run from your project root to copy all Codex files automatically:

curl -fsSL https://raw.githubusercontent.com/ashokdudhade/prodscope/main/install.sh | bash -s -- --codex-only

Option C: Full install (all platforms)

curl -fsSL https://raw.githubusercontent.com/ashokdudhade/prodscope/main/install.sh | bash

Usage

Point Codex at your repo. It picks up AGENTS.md automatically and follows the orchestration for every implementation task:

1
Phase 1 — Builder: Codex reads skills/builder/SKILL.md, implements the smallest coherent diff, and attaches a HEALTH_CHECK with smoke steps, signals, and rollback.
2
Phase 2 — Breaker: Codex reads skills/breaker/SKILL.md and reviews its own output as a senior SRE. If flaws are found, it rejects and loops back to Builder (max 3 cycles).
3
Phase 3 — Verification: Codex reads skills/verification/SKILL.md and runs HEALTH_CHECK smoke steps with evidence. Failures loop back to Builder.
4
Phase 4 — Reliability: Codex reads skills/reliability/SKILL.md and scores the change 1–10 on tests, observability, error handling, ops, and security.

The entire loop runs automatically in a single response — no slash commands needed.

Files installed

.codex-plugin/
  plugin.json                # Plugin manifest (Codex reads this)
.agents/
  plugins/
    marketplace.json         # Repo-scoped marketplace catalog
AGENTS.md                    # Orchestration bridge
skills/
  using-prodscope/SKILL.md   # Session bootstrap: when the loop runs
  builder/SKILL.md           # Builder instructions
  breaker/SKILL.md           # Breaker instructions
  verification/SKILL.md      # Evidence gate
  reliability/SKILL.md       # Reliability scoring
mcp-config.json              # MCP server placeholder (shared)
.prodscope/logs/             # Rejection/improvement logs (gitignored)

How the plugin works

Codex uses two mechanisms to load Prodscope:

Plugin manifest

.codex-plugin/plugin.json identifies the plugin, points to bundled skills, and provides metadata for the Codex UI. Codex detects this file and registers Prodscope as an available plugin.

Repo marketplace

.agents/plugins/marketplace.json is a repo-scoped marketplace catalog. It tells Codex to install Prodscope by default when opening this project. The marketplace entry points to the plugin root with INSTALLED_BY_DEFAULT policy, so no manual activation is needed.

AGENTS.md

AGENTS.md at the project root provides orchestration instructions that Codex reads automatically. It instructs Codex to:

Customizing

Extend the Breaker's review checklist by adding files to skills/breaker/checks/. These are automatically included in the review. Use this for org-specific production patterns.

Adding to another project

To use Prodscope in a different repo, copy the plugin files or add the marketplace entry pointing to your local Prodscope install:

# Personal marketplace (applies to all your repos)
mkdir -p ~/.agents/plugins ~/.codex/plugins
cp -r /path/to/prodscope ~/.codex/plugins/prodscope

# Add to ~/.agents/plugins/marketplace.json:
# { "name": "prodscope", "source": { "source": "local", "path": "./.codex/plugins/prodscope" }, ... }