Commentary
Claude Code integration

Give Claude Code a proper human review stage.

Claude Code can prepare the proposal. Commentary gives the team a readable workspace for challenging it, resolving decisions, and returning explicit revision context.

  • Repository marketplace plugin
  • Rendered plans
  • Structured feedback
  • Revision verification
Install

Add Commentary Review to Claude Code

Repository marketplace

Run both commands in Claude Code. The first adds the public skills repository; the second installs the review plugin.

Install the Commentary review plugin
/plugin marketplace add commentary-dev/commentary-skills
/plugin install commentary-review@commentary-skills

Source and setup details are maintained in commentary-dev/commentary-skills. This is a repository marketplace integration, not a vendor marketplace listing.

Reference workflow

Connect the agent to a human-owned review loop.

The artifact, feedback, revision, and approval state stay explicit from start to finish.

  1. 01

    Ask Claude Code to prepare the plan or specification.

    Start from an explicit artifact and named owner.

  2. 02

    Open the artifact as a Commentary Draft Review.

    Keep the current state and unresolved context visible.

  3. 03

    Collect domain-specific feedback in the rendered document.

    Keep the current state and unresolved context visible.

  4. 04

    Retrieve unresolved comments and revise the affected sections.

    Keep the current state and unresolved context visible.

  5. 05

    Verify Latest and Changes, then approve implementation.

    The next stage begins only after verification.

Challenge the proposal as a complete document.

Rendered review makes missing assumptions, contradictory acceptance criteria, and weak rollout plans easier to spot than a sequence of chat messages.

Return decisions, not a loose recap.

Claude Code receives unresolved comments attached to the relevant context. The team can then verify the new revision without reconstructing which chat instruction became final.

Suggested agent prompt

Human review, made explicit

Connect the agent. Keep approval human-owned.

Use Commentary with Claude Code to review plans and specifications as rendered documents, return structured comments, and verify revisions before implementation.