factory-review

Generate audit trail summaries, PR digests, and retrospective syntheses from factory build data.

1|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/jwilger/agent-skills --skill factory-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: factory-review
Source: https://github.com/jwilger/agent-skills/tree/main/skills/factory-review
Command: npx skills add https://github.com/jwilger/agent-skills --skill factory-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured human review experience for factory-mode builds, delivering concise audit trails, digests, retrospective synthesis, and quality insights to support fast, safe decision-making.

Core Features & Use Cases

  • Audit Trail Summaries: Reads from .factory/audit-trail to present a clear build overview with slices completed, rework rate, gate outcomes, and escalations.
  • PR Digests & Retrospective Synthesis: Produces concise, 3-5 sentence summaries for merged PRs and aggregates retrospectives into actionable patterns.
  • Quality Trend & Escalation Management: Surface metrics from audit trails to guide escalation resolution and continuous improvement.

Quick Start

Run the factory review workflow during Phase 3 to generate audit-trail digests and retrospective synthesis from your build data.

Frequently Asked Questions about factory-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate audit trail summaries for factory-mode builds?

Audit trail summaries for factory-mode builds are generated by reading data from the .factory/audit-trail directory to present build overviews, completed slices, rework rates, and gate outcomes. This Skill structures that data into high-signal insights for human review.

What is the best way to summarize merged PRs for retrospective synthesis?

Retrospective synthesis for merged PRs is produced by generating concise 3-5 sentence summaries and aggregating ensemble-team retrospectives into actionable patterns. This approach extracts quality trends from audit trails to guide continuous improvement.

Do I need a pipeline skill and ci-integration data to run factory reviews?

Yes, running factory reviews requires the pipeline skill, ensemble-team retrospectives, and ci-integration data sources. These dependencies are necessary to read audit trails and produce artifacts during Phase 3 gatekeeping.

Can I surface quality trends and escalation metrics from build audit trails?

Yes, quality trends and escalation metrics are surfaced from audit trail data to guide escalation resolution. The Skill reads .factory/audit-trail sources to present metrics like rework rate and gate outcomes for continuous improvement.

When should I use factory review governance during the build pipeline?

Factory review governance should be applied during Phase 3 of the build pipeline. It is used to produce audit trail digests and retrospective synthesis, streamlining the human gatekeeping experience for fast and safe decision-making.

What limitations exist when structuring human reviews for factory-mode builds?

Structuring human reviews for factory-mode builds is limited by its reliance on .factory/audit-trail data and specific dependencies. Without the pipeline skill, ensemble-team retrospectives, and ci-integration data sources, it cannot read audit trails or produce review artifacts.