Skip to content

jw-tecuri/code-review-artifact-codex-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Code Review Artifact Codex Plugin

Code Review Artifact packages the $code-review-artifact skill for Codex. It reviews branches, pull requests, patches, and local diffs, then creates two durable review artifacts: Markdown and a self-contained, script-free HTML report under Python's writable system-temp directory by default.

The report is designed primarily for constructive feedback to junior developers. It emphasizes evidence-based strengths, prioritized next actions, focused syntax-highlighted snippets, concrete recommendations, and verification steps. Generated artifacts stay outside the active repository by default in a private system-temp directory.

Install

Add this repository as a Codex plugin marketplace:

codex plugin marketplace add jw-tecuri/code-review-artifact-codex-plugin

Then open the Codex plugin directory and install Code Review Artifact from the code-review-artifact-codex-plugin marketplace.

Use

Start a new Codex thread after installing, then ask:

Use $code-review-artifact to review this branch and create Markdown and HTML review artifacts.

The skill records validation commands individually, distinguishes executed and blocked checks, renders affected files as a collapsed section, and presents each finding with priority, evidence, impact, a focused code excerpt, a recommended change, and verification guidance. Artifact creation and pruning are serialized across concurrent invocations, files are created with private permissions from the first write, and abandoned pending output is recovered by the next invocation.

For reliable transport, the writer can consume an existing UTF-8 Markdown file with --markdown-file and optionally reject a mismatched --expected-sha256. Every successful manifest includes byte counts, SHA-256 digests, code-block fidelity, and class-order-independent semantic HTML validation. Existing artifacts can be rechecked with the bundled validate_review_artifacts.py --manifest ... command.

Contents

  • .agents/plugins/marketplace.json: plugin marketplace catalog.
  • plugins/code-review-artifact: Codex plugin package.
  • plugins/code-review-artifact/skills/code-review-artifact: bundled skill, renderer, artifact writer, and regression tests.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages