gap-revealing-build

Probe software designs by attempting partial implementations and documenting ambiguities.

3|2|Updated May 12, 2026
One-click install
npx skills add https://github.com/kriscendobot/garden --skill gap-revealing-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-revealing-build
Source: https://github.com/kriscendobot/garden/tree/main/skills/gap-revealing-build
Command: npx skills add https://github.com/kriscendobot/garden --skill gap-revealing-build

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill prevents the waste of building features on top of under-specified or ambiguous designs by forcing a structured discovery process that identifies missing requirements early.

Core Features & Use Cases

  • Structured Gap Inventory: Automatically generates a four-field report for every ambiguity encountered during implementation.
  • Skeleton Implementation: Builds the necessary scaffolding to verify that the clear parts of a design actually compose, while stubbing out ambiguous areas.
  • Use Case: When a maintainer is unsure if a new architectural design is viable, use this skill to attempt an implementation that stops at every ambiguity, providing a clear report on what needs to be resolved before full-scale development begins.

Quick Start

Instruct the gardener to probe the design at pull request number 123 to reveal implementation gaps.

Frequently Asked Questions about gap-revealing-build

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

FAQPage Schema
How do I identify missing requirements in a software architecture design before coding?

To identify missing requirements in a software architecture design, you can probe the design by attempting a partial implementation that stops at every ambiguity and generates a structured gap inventory. This validates technical feasibility and prevents building on under-specified designs.

What is gap analysis in software prototyping and when do I need it?

Gap analysis in software prototyping is a structured discovery process that documents structural ambiguities by building skeleton implementations. You need it when you are unsure if a new architectural design is viable and must verify technical feasibility before full-scale development.

How do I validate a GitHub pull request design for technical feasibility?

To validate a GitHub pull request design for technical feasibility, instruct the tool to probe the design at the specific pull request number. It will build scaffolding to verify clear parts compose while stubbing out ambiguous areas in a draft-only PR output.

Does this gap analysis approach require a fully specified design to start?

No, this gap analysis approach does not require a fully specified design to start. It applies to design validation workflows by intentionally building skeleton implementations that stub out ambiguous areas, specifically designed to handle under-specified or ambiguous designs.

What are the limitations of using skeleton implementations for design validation?

The limitation of using skeleton implementations for design validation is that the design must be reachable in the worktree. Additionally, it follows a strict draft-only PR output protocol, meaning it stops at ambiguities rather than completing the full feature build.