# MySpec (myspec.dev) — Spec-Driven Development Platform & MCP Server

> MySpec is the AI Senior Architect platform for Spec-Driven Development (SDD). It turns messy ideas into deterministic 4-file specification bundles (`constitution.md`, `requirements.md`, `solution.md`, `tasks.md`) and streams them directly into Cursor, Claude Code, and Windsurf via Model Context Protocol (MCP).

## Core Concepts & Philosophy

- **Spec-Driven Development (SDD)**: A software engineering methodology where structured, version-controlled specifications precede code generation to eliminate AI hallucinations, context window decay, and architectural spaghetti.
- **The 4-File Spec Bundle**:
  - `constitution.md`: Immutable rules, tech stack constraints, and coding standards.
  - `requirements.md`: EARS-compliant functional requirements and acceptance criteria.
  - `solution.md`: Technical architecture design, database schemas, and Mermaid.js diagrams.
  - `tasks.md`: Atomic, ordered, unit-testable implementation tasks for AI coding agents.
- **EARS Syntax**: Easy Approach to Requirements Syntax using 5 patterns (Ubiquitous, Event-Driven, State-Driven, Unwanted Behavior, Optional Feature).

## Key Pages & Documentation

- [Homepage](https://myspec.dev/): Platform overview, interactive 3D bundle visualizer, and feature tour.
- [Spec-Driven Development Guide](https://myspec.dev/spec-driven-development/): The complete engineering guide and topical authority hub on SDD.
- [MCP Server Setup](https://myspec.dev/mcp-server/): How to configure `@myspec/mcp-server` in Cursor and Claude Code.
- [GitHub Spec-Kit vs MySpec](https://myspec.dev/spec-kit-vs-myspec/): Comprehensive comparison between manual CLI templates and MySpec AI Senior Architect.
- [EARS Syntax Cheatsheet](https://myspec.dev/ears-syntax/): 5 deterministic requirements syntax patterns for AI models.
- [Vibe Coding Best Practices](https://myspec.dev/vibe-coding-best-practices/): How to vibe code at 10x velocity without breaking production.
- [Project Constitution Templates](https://myspec.dev/templates/constitution-md/): Free downloadable templates for Next.js, FastAPI, Go, and Mobile.
- [AI PRD Generator](https://myspec.dev/ai-prd-generator/): Turn a 1-sentence prompt into a complete 4-file spec bundle in 2 minutes.
- [The SDD Manifesto](https://myspec.dev/manifesto/): A declaration of intent for developers who believe clarity precedes code.

## Model Context Protocol (MCP) Quickstart

```bash
# In Cursor / Claude Code Settings -> MCP Servers
npx -y @myspec/mcp-server
```