plan-review-output-format

Define a standardized JSON output format for plan review agents.

30|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/atomicinnovation/accelerator --skill plan-review-output-format
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review-output-format
Source: https://github.com/atomicinnovation/accelerator/tree/main/skills/review/output-formats/plan-review-output-format
Command: npx skills add https://github.com/atomicinnovation/accelerator --skill plan-review-output-format

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures plan review agents produce consistent, machine-readable outputs that orchestrators can parse reliably. Removes ambiguous narrative and enforces a predictable structure so automated merging, indexing, and downstream tooling behave deterministically.

Core Features & Use Cases

  • Structured JSON Schema: Defines top-level fields (lens, summary, strengths, findings) and the expected shape of each finding.
  • Field Reference & Formatting Rules: Documents required values (severity, confidence, location, title) and mandates Unicode emoji prefixes for severity levels.
  • Operational Use Cases: Ideal for multi-lens plan review pipelines, automated report generation, and orchestrators that merge agent outputs for QA or CI gating.

Quick Start

Return your analysis as a single JSON code block following the schema with no surrounding prose.

Frequently Asked Questions about plan-review-output-format

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

FAQPage Schema
How do I standardize JSON output for automated plan review agents?

To standardize JSON output for plan review agents, enforce a predictable schema with top-level fields like lens, summary, strengths, and findings. This ensures automated orchestrators can parse agent outputs reliably into structured reports.

What is the required JSON schema structure for multi-lens plan review pipelines?

The required JSON schema for multi-lens plan review pipelines includes top-level fields for lens, summary, strengths, and findings. Each finding object must contain keys for severity, confidence, location, and title to ensure deterministic merging.

How to format automated agent findings for reliable parsing in CI gating?

Format automated agent findings for CI gating by returning a single JSON block with no surrounding prose. Use Unicode emoji prefixes for severity levels within each finding body to maintain machine-readable structure.

Does this plan review format require specific fields for severity and confidence?

Yes, the plan review format requires specific per-finding keys including severity and confidence. It also mandates location and title fields, alongside Unicode emoji prefixes for finding bodies, to ensure automated tooling behaves deterministically.

When do I need a standardized JSON output format for orchestrators?

You need a standardized JSON output format for orchestrators when merging findings from multiple lens-specific agents in automated review workflows. It removes ambiguous narrative and allows downstream tooling to parse structured reports reliably.

Can I include narrative text alongside the JSON output in automated report generation?

No, you cannot include narrative text alongside the JSON output in automated report generation. The schema requires a single JSON block with no surrounding prose to ensure orchestrators parse the structured data deterministically without ambiguity.