Specboot: Augmented Spec-driven development

Boot OpenSpec’s Spec-Driven in any project and give superpowers to any coding agent.

This repository contains a comprehensive set of development rules, standards, and AI agent configurations designed to work seamlessly with multiple AI coding copilots. The setup is portable and can be imported into any project to provide consistent, high-quality AI-assisted development.

It’s highly recommended to be used along with Spec-Driven Development frameworks like OpenSpec

📁 Repository Structure

.
├── docs/                        # Development standards and specifications
│   ├── base-standards.md        # Core development rules (single source of truth)
│   ├── backend-standards.md
│   ├── frontend-standards.md
│   ├── documentation-standards.md
│   ├── api-spec.yml             # OpenAPI specification
│   ├── data-model.md            # Database and domain models
│   ├── development_guide.md
├── ai-specs/
│   ├── agents/                  # Agent role definitions (backend, frontend, analyst, etc.)
│   └── skills/                  # Reusable skill prompts/workflows
│
├── AGENTS.md                    # Generic agent configuration
├── CLAUDE.md                    # Claude-specific configuration
├── codex.md                     # GitHub Copilot/Codex configuration
└── GEMINI.md                    # Gemini-specific configuration

🤖 Multi-Copilot Support

This repository uses symbolic links or naming conventions to support multiple AI coding copilots without duplication:

• AGENTS.md → Generic agent rules (works with most copilots)
• CLAUDE.md → Optimized for Claude/Cursor
• codex.md → Optimized for GitHub Copilot/Codex
• GEMINI.md → Optimized for Google Gemini

All these files reference the same core rules in docs/base-standards.md, ensuring consistency across different AI tools while allowing copilot-specific customizations.

Why This Approach?

✅ Single Source of Truth: Core rules maintained in one place (base-standards.md)
✅ Copilot Compatibility: Each AI tool finds its configuration using its preferred naming convention
✅ Zero Configuration: Import into a new project and it works immediately
✅ Easy Updates: Update rules once, all copilots benefit
✅ Portable: Copy this structure to any project

🚀 Quick Start

1) Install and Initialize OpenSpec

OpenSpec works great with this repository and is recommended for a spec-driven workflow.

Quick Start requirements from OpenSpec official docs:

• Node.js 20.19.0 or higher

Install OpenSpec globally:

npm install -g @fission-ai/openspec@latest

Then navigate to your project and initialize:

cd your-project
openspec init

2) Import Into Your Project