sd0xdev/sd0x-harness

Adr writes a single Architecture Decision Record for a feature, with Context, Decision, Status, Consequences, and Alternatives. Use it to document why an architectural choice was made or to mark a prior decision as superseded.

Architecture Design creates and updates 3-architecture.md from an existing tech spec or code analysis. It documents component diagrams, data flow, integration points, and architecture decisions for a feature.

Ask answers quick questions about a codebase, git history, rules, docs, or other skills by gathering relevant context first. Use it for read-only questions during development, not for changes or deep research.

Best Practices Audit checks a codebase against industry standards and records the verdict, gap roadmap, and debate proof. Use it when you need a conformance judgment for a specific implementation rather than open-ended research.

Bug Fix fixes bugs by tracing the root cause, applying the smallest safe change, and adding a regression test. Use it for failures, regressions, and issue fixes, not for new features or code exploration.

Bump Version updates package.json, .claude-plugin/plugin.json, and .sd0x/install-state.json to the same version. Use it when you need to increment or set a plugin version in sync across files.

Claude Health Check audits .claude structure, naming, hooks, and plugin version drift, then reports issues with fix recommendations. Use it when checking config hygiene or syncing installed assets.

Code Explore traces execution paths, data flow, and architecture to help understand how a feature works or diagnose a root cause. Use it for single-perspective code investigation and output an analysis report with findings.

Code Investigate performs a dual-perspective code investigation to trace how a feature works and consolidate findings from independent analysis. Use it for deep code research, not quick lookup or code review.

Codex Architect provides architecture advice, design recommendations, and comparison guidance for feature planning or evaluating solutions. Use it for second opinions on technical design, not implementation or code review.

Codex Brainstorm runs independent Claude and Codex research, then adversarial debate to compare solution options and feasibility. Use it for brainstorming, exhaustive enumeration, and final consensus with action items.

Codex CLI Review runs Codex over a full working tree to review uncommitted or branch changes. Use it when you need severity-grouped findings and a merge gate from a deep codebase read.

Codex Code Review runs Codex-based review of code changes and surfaces severity-grouped findings with a merge gate. Use it for PR review, code audits, or a second opinion on changes, not for docs or security-only reviews.

Codex Explain produces structured explanations of code at a chosen depth. Use it to understand complex logic, trace data flow, or onboard to unfamiliar code.

Codex Implement writes features from a spec, then runs a review loop to confirm the result. Use it for new code, Codex-driven development, and changes that should be implemented rather than reviewed or architected.

Codex Review runs a full second-opinion code review with Codex exec, including lint:fix and build checks. Use it for diff review when you want local validation and preserved context.

Codex Review Branch runs a full automated review of all commits in a feature branch using Codex exec. Use it when you need a thorough branch-level code review, with an optional second reviewer via --dual.

Codex Review Doc routes document review requests to the parent doc-review workflow. Use it for reviewing documents with context preservation and a review loop.

Codex Review Fast gives a quick second-opinion review of a diff using Codex exec without running tests. Use it for lightweight review loops that preserve context and skip lint or build checks.

Codex Security routes security review requests to the full OWASP Top 10 workflow. Use it for security audits and iterative reviews that need context preservation.

Codex Setup initializes sd0x-dev-flow for Codex CLI and other non-Claude agents. It generates AGENTS.md, installs the commit-msg hook, copies runner scripts, and can add an optional pre-push gate.

Codex Test Gen routes to the test-review workflow to generate new unit tests for specified functions. Use it when you need tests written from existing code, not coverage review or integration tests.

Codex Test Review evaluates existing test coverage and suggests missing edge cases. Use it in a review loop when you need to assess test sufficiency with context preserved.

Contract Decode decodes EVM revert data, function selectors, custom errors, and calldata. Use it when hex data, a contract address, or a selector needs ABI-based identification and argument decoding.

Test Coverage Analysis assesses unit, integration, and E2E test coverage for a feature and identifies missing cases. Use it to map source files to tests and get prioritized recommendations for gaps.