productionos

ProductionOS

One command. Your entire codebase reviewed, scored, and improved.

ProductionOS is a dual-target AI engineering OS for Claude Code and Codex with 78 agents, 41 commands, and 17 hooks. It deploys specialized agents that review your code, find issues, fix them, and keep improving until every quality dimension hits the target. Smart routing dispatches the right workflow for your goal automatically.

Quick Start

# Step 1: Add the marketplace (one time)
claude plugin marketplace add ShaheerKhawaja/ProductionOS

# Step 2: Install the plugin
claude plugin install productionos

# Step 3: Restart Claude Code, then run on any codebase
/production-upgrade

Alternative: Manual install (if marketplace commands fail)

# Clone directly into the plugins directory
git clone https://github.com/ShaheerKhawaja/ProductionOS.git \
  ~/.claude/plugins/marketplaces/productionos

# Restart Claude Code — hooks, commands, and agents load automatically

Verify installation:

# Check the plugin is recognized
claude plugin list

# Validate the plugin schema
claude plugin validate ~/.claude/plugins/marketplaces/productionos/.claude-plugin/marketplace.json

That's it. ProductionOS discovers your stack, deploys 7 review agents in parallel, scores your code across 10 dimensions, and generates a fix plan. Run it again — the score goes up.

Codex CLI Skill Install

npx productionos@latest --codex

This installs:

• ~/.codex/skills/productionos
• ~/.codex/plugins/productionos
• ~/.codex/skills/productionos-<workflow> aliases for every ProductionOS workflow

Restart Codex to pick up the new skill and plugin.

Install For Claude + Codex Together

npx productionos@latest --all-targets

Codex App / Plugin Surface

ProductionOS now ships a native Codex plugin manifest at .codex-plugin/plugin.json plus a plugin skill at skills/productionos/SKILL.md.

Recommended Codex usage:

• $productionos for the umbrella workflow router
• $productionos-review, $productionos-plan-eng-review, $productionos-production-upgrade, etc. for direct workflow entrypoints

What It Does

The Core Loop

DISCOVER → REVIEW → PLAN → FIX → VALIDATE → repeat until 10/10

1. /production-upgrade — Audit + fix any codebase. Deploys 7 parallel agents (CEO strategic, engineering, code quality, security, UX, backend, database). Shows BEFORE → AFTER scores.

2. /omni-plan-nth — The recursive orchestrator. Chains every available skill, loops until every quality dimension scores 10/10. No shortcuts, no "good enough."

3. /auto-swarm-nth — Throw 7 parallel agents at any task. Each wave covers gaps the last missed. Supports worktree isolation for zero-conflict parallel execution.

4. /designer-upgrade — Full UI/UX redesign: audit → design system → interactive HTML mockups → browser annotation → implementation plan.

Safety & Guardrails

Every action runs through these checks:

• Self-Eval Protocol — 7 questions after every agent action (quality, necessity, correctness, dependencies, completeness, learning, honesty). Score gating: pass, self-heal, or block.
• Repo Boundary Guard — Prevents agents from editing files outside your project. Hard-blocks git operations in wrong repos.
• Secret Detection — gitleaks + regex fallback blocks commits containing API keys, tokens, passwords.
• Protected Files — .env, credentials, keys, certs blocked from writes.
• Approval Gate — High-stakes actions (deploy, auth changes, push) require explicit approval.

For Different Users

Solo Founders / Small Teams

You need the output of a 10-person team but have 1-2 people. ProductionOS fills the roles:

Role	ProductionOS Equivalent
Code Reviewer	code-reviewer agent (2-pass: critical + informational)
QA Engineer	/qa command + ux-auditor agent
Security Auditor	security-hardener + semgrep-scanner + gitleaks hook
Solutions Architect	architecture-designer + /plan-eng-review
CTO / Strategic	/plan-ceo-review (rethink the problem, find the 10-star product)
Designer	/designer-upgrade (audit → design system → mockups)
Release Manager	/ship (merge → test → version → push → PR)

Start with: /production-upgrade to see where you stand, then /omni-plan-nth to fix everything.

Open Source Maintainers

You need consistent code quality across contributors. ProductionOS provides: