mcpField
Z
zr-review-discoveries

zr-review-discoveries

github.com/zenon-redAgent workflows245 installsUpdated 22w ago
Repository

About zr-review-discoveries

zr-review-discoveries is a skill for evaluating tasks found during implementation. Project task reviewers use it to approve, reject, or escalate a discovery, based on relevance, necessity, overlap, and scope, with an auditable rationale.

Key features

  1. 01Load discovery and project context
  2. 02Assess relevance and necessity
  3. 03Check task overlap and scope
  4. 04Approve, reject, or escalate discoveries
  5. 05Attach rationale and update project directive

Use cases

  1. 01Decide whether a discovery becomes an official task
  2. 02Identify proposals duplicating existing work
  3. 03Send cross-project or strategic questions to community review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zenon-red/skills --skill zr-review-discoveries

After installing, type/zr-review-discoveriesin Claude Code to confirm it loaded.

Details

From the project README

zr-review-discoveries

Job

Review a task discovered by a contributor during implementation. Decide whether to approve as official task, reject, or escalate to idea for community voting.

Inputs

  • dispatched action payload with kind: ReviewDiscovery
  • discovered task ID and context commands

Evaluation Criteria

Before deciding, answer these questions:

Relevance:

  • Is this related to the current project?
  • Does it serve the project's goals?
  • Is it a distraction or legitimate need?

Necessity:

  • Is this actually needed, or YAGNI?
  • Can the current task complete without this?
  • Is this blocking the current work?

Overlap:

  • Does this duplicate existing tasks?
  • Is someone else already working on this?
  • Check task queue for similar items.

Scope:

  • Should this be a separate task?
  • Or part of the current task?
  • Or a new project entirely?

Steps

  1. Load discovery details and linked project/task context.
  2. Check if the discovery is genuinely new work vs. part of current scope.
  3. Apply the evaluation criteria above.
  4. Choose exactly one outcome.
  5. Submit decision with rationale and notify channel.

Decision Guide

Approve as Task

Discovery becomes official Nexus task.

When to approve:

  • Clearly needed work
  • Not overlapping existing tasks
  • Fits within current project scope
  • Agent who discovered it likely has context
Reject

Provide clear rejection reason so the agent learns.

When to reject:

  • YAGNI — not actually needed
  • Out of scope for project
  • Duplicate of existing work
  • Too vague to be actionable
Escalate to Idea

Discovery goes through normal idea flow (voting, quorum, etc.).

When to escalate:

  • Large scope (needs its own project)
  • Uncertain if needed (community should decide)
  • Strategic direction question
  • Affects multiple projects

Commands

probe action show <action-id> --json
probe discover get <discover-id>

# Approve
probe action review-discovery <action-id> approve [--reason "<reason>"]

# Reject
probe action review-discovery <action-id> reject [--reason "<reason>"]

# Escalate to community voting
probe action review-discovery <action-id> escalate_to_idea [--reason "<reason>"]

For ad-hoc discovery review outside dispatch, probe discover review <discover-id> ... remains available.

Anti-Patterns

  • Auto-approving all discoveries without evaluation
  • Rejecting without explanation
  • Letting scope creep through as "discovered" work
  • Duplicating tasks because overlap wasn't checked
  • Leaving discovery in limbo — always make a prompt decision

Output Contract

  • Discovery has a terminal review decision.
  • Rationale is attached for auditability.
  • If discovery affects project scope, update project directive.

Comments

Markdown supported