analyze

Convert scope and design documents into a build-ready readiness checklist with acceptance-criteria traceability.

Updated May 24, 2026
One-click install
npx skills add https://github.com/RCSnyder/lights-out-swe-plugin --skill analyze-rcsnyder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze
Source: https://github.com/RCSnyder/lights-out-swe-plugin/tree/main/skills/analyze
Command: npx skills add https://github.com/RCSnyder/lights-out-swe-plugin --skill analyze-rcsnyder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It prevents the BUILD phase from starting with an incomplete or ambiguous plan by turning scope.md and design.md into a concrete, testable readiness checklist.

Core Features & Use Cases

  • Acceptance criteria traceability: Maps every AC-* to design components plus planned tests and runtime proof.
  • Truths and risk gating: Captures non-negotiable truths, separates clarifications from risks, and explicitly flags scope-reduction temptations.
  • Build-order planning: Produces a deterministic build order carried forward into BUILD to reduce back-and-forth.

Quick Start

Run the Lights Out SWE: Analyze custom agent with scaffolding/scope.md and scaffolding/design.md present so it generates scaffolding/readiness.md and passes the post-analyze gates.

Frequently Asked Questions about analyze

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

FAQPage Schema
How do I generate a build readiness checklist from project scope and design documents?

To generate a build readiness checklist, you need to process your scope and design documents to map acceptance criteria to planned tests and runtime proofs, producing a concrete verification matrix before implementation begins. This ensures requirements traceability and validates completeness.

What is acceptance criteria traceability and how does it prevent incomplete test planning?

Acceptance criteria traceability is the process of mapping every requirement to specific design components, planned tests, and runtime verification paths. It prevents incomplete test planning by ensuring full coverage visibility and explicitly separating known truths from scope reduction risks before the build phase starts.

Can I use scope and design markdown files to gate an AI coding agent pipeline?

Yes, you can gate an AI coding agent pipeline by converting your scope.md and design.md files into a build-ready readiness checklist. The process outputs a READY or NOT READY verdict based on acceptance criteria coverage, preventing premature implementation.

How do I set up a deterministic build order for requirements traceability?

You can establish a deterministic build order by analyzing your project scope and design documents to sequence implementation tasks logically. This reduces back-and-forth during the BUILD phase by carrying forward a structured execution plan based on acceptance criteria mapping.

What is the best way to separate project truths from scope reduction risks before implementation?

The best way to separate truths from scope reduction risks is to explicitly categorize non-negotiable truths and flag potential scope reductions during the readiness analysis. This prevents ambiguity by capturing clarifications separately from actual implementation risks in the output checklist.

Why does my build phase start with an incomplete plan when using AI coding agents?

Your build phase starts with an incomplete plan because missing acceptance criteria traceability allows ambiguous requirements to pass through. Converting scope and design documents into a testable readiness checklist with explicit verification paths prevents premature implementation.