zoo-plan-review

Review Zoo Workflow specs and active-subtask plans for correctness and completeness.

5|1|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/andreyvit/zoo --skill zoo-plan-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zoo-plan-review
Source: https://github.com/andreyvit/zoo/tree/main/.codex/skills/zoo-plan-review
Command: npx skills add https://github.com/andreyvit/zoo --skill zoo-plan-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides rigorous, structured reviews of Zoo Workflow specs and active-subtask plans to ensure they are correct, complete, and actionable before coding begins.

Core Features & Use Cases

  • Adversarial, evidence-backed plan critique that identifies gaps, ambiguities, and missing acceptance criteria.
  • Cross-checks alignment with Zoo contracts, design patterns, and product goals, with actionable revision notes.
  • Use Case: when a new Zoo workflow is proposed, run this review to surface risks and ensure testability and traceability.

Quick Start

Submit the Zoo spec and the relevant .zoo files to receive a structured critique and concrete revision suggestions.

Frequently Asked Questions about zoo-plan-review

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

FAQPage Schema
How do I review a Zoo Workflow spec for correctness and completeness?

To review a Zoo Workflow spec, submit your Zoo spec and relevant .zoo files to receive structured critiques. The review cross-checks alignment with Zoo contracts, design patterns, and product goals, providing actionable revision notes.

What is a Zoo plan review and when do I need it?

A Zoo plan review is a rigorous, evidence-backed critique of Zoo Workflow specs and active-subtask plans. You need this review when a new Zoo workflow is proposed, to surface risks, ensure testability, and verify traceability before coding begins.

Can I use plan review to check active-subtask implementation plans in Zoo?

Yes, you can use plan review to check active-subtask implementation plans in Zoo. The review evaluates .zoo/planning.md and .zoo/planreview.md artifacts, identifying gaps, ambiguities, and missing acceptance criteria across planning, design, tests, and browser flow.

What's the best way to find missing acceptance criteria in a Zoo planning artifact?

The best way to find missing acceptance criteria is through adversarial, evidence-backed plan critique. Submitting your .zoo files generates structured feedback with identified gaps and recommended changes, ensuring actionable and testable plans.

Do I need specific .zoo files to run a plan review?

Yes, you need specific .zoo files to run a plan review. Submitting the Zoo spec alongside .zoo/planning.md and .zoo/planreview.md files is required to receive structured critique and concrete revision suggestions aligned with the Zoo product contract.

Why does my Zoo workflow plan lack traceable decisions?

Your Zoo workflow plan lacks traceable decisions because it has not undergone a structured plan review. Running this review evaluates your planning artifacts for evidence and clarity, providing structured feedback with traceable decisions that align with the Zoo product contract.