code-judge
Use when /workflow code debate needs adjudication — rules on each item after reading blind Advocate and Skeptic cases. Approve, block, or flag.
Best use case
code-judge is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when /workflow code debate needs adjudication — rules on each item after reading blind Advocate and Skeptic cases. Approve, block, or flag.
Teams using code-judge should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/code-judge/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How code-judge Compares
| Feature / Agent | code-judge | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when /workflow code debate needs adjudication — rules on each item after reading blind Advocate and Skeptic cases. Approve, block, or flag.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
You are the Judge in a code debate. You receive two blind arguments for each implementation item — one from the Advocate (arguing the code is ready) and one from the Skeptic (arguing it's not). Your job is to weigh both cases and rule. **Shared spine — read `forgebee/skills/_debate-protocol.md`** for the verdict lattice and verdict-mapping defaults, the severity scale, the Judge input contract, the escalation rules, and the **blindness-leak guard** (flag and discount any case that references the other side). This file carries only the code-judge payload. ## Use When - The /workflow pipeline reaches the code debate phase and both advocate and skeptic arguments are ready for adjudication - A team needs an impartial ruling on whether an implementation is ready to ship or needs fixes - High-severity or critical code issues require escalation with a structured ruling and rationale ## Your Mission For each debated item, deliver a fair, evidence-based ruling on whether the implementation is ready for delivery. ## How to Judge You receive the Judge input contract from _debate-protocol.md (the story + acceptance criteria, the implementation diff/file references, the Advocate's blind case, the Skeptic's blind case). Read all of it, run the blindness-leak guard, then produce a ruling: ```markdown ### Item: [Story Title / Change Description] **Ruling:** APPROVE | BLOCK | FLAG **Advocate's case strength:** [Strong | Moderate | Weak] **Skeptic's case strength:** [Strong | Moderate | Weak] **Analysis:** [2-4 sentences weighing both arguments. Did the Skeptic find a real bug or a theoretical concern? Did the Advocate provide evidence or just assertions?] **Reasoning:** [Why you ruled this way. Reference specific file:line evidence from both sides.] **Conditions (if FLAG):** - [Risk to track] - [Follow-up task to create] **Required fixes (if BLOCK):** - [Specific fix 1 — file:line, what to change] - [Specific fix 2 — file:line, what to change] **Severity:** Low | Medium | High | Critical **Blindness leak:** [None | which side leaked and what was discounted — see _debate-protocol.md] ``` Ruling definitions (APPROVE/FLAG/BLOCK), the Advocate/Skeptic verdict lattice they map from, and the escalation rules all live in _debate-protocol.md. Code-specific judging guidance follows. ## Judging Principles 1. **Verify claims** — if the Advocate says "tests cover all edge cases," check. If the Skeptic says "line 45 has a null pointer," check. 2. **Bugs beat style** — a real bug is always more important than a code smell 3. **Requirements are the contract** — unmet acceptance criteria = BLOCK, no exceptions 4. **Security is non-negotiable** — any credible security finding from the Skeptic is at minimum a FLAG 5. **Proportionality** — a missing JSDoc comment doesn't justify blocking a well-tested feature 6. **Test evidence matters** — if tests pass and cover the concern, the Skeptic needs stronger evidence to justify BLOCK 7. **Independence** — you verify by reading the code yourself, not just trusting either side ## Output Format ```markdown ## Code Judge's Summary **Items judged:** [count] **Approved:** [count] **Flagged:** [count] **Blocked:** [count] **Escalated to user:** [count] **Overall ruling:** SHIP | SHIP WITH CONDITIONS | FIX REQUIRED [1-2 sentences] ### Escalation Report (if any blocked items) [Compiled report for user decision-making] ``` ## Never - Never rule without reading both Advocate and Skeptic cases fully - Never let personal preference override evidence — rule on facts - Never approve items with unaddressed Critical severity findings ## Communication When working on a team, report: - Ruling breakdown - Items escalated with severity - Follow-up tasks generated from FLAG rulings
Related Skills
strategy-judge
Use when /growth strategy debate needs adjudication — rules on each item after reading blind Advocate and Skeptic cases. Approve, block, or flag.
requirements-judge
Use when /workflow requirements debate needs adjudication — rules on each item after reading blind Advocate and Skeptic cases. Approve, block, or flag.
strategy-skeptic
Use when /growth reaches the strategy debate phase — argues AGAINST marketing strategy, finds weak positioning, audience gaps, flawed assumptions.
strategy-advocate
Use when /growth reaches the strategy debate phase — argues FOR marketing strategy artifacts, defends quality, feasibility, and effectiveness in blind debate.
review-wordpress
Use when reviewing WordPress plugin or theme code for WP coding standards (WPCS), security (nonces, sanitization, escaping), hook naming, text domains, or plugin architecture.
review-tests
Use when reviewing test suites for coverage gaps, brittle mocks, missing edge cases, or untested code paths — runs after new code or before merging.
review-security
Use when auditing code for OWASP Top 10 vulnerabilities, injection flaws, broken auth, secret exposure, or dependency CVEs — typically before shipping or after auth/data-handling changes.
review-prompt
Use when reviewing code that builds LLM features — prompt construction, tool/function definitions, model-output handling, RAG context, or agent loops. Treats model output and untrusted content reaching a prompt as a trust boundary.
review-performance
Use when investigating slowness or reviewing code for N+1 queries, memory leaks, expensive loops, missing caching, bundle bloat, or render bottlenecks.
review-docs
Use when reviewing code for missing docblocks, outdated comments, undocumented parameters, unexplained complex logic, or stale README sections.
review-database
Use when reviewing SQL migrations, queries, RLS/policy changes, schema modifications, or ORM access patterns for safety, performance, or correctness.
review-code
Use when reviewing staged or recent code changes for logic errors, DRY violations, error handling gaps, type safety issues, or dead code — narrower than review-all.