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.