agentleFS
lucasheriqueslucasheriques/pstack/skills/interrogate/SKILL.md

interrogate

Skill3 starsChanged 7 days agoMITView on GitHub

Use for \"interrogate\", \"adversarial review\", \"multi-model review\", \"challenge this\", \"stress test this code\", \"find blind spots\", \"tear this apart\", reviewing someone else's PR, and as the pre-PR gate before opening or readying a PR. Adversaries try to break a change or design, and only findings proven by a run survive.

73 other projects use a version of this, 13 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use principle-explain-the-number, make-bot-ui and 1 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ianclearySkill

    principle-explain-the-number

    Apply before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.

    Also in 29 projects that use this

  • eryzerzSkill

    make-bot-ui

    Use when building a custom UI (page, dashboard, buttons) that should wake a Grok Bot over a webhook, when the user must provide a webhook sender key, or when exposing that UI on Tailscale.

    Also in 20 projects that use this

  • bnemaSkill

    setup-pstack

    Configure which Pi models pstack uses per role. Detects available provider/model specs and writes pstack's user configuration. Use for /setup-pstack, "configure pstack models", or changing pstack model choices.

    Also in 25 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 73 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the decision records (ADRs, design docs) in the directories the change touches, and add the decisions that bear on it to the intent.

    line 16
  2. Distinctive:

    Verify each finding per arena Phase F by rerunning its command.

    line 26

“Common” is measured: kept by at least 6 in 10 of the 73 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Interrogate

Adversaries try to break a change or a design. A finding survives only when a run proves it. Report the findings. Do not apply fixes. When a poteto-mode playbook runs this skill as its pre-PR gate, hand the findings back to it instead of ending the turn. The gate's rules are Opening a PR step 2.

Frame

The scope is what the user names. Given a PR number or URL, it is that PR: read it with gh pr view <pr> --json title,body,baseRefName,headRefOid,files and gh pr diff <pr>. Otherwise it is the branch diff from its merge base with the base branch, through the working tree. State the intent with the in-your-own-words skill (${CLAUDE_SKILL_DIR}/../in-your-own-words/SKILL.md), from the user's message, the commits, and the PR description. Ask the user when the intent is unclear.

Take every blind-spot lens in ${CLAUDE_SKILL_DIR}/references/blind-spots.md whose "Use when" the change meets. A matching lens is never optional. Diff-scoped attacks cannot see what is missing, and the lenses cover that gap.

Read the decision records (ADRs, design docs) in the directories the change touches, and add the decisions that bear on it to the intent. A change that quietly reverses one breaks the intent.

Fan out

Run Phase A steps 3 and 4 and Phase B of the arena skill (${CLAUDE_SKILL_DIR}/../arena/SKILL.md), with four changes. Read the interrogate reviewers role in ${CLAUDE_SKILL_DIR}/../poteto-mode/references/models.md in place of arena runners. Spawn each adversary with subagent_type: "general-purpose" and isolation: "worktree", and name the commit it checks out: the PR's head SHA for a PR, otherwise the current HEAD. Copy the scope's uncommitted changes into each worktree. In place of the arena task and rationale, give each adversary the scope, the intent, the chosen lenses, and this brief:

Break this change. Prove each finding with a run against the real code, such as a failing test, a repro script, or command output that shows the wrong behavior. For a design or plan, run a prototype or probe the current tree. Keep repros in your own worktree, and never push. Report each finding with a title, the exact command, the output it printed, and the output the intent requires. Leave out anything you did not run. That covers style, naming, structure, and risks that need a future change to matter. No findings is a valid result.

Verify

Verify each finding per arena Phase F by rerunning its command. Keep a finding when the output shows the failure and the failure breaks the intent. Drop the rest. Merge findings that share a root cause.

Skip arena Phases C, D, and E. Adversaries find different failures, so the verdict keeps every verified finding, not one adversary's list.

Output

  • Intent: the restatement.
  • Findings: for each verified finding, the command, its output, how it breaks the intent, and the adversaries that found it. Say "no verified findings" when none survive.
  • Dropped: for each adversary, the count of dropped findings and why.

Someone else's PR

When the PR belongs to another author, the findings become review comments that person will read. Turn each verified finding into a comment per ${CLAUDE_SKILL_DIR}/references/review-comments.md, run them through the unslop skill (${CLAUDE_SKILL_DIR}/../unslop/SKILL.md), and show the full draft to the user. Post nothing until the user explicitly says to.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.