spec-harness-plan

Convert finalized product specifications into structured design.md documents aligned with project standards.

28|2|Updated Oct 3, 2025
One-click install
npx skills add https://github.com/chohra-med/expo_boilerplate --skill spec-harness-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-harness-plan
Source: https://github.com/chohra-med/expo_boilerplate/tree/main/.claude/skills/spec-harness-plan
Command: npx skills add https://github.com/chohra-med/expo_boilerplate --skill spec-harness-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates inconsistent, incomplete architecture planning that leads to rework, misalignment with team coding standards, and broken AI-generated code that fails to follow existing system patterns when implementing new features.

Core Features & Use Cases

  • Structured Design Document Generation: Produces standardized design.md files that outline architecture decisions for new feature implementations.
  • Standards Alignment: Ensures all design choices honor the project's constitution.md and existing system architecture, avoiding redundant rebuild of already existing components.
  • Use Case: When your team finalizes a spec for a new in-app purchase feature, use this skill to generate a design doc that aligns with your existing payment and auth patterns already present in the codebase.

Quick Start

Use the spec-harness-plan skill to create a design document for the new user profile editing feature spec we just approved.

Frequently Asked Questions about spec-harness-plan

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

FAQPage Schema
How do I turn a finalized product spec into an architecture design document?

To turn a product spec into an architecture design document, apply a spec-driven development workflow that transforms finalized specifications into structured design.md files aligned with project standards. This ensures implementation honors existing system architecture without rebuilding components.

What is spec-driven development architecture planning?

Spec-driven development architecture planning is the process of generating structured design artifacts from finalized product specifications. It acts as the second step after spec creation, ensuring new feature designs align with team coding standards and existing codebase patterns.

How do I generate design docs that align with existing system architecture?

Generate design docs that align with existing system architecture by using a planning skill that checks project constitution rules and verifier constraints. This prevents redundant component rebuilds and ensures new features match established auth or payment patterns.

Does spec-driven development planning work without rebuilding existing components?

Yes, spec-driven development planning works without rebuilding existing components by enforcing standards alignment with the project's constitution.md. It analyzes finalized specifications to produce design artifacts that strictly honor the current system architecture.

Why do AI-generated code implementations break existing system patterns?

AI-generated code breaks existing system patterns due to inconsistent architecture planning that lacks alignment with project coding standards. Without structured design documents generated from finalized specs, implementations fail to follow established codebase conventions.

What are the limitations of generating architecture design documents from specs?

A limitation of generating architecture design documents from specs is the strict dependency on finalized product specifications and a project constitution.md. Without these prerequisite inputs and ratcheted rules, the design generation cannot accurately honor existing system architecture.