Claude Code

Claude Code has the deepest integration with Prodscope — native plugin install, slash commands, and pre-merge hooks.

Install

Option A: Native plugin (recommended)

This method auto-updates and integrates with the Claude Code plugin system:

/plugin marketplace add ashokdudhade/prodscope
/plugin install prodscope@prodscope-marketplace

Option B: Shell installer

Run from your project root to copy all files locally:

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

Option C: Full install (all platforms)

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

Usage

The /prodscope:build command

Type /prodscope:build <task> in your Claude Code session to run the full Builder → Breaker → Verify → Score loop:

/prodscope:build "add rate limiting to the API"

All four phases run in a single response. You will see:

1. Builder output — the proposed diff and a HEALTH_CHECK section
2. Breaker verdict — ACCEPT or REJECT with required fixes
3. Verification — evidence that smoke steps pass (or documented skips)
4. Reliability score — 1–10 rating with justification

If the Breaker rejects, the Builder automatically re-enters with fixes (up to 3 cycles).

The /prodscope:verify command

After a build, run /prodscope:verify to check post-deploy signals via MCP integrations (Sentry, Datadog, etc.):

/prodscope:verify

This requires MCP servers configured in mcp-config.json. Without them it skips gracefully.

Files installed

.claude-plugin/
  plugin.json              # Plugin manifest
  marketplace.json         # Marketplace metadata
commands/
  build.md                 # /prodscope:build command definition
  verify.md                # /prodscope:verify command definition
hooks/
  hooks.json               # Hook registration (SessionStart + TaskCompleted)
  session-start            # Session bootstrap hook
  pre-merge.js             # Pre-merge telemetry gate
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

Session bootstrap

When a session starts, the SessionStart hook loads skills/using-prodscope/SKILL.md into agent context. This ensures the Builder-Breaker loop activates automatically for implementation tasks — you don't have to remember to type /prodscope:build every time.

Pre-merge hook

hooks/pre-merge.js runs automatically when a task completes. It checks MCP telemetry (if configured) and logs results. If MCP is unavailable, it skips with a clear message — it never blocks.

MCP integration

mcp-config.json starts empty. Add Sentry, Datadog, or other MCP server entries per vendor docs. Inject API keys via environment variables — never commit secrets:

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/sse",
      "env": { "SENTRY_AUTH_TOKEN": "$SENTRY_AUTH_TOKEN" }
    }
  }
}