spec-first-test-scaffolding

Scaffold executable smoke or contract tests per software seam under tests/.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/BSchafer01/PanelNester --skill spec-first-test-scaffolding
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-first-test-scaffolding
Source: https://github.com/BSchafer01/PanelNester/tree/main/.squad/skills/spec-first-test-scaffolding
Command: npx skills add https://github.com/BSchafer01/PanelNester --skill spec-first-test-scaffolding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating robust acceptance coverage early by scaffolding executable tests before implementation work begins, preventing gaps in the seam.

Core Features & Use Cases

  • Create a dedicated test project per seam under tests/ (Desktop, Services, Domain).
  • Add one runnable smoke or contract test that can pass against existing code.
  • Use tiny spec helpers to encode expected rules so acceptance is verifiable.
  • Include skipped tests with precise blockers for unimplemented integration checks.
  • Pair tests with a matrix mapping cases to success criteria or failure modes.
  • Record contract gaps to guide implementation teams.

Quick Start

Create a test project per seam under tests/ and add a single runnable smoke or contract test that passes today.

Frequently Asked Questions about spec-first-test-scaffolding

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

FAQPage Schema
How do I set up executable tests before coding begins?▼

To set up executable tests before coding, scaffold a dedicated test project per architectural seam under tests/ and add a single runnable smoke or contract test that passes today.

What is spec-first testing and how does it prevent integration gaps?▼

Spec-first testing creates acceptance coverage early by scaffolding executable tests before implementation, using spec helpers and a contract-gap log to record unimplemented checks and prevent gaps in the seam.

How do I create a contract test for a service seam?▼

Create a dedicated test project for the service seam under tests/, add a runnable contract test against existing code, and use tiny spec helpers to encode expected rules for verifiable acceptance.

Do I need an existing codebase to scaffold acceptance criteria tests?▼

No, you can scaffold acceptance criteria tests before implementation begins, but you need at least one runnable smoke or contract test that can pass against existing code to establish a baseline.

How do I track unimplemented integration checks during test scaffolding?▼

Track unimplemented integration checks by including skipped tests with precise blockers and recording contract gaps in a log to guide implementation teams toward closing the seams.

Best way to organize test projects for multiple architectural seams?▼

Organize test projects by creating a dedicated project per seam under tests/, such as Desktop, Services, or Domain, and pair them with a matrix mapping test cases to success criteria or failure modes.