Commentary
Open appTry Commentary
Codex integration

Review a Codex plan before Codex implements it.

Use Commentary to turn an implementation plan into a durable human review. Reviewers comment on the rendered plan, Codex retrieves structured feedback, and implementation starts only after the team is satisfied.

  • Repository marketplace plugin
  • Draft Review
  • Structured unresolved comments
  • Human approval
View skills on GitHubTry a plan-review sample
Install

Add Commentary Review to Codex

Repository marketplace

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

Install the Commentary review plugin
codex plugin marketplace add commentary-dev/commentary-skills
codex plugin add 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 Codex to prepare the implementation plan.

    Start from an explicit artifact and named owner.

  2. 02

    Use the Commentary plugin to create a Draft Review.

    Keep the current state and unresolved context visible.

  3. 03

    Share the review with the relevant domain owners.

    Keep the current state and unresolved context visible.

  4. 04

    Review assumptions, scope, acceptance criteria, risks, rollout, and rollback.

    Keep the current state and unresolved context visible.

  5. 05

    Let Codex retrieve unresolved comments.

    Keep the current state and unresolved context visible.

  6. 06

    Have Codex revise only the affected sections.

    Keep the current state and unresolved context visible.

  7. 07

    Verify the latest version and approve implementation.

    The next stage begins only after verification.

Make the review gate explicit.

A plan sitting in chat is easy to supersede accidentally. A Commentary review gives the proposal an identifier, revision history, blocking feedback, and a visible verification state.

  • Name the plan of record.
  • Separate blocking decisions from suggestions.
  • Require verification after every material revision.

Keep implementation permissions separate from approval.

Installing a repository marketplace plugin gives Codex a workflow for creating and reading Commentary reviews. It does not make review approval automatic or broaden repository permissions.

Suggested agent prompt

Continue the workflow

Use the next page that matches the artifact or boundary you need to review.

Implementation-plan review guide

A complete checklist for reviewing before coding starts.

Read next

Security boundaries

Understand provider, preview, and agent permissions.

Read next

Security and access

Understand provider, preview, token, and human approval boundaries.

Review boundaries
Human review, made explicit

Connect the agent. Keep approval human-owned.

Use Commentary with Codex to open implementation plans for human review, retrieve unresolved feedback, revise the artifact, and wait for approval before coding.

View skills on GitHubTry a plan-review sample