This document is the README for Spec-Driven Development with CoreStory + Spec Kit. For more detailed walkthroughs and advanced patterns, see our playbook docs:

CoreStory + Spec Kit Basic Playbook

CoreStory + Spec Kit Advanced Playbook

Transform spec-driven development from “write specs and hope” to “write specs grounded in actual architecture.”

Overview

This playbook combines GitHub’s Spec-Kit (specification-driven development framework) with CoreStory’s code intelligence to create specifications, plans, and tasks that are architecturally consistent, technically sound, and properly integrated with your existing codebase.

The Problem

Traditional Spec-Driven Development:

• ❌ Specifications based on generic best practices
• ❌ Plans that don’t account for existing architecture
• ❌ Tasks that miss critical integration points
• ❌ Implementation that requires extensive rework

Result: 20-40% of development time spent on architectural rework

The Solution

CoreStory-Enhanced Spec-Driven Development:

• ✅ Specifications grounded in existing codebase patterns
• ✅ Plans validated against actual architecture
• ✅ Tasks that identify all integration points
• ✅ Implementation that follows established patterns

Result: 25-30% faster time to production, 60-75% reduction in architectural rework

Quick Start

Prerequisites

1. Install Spec-Kit:

npm install -g @github/specify
# or npx @github/specify init

2. Choose Your AI Agent:

When running the specify-init command, use the —ai argument to select an agent, including:

• Claude Code
• GitHub Copilot
• Cursor
• Gemini CLI
• Any other agent with Spec-Kit support