Executive Summary

Use Case: Combine GitHub Spec-Kit’s specification-driven development workflow with CoreStory’s code intelligence to create high-quality specifications grounded in existing codebase patterns, architecture, and business logic.

Value Proposition:

• Spec-Kit transforms intent into executable specifications
• CoreStory ensures specifications align with existing architecture, patterns, and constraints
• Together they enable AI agents to build features that architecturally consistent, technically sound, and properly integrated

The Power of This Combination:

• Specifications informed by actual codebase architecture (not generic AI patterns)
• Plans validated against existing technical constraints
• Tasks that respect established invariants and patterns
• Implementation that maintains architectural consistency

Table of Contents

1. Prerequisites & Setup
2. The Enhanced Five-Phase Workflow
3. Phase-by-Phase Integration
4. Constitution Development with CoreStory
5. Specification Enhancement Patterns
6. Planning with Architectural Context

Prerequisites & Setup

Required Tools

1. GitHub Spec-Kit

Installation:

npm install -g @github/specify
# ornpx @github/specify init

2. CoreStory Access

• Project ingested into CoreStory
• Ingestion status: “completed”
• MCP integration or API access configured

<aside> 💡

CoreStory MCP Server Setup & Usage Guide

</aside>