---
name: critique
description: "Provide critique on investigation results via human feedback, Codex consultation, or self-review. Can trigger additional investigation cycles for deepen/explore feedback. Use when iterating on research, requesting AI review, or providing human feedback."
user-invocable: true
argument-hint: "\"<feedback>\" | --codex | --self"
license: Apache-2.0
compatibility: "--codex mode requires an MCP-capable host with the codex-cli MCP server configured; --self and human-feedback modes have no extra requirements."
---

# Critique

Provide external perspective on investigation results. Three modes: human feedback, Codex consultation, and self-review. Can trigger additional investigation cycles when feedback requires deeper exploration.

## Usage

Invoke this skill by name; pass either feedback as a quoted string, `--codex`, or `--self`. On slash-command hosts, prefix with `/` (e.g. `/critique "<feedback>"`).

```
# Human feedback — iterate on existing results
critique "dig deeper into the liveness proof gap under partial synchrony"

# External-model consultation — get AI devil's advocate or inspiration (requires MCP host)
critique --codex

# Self-review — agent reviews its own findings for gaps
critique --self
```


## Inputs

**Always read** before starting:
- `reaper-workspace/notes/current-understanding.md` — the "branch tip" of accumulated knowledge
- `reaper-workspace/notes/results.md` — what's been tried and what happened
- `reaper-workspace/notes/problem-statement.md` — model assumptions and property definitions
- `reaper-workspace/notes/ideas.md` — the ideas to investigate
- `reaper-workspace/feedbacks/` — prior feedback rounds

**Lazy-load only when needed:**
- `reaper-workspace/notes/paper-summary.md` — the source paper (if provided)
- `reaper-workspace/notes/literature.md` — known prior work
- `reaper-workspace/papers/` — downloaded PDFs and per-paper notes

## Mode: Human Feedback

When the argument is quoted text, the skill enters human feedback mode. This is used after investigation has produced results and the user wants to refine, deepen, or challenge specific findings.

### 1. Determine the Feedback Round

Check `reaper-workspace/feedbacks/` for existing `round-*.md` files. The new round number is one greater than the highest existing round, or 1 if none exist.

### 2. Classify and Save Feedback

Classify the user's feedback and write `reaper-workspace/feedbacks/round-N.md`:

```markdown
# Feedback Round N

**User request**: [the user's feedback, verbatim or lightly paraphrased]

**Category**: [scope | deepen | explore | rewrite]

**Action plan**: [what will be done]
```

Categories:

| Category | Signal | Example |
|---|---|---|
| **scope** | Change assumptions, threat model, or framing | "What if we assume a stronger adversary?" |
| **deepen** | Dig into a specific claim, finding, or proof step | "The proof gap in Theorem 3 — find a concrete counterexample" |
| **explore** | Investigate an area the report didn't cover | "What about liveness under partial synchrony?" |
| **rewrite** | Improve clarity, structure, or presentation only | "Make the contributions more concrete" |

### 3. Execute

**scope**: Return control to the orchestrator — this requires re-running `/formalize-problem` before investigation. Do not run cycles yourself; instead, write the feedback file and indicate that re-formalization is needed.

**deepen**: Invoke the `/brainstorm` skill with `"context from the user's feedback"` to generate targeted hypotheses based on the feedback, then invoke the `/investigate` skill with argument `5`.

**explore**: If the area may need additional literature, use the search scripts first and update `literature.md`. Then invoke the `/brainstorm` skill with `"context from the user's feedback"` to generate hypotheses for the new area, followed by the `/investigate` skill with argument `5`.

**rewrite**: No investigation cycles needed. Return control to the orchestrator to re-run `/synthesize` only.

For **deepen** and **explore**, after completing the cycles, the orchestrator should re-run `/synthesize` to produce an updated report.

## Mode: Codex Consultation (`--codex`)

Consult an external AI (OpenAI Codex via MCP) for an independent second opinion on the current investigation state. This establishes an automated feedback loop where Codex plays **devil's advocate** or provides **alternative inspiration**.

See `../reaper/references/codex-consultation.md` for MCP setup, fallback behavior, session continuity, and context compression rules. The critique skill's Codex mode is the most thorough consultation — other skills have lighter-weight checkpoint consultations.

### Determining the Role

Check `reaper-workspace/feedbacks/` for existing `codex-consultation-*.md` files. Count them to determine the consultation number N. Alternate roles:

- **Devil's Advocate** (odd N: 1st, 3rd, 5th, ...):
  Ask Codex to challenge the current findings. Send it a **compressed context** (not full files):
  - The **last 5 findings** from `current-understanding.md` (extract the most recent insights, ~500 words — not the full file)
  - A **summary row** from `notes/results.md` (e.g., "Last 10 cycles: 6 keep, 4 discard; key patterns: [list]")
  - The prompt: *"You are reviewing a research investigation. Play devil's advocate: identify the weakest claims, unstated assumptions, logical gaps, or alternative explanations that the investigators may have missed. Be specific — point to exact claims and explain why they might be wrong."*

- **Inspiration / Alternative Angles** (even N: 2nd, 4th, 6th, ...):
  Ask Codex for fresh perspectives. Send it a **compressed context**:
  - The **last 5 findings** from `current-understanding.md` (~500 words)
  - The **unresolved hypotheses only** from `ideas.md` (skip resolved ones)
  - The prompt: *"You are consulting on a research investigation. Suggest alternative proof strategies, related techniques from other fields, or hypotheses the investigators haven't considered. Focus on non-obvious connections and approaches that could break through current blockers."*

**Context efficiency**: Sending compressed context (~800 words) to Codex instead of full files (~5000 words) reduces latency and improves response quality by focusing Codex on what matters most.

### Processing Codex Feedback

1. **Log** the Codex response to `reaper-workspace/feedbacks/codex-consultation-N.md`.
2. **Triage** the feedback:
   - **Actionable critique**: If Codex identifies a genuine gap or flaw, add a new hypothesis to `ideas.md` with the next available H-number (continuing from the highest existing H# in `ideas.md`), tagged `[Codex-N]` in the Source field.
   - **Alternative approach**: If Codex suggests a promising technique, add it as a hypothesis marked `[Codex-N]`.
   - **Already addressed**: Note this in the consultation log and move on.
   - **Irrelevant or wrong**: Dismiss with a brief note in the log.
3. **Do not block** on Codex feedback. If the MCP call times out or fails, log the failure and return.

### Session Continuity

Use a single Codex session ID across all consultations within one investigation run. This allows Codex to build context across consultations. Pass the `sessionId` parameter to the `codex` tool, using a consistent ID like `"reaper-critique-<timestamp>"`.

## Mode: Self-Review (`--self`)

The agent reviews its own investigation results for gaps, inconsistencies, or missed angles.

### Process

1. Read `current-understanding.md`, `notes/results.md`, and `ideas.md`.
2. Identify:
   - **Weak claims**: Findings with low or medium confidence that haven't been strengthened.
   - **Untested assumptions**: Assumptions listed in hypotheses or proofs that haven't been validated.
   - **Missing angles**: Obvious questions raised by the current findings that haven't been investigated.
   - **Inconsistencies**: Claims in `current-understanding.md` that conflict with each other or with `notes/results.md`.
3. For each actionable finding, add a hypothesis to `ideas.md` with the next available H-number, tagged `[Self-N]` in the Source field (where N is one more than the count of existing self-review rounds).
4. If actionable hypotheses were added, invoke the `/investigate` skill with argument `3` to address them. The self-review findings are recorded as part of the cycle logs in `reaper-workspace/logs/` — no separate self-review file is needed.

## Quality Criteria

- Each investigate-critique loop produces a cycle log in `reaper-workspace/logs/` (append-only)
- Human feedback is classified before action is taken
- Codex consultations alternate between devil's advocate and inspiration roles
- Self-reviews identify specific, actionable gaps — not vague concerns
- New hypotheses generated by critique are tagged with their source (`[Round N]`, `[Codex-N]`, `[Self-N]`)
- When critique triggers investigation cycles, results flow back through the normal investigation pipeline