llp-review

Stars13

Forks1

UpdatedJuly 23, 2026 at 18:03

Run the LLP 0005 review loop for an LLP document — orchestrate reviews from other model families, write one provenance-tracked artifact per review actually received under llp/reviews/, and never fabricate a review or accept on the author's behalf. Review intensity scales with stakes; the author decides when it's enough.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

ccheever

ccheever/llp

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	llp-review
description	Run the LLP 0005 review loop for an LLP document — orchestrate reviews from other model families, write one provenance-tracked artifact per review actually received under llp/reviews/, and never fabricate a review or accept on the author's behalf. Review intensity scales with stakes; the author decides when it's enough.
source	ccheever/llp@v0.3.0

llp-review

Review an LLP the way LLP 0005 prescribes: as much critical review as the stakes warrant, captured honestly. Different model families catch different blind spots, so a single session cannot stand in for a multi-family loop — this skill makes the honest path the only path.

Invoke as /llp-review <number | slug | filename>. Bare: list Draft/Review LLPs and ask.

Trigger

A document enters Review (the author's opt-in to a formal loop), or review is explicitly requested. Otherwise offer review scaled to stakes (LLP 0005 §How much review to buy) — don't impose it.

Invariants

MUST NOT fabricate a review, record one that wasn't actually provided, or mark a loop complete by intent.
MUST NOT count the session that authored the draft as an independent reviewer — if this session wrote the document, say so and gather reviews elsewhere.
MUST NOT change **Status:** or accept/reject — propose transitions; the author decides.
MUST write one artifact per review actually received: llp/reviews/NNNN-slug.<family>.md, opening with the LLP 0005 provenance header (family · provider/runtime · date · redacted? · method). Re-reviews by the same family get a dated section, never an overwrite.
MUST NOT send content to an external provider without an explicit human action; redact secrets by default.

Workflow

Recipe (advisory) — locate and read the document fully. If this session can act as one independent family reviewer (and didn't author the draft), write that review using the LLP 0005 standard prompt. For each further input the author wants — pasted manual review, sub-agent on a different family, CLI runner — prepare the prompt and stop until it is actually provided. Structure each review body: overall assessment · strengths (cite sections) · concerns (with severity and what would resolve each) · suggestions · open questions · recommended next step.

Artifact

Review files under llp/reviews/ with provenance headers, plus a summary of the feedback and a proposed next step (revise and stay Draft / gather another family / ready for the author to accept).

Hand-offs

Feedback that amounts to a new design direction → a fresh LLP via llp-create.
The author applies status changes; this skill never does.

More from this repository

same repository

llp-super-refine

ccheever/llp

Author-invoked dual-family refine loop for one or more Draft/Review LLPs — each round, two fresh mutually-blind reviews from different model families, orchestrator revision, verdict-lined artifacts — until both families mark the same revision READY, a delta round finds no MATERIAL concern in pre-existing text across families, or a bounded stop rule escalates to the author. Use when the user invokes /llp-super-refine or asks to refine an LLP until independent models agree it is ready.

2026-07-2415

llp-create

ccheever/llp

Create a new LLP document with the next available number, the NNNN-slug.type.md filename convention, and a scaffolded metadata header — or extend an existing LLP when one already covers the topic.

2026-07-2315

llp-maintain

ccheever/llp

Keep an LLP corpus in sync with its code. Detects code/doc drift, validates @ref annotations interactively, checks provenance tags, and proposes reconciliations, ref repairs, and status changes. Modes — pre-pr, audit, reconcile, retire-proposal. Proposes; never applies.

2026-07-2315

llp-orient

ccheever/llp

Before editing a subsystem, file, or starting a task, assemble the governing LLP context — read the root LLP, follow the @ref annotations on the code in scope, and find the LLPs covering the relevant systems. Produces a compact context pack of the constraints a change must respect. Read-only.

2026-07-2315

llp-ship

ccheever/llp

Take one or more tasks (Linear tickets, ticket files, accepted LLPs, free text) end to end — plan lanes, implement in run-namespaced worktrees, integrate on a run branch, verify and review the exact integrated commit, deliver per repo policy (direct push by default), and clean up without destroying recoverable work. Use when the user invokes /llp-ship or hands over tasks to be implemented and shipped.

2026-07-2315

llp-adopt

ccheever/llp

Bring LLP to a repository and keep its installed skills current — the single entry point for "set up LLP here" and "update the LLP skills". Scaffold mode (fresh structure), retrofit mode (survey the codebase, draft a provenance-tagged root LLP, propose an adoption plan), install step (copy skills from a tagged release with a receipt), and update mode (verified, diff-approved skill updates).

2026-07-2315

name	llp-review
description	Run the LLP 0005 review loop for an LLP document — orchestrate reviews from other model families, write one provenance-tracked artifact per review actually received under llp/reviews/, and never fabricate a review or accept on the author's behalf. Review intensity scales with stakes; the author decides when it's enough.
source	ccheever/llp@v0.3.0

llp-review

Invoke as /llp-review <number | slug | filename>. Bare: list Draft/Review LLPs and ask.

Trigger

Invariants

MUST NOT fabricate a review, record one that wasn't actually provided, or mark a loop complete by intent.
MUST NOT count the session that authored the draft as an independent reviewer — if this session wrote the document, say so and gather reviews elsewhere.
MUST NOT change **Status:** or accept/reject — propose transitions; the author decides.
MUST write one artifact per review actually received: llp/reviews/NNNN-slug.<family>.md, opening with the LLP 0005 provenance header (family · provider/runtime · date · redacted? · method). Re-reviews by the same family get a dated section, never an overwrite.
MUST NOT send content to an external provider without an explicit human action; redact secrets by default.

Workflow

Recipe (advisory) — locate and read the document fully. If this session can act as one independent family reviewer (and didn't author the draft), write that review using the LLP 0005 standard prompt. For each further input the author wants — pasted manual review, sub-agent on a different family, CLI runner — prepare the prompt and stop until it is actually provided. Structure each review body: overall assessment · strengths (cite sections) · concerns (with severity and what would resolve each) · suggestions · open questions · recommended next step.

Artifact

Hand-offs

Feedback that amounts to a new design direction → a fresh LLP via llp-create.
The author applies status changes; this skill never does.