ES
🏛️ Open Source Framework

SpecLeap Framework

Transform VSCode, Cursor, JetBrains, Vim, Zed, or any IDE with an AI assistant into a spec-first development machine. Immutable CONTRACT, specialized agents, and 20 professional Agent Skills.

View on GitHub → View Features
💖 Support the project: Ko-fi

✅ 100% Free · ✅ Open Source (MIT) · ✅ 20 Agent Skills · ✅ Spanish + English

❌ Without SpecLeap

  • • AI improvises code without context
  • • Incomplete specs → wrong implementation
  • • No memory → repeats mistakes
  • • Uncontrolled scope changes
  • • Generic and vulnerable code

✅ With SpecLeap

  • • CONTRACT defines immutable scope
  • • Context/ stores architectural decisions
  • • Specialized agents follow standards
  • • Conversational commands guide the flow
  • • 20 Agent Skills apply best practices

Key Features

🎯

Interactive Survey (ES/EN)

58 questions that automatically generate your complete CONTRACT.md in 20 minutes. Available in Spanish and English. Smart validations and partial saves.

⭐

20 TIER 1 Agent Skills

Security (OWASP, STRIDE), professional design (Vercel-style), DRY consistency, TDD, Laravel/React best practices.

🔒

Immutable CONTRACT

Defines scope and never changes. Change proposals via refinar command or openspec CLI.

💬

Conversational Commands

refinar, planificar, implementar, documentar. Natural conversational workflow.

🤖

Specialized Agents

Backend, Frontend, Product. Each with domain-specific rules.

📊

Asana + Jira

Automatically generates backlog from CONTRACT.md. Epics, user stories, and tasks ready for sprint.

📦

Monorepo Multi-Project

Each independent project in proyectos/ with its CONTRACT, context/, and code.

📚

Global Standards

PHP/Laravel, JavaScript/React, CSS/Tailwind, documentation. Consistency across all projects.

🛠️

openspec CLI (Optional)

Formal workflow with change proposals, delta specs, verification, and archiving.

🛡️

Automatic 3-Layer Validation

Pre-commit git hooks (<5 sec), full validation in implementar (1-5 min), CodeRabbit on PR (5-10 min). Quality guaranteed.

❓

Total Discoverability

Type ayuda (help) in chat and see ALL available commands (conversational + CLI).

🌍

Multilingual (ES + EN)

Entire framework translated: installer, survey, commands, documentation. Select your preferred language in the first step.

🛡️ Quality Guaranteed: 3-Layer Validation

SpecLeap automatically validates your code in 3 progressive levels to guarantee quality before reaching production.

1

Pre-Commit Git Hook (Automatic)

Runs before every commit. Fast validation in less than 5 seconds.

✅ Validates:

  • • Syntax (PHP, JS/TS)
  • • Linters (ESLint, PHPStan)
  • • Formatters (Prettier, PHP-CS-Fixer)
  • • CONTRACT.md not modified
  • • No console.log / var_dump

📦 Installation:

bash scripts/install-git-hooks.sh

❌ If fails: Rejects commit

2

Full Validation in `implementar` (1-5 min)

Runs when finishing a feature before push. Exhaustive validation.

✅ Validates:

  • • Unit tests
  • • Integration tests
  • • Compliance vs CONTRACT.md
  • • Compliance vs specs
  • • Coverage >= 80%

🚀 Result:

✅ If passes: Commit + Push + Creates PR

❌ If fails: No push, shows errors

3

CodeRabbit on PR (5-10 min)

Runs automatically when creating PR on GitHub. Deep review.

✅ Validates:

  • • Architecture and patterns
  • • Security (vulnerabilities)
  • • Business logic
  • • Cyclomatic complexity
  • • Documentation

💡 Setup:

1. .coderabbit.yaml already included

2. Install GitHub app

3. Open PR → Reviews automatically

✅ Result: Fewer bugs, faster code reviews, continuous learning

All 3 layers work together to ensure only quality code reaches production.

20 Agent Skills — The Difference

Agent Skills are specialized extensions that transform the quality of AI-generated code.

Without Skills

  • • Generic Bootstrap
  • • Basic vulnerabilities
  • • Frequent code duplication
  • • Inconsistent APIs
  • • Coverage <60%

With TIER 1 Skills

  • • Professional Vercel/Linear style
  • • OWASP Top 10 + STRIDE threat modeling
  • • Automatic DRY, verify before creating
  • • REST/GraphQL best practices
  • • TDD methodology, coverage ≥90%

🔒 Security (5)

  • • SAST config
  • • STRIDE threat
  • • Security extraction
  • • Backend/API security
  • • Frontend/Mobile security

🔄 Consistency (3)

  • • Verification-before-completion ⭐
  • • Code review excellence
  • • Systematic debugging

🎨 Design (6)

  • • Web design (Vercel)
  • • Frontend (Anthropic)
  • • UI/UX pro max
  • • Tailwind system
  • • shadcn/ui
  • • Responsive design

🛠️ Backend (6)

  • • Laravel specialist
  • • React best practices
  • • TDD
  • • API design
  • • PostgreSQL design
  • • Error handling

Complete Workflow

From idea to working code in clear steps.

1

Run Survey (20 min)

./scripts/generate-contrato.sh

# Answer 58 questions about your project
# Auto-save every 10 questions

Generates complete CONTRACT.md with all project information.

2

Push to GitHub (MANDATORY)

git init
git add .
git commit -m "init: CONTRACT.md + context/"
git push origin main

# CONTRACT.md is your source of truth
# Must be versioned from the start

⚠️ CONTRACT must be on GitHub before continuing.

3

Plan in Asana

# In chat with Claude/Cursor:
planificar

# Auto-generates backlog from CONTRACT.md
# Creates sections + user stories + tasks
4

Implement According to Spec

# In chat:
implementar "Google login"

# Verifies if it's in CONTRACT
# Reads context/ for context
# Generates code following standards
5

Document

# In chat:
documentar "User API"

# Generates OpenAPI/Swagger docs
# Updates technical README

Works with Your Favorite IDE

SpecLeap is IDE-agnostic. It works with any editor that has an AI assistant: VSCode, Cursor, JetBrains, Vim, or whatever you use.

💻

VSCode + Claude Code

Install the Claude Code extension in VSCode. SpecLeap works automatically with conversational commands and Agent Skills.

  • • Reads CLAUDE.md
  • • Commands: refinar, planificar, etc.
  • • Automatic Agent Skills
🤖

Cursor / Continue

Native IDEs with integrated Claude. Out-of-the-box full support.

  • • Native conversational commands
  • • Memory-bank in context/
  • • Integrated Agent Skills
🐙

GitHub Copilot

Uses .github/copilot-instructions.md + openspec CLI.

  • • Global standards in rules/
  • • Workflow via CLI
  • • Works in VSCode, JetBrains, Vim
⚡

Any IDE with AI

Gemini Code Assist, Codeium, Tabnine, or your preferred tool.

  • • Reads .md instruction files
  • • Standards in rules/
  • • openspec CLI always available

What matters: It doesn't matter which IDE you use. SpecLeap works because it reads files from your project (CONTRACT.md, rules/, context/), not because it depends on a specific tool.

Quick Installation

Ready in 10-15 minutes. Choose your preferred method: npm (faster) or GitHub (development).

📦

via npm

RECOMMENDED

Automatic installation with a single command.

npx specleap-framework@latest

✅ Download + interactive installer
✅ Always the latest stable version

🐙

via GitHub

For contributors or local development.

git clone https://github.com/iapanderson/specleap-framework.git
cd specleap-framework
bash install.sh

✅ Full control of source code
✅ Ideal for contributors

Installation Flow (Both Methods)

After running either command, you'll follow these steps:

1. Interactive Survey (10-15 min)

The installer starts automatically and asks you 58 questions about your project.

What it generates:
1. Select language (ES/EN)
2. Creates folder structure
3. Complete CONTRACT.md with all the information
4. Specialized agents + conversational commands

2. Configure Quality System (MANDATORY) 

# Asana + 20 Agent Skills + CodeRabbit + Git Hooks
bash scripts/setup-mcp.sh

# Or configure manually:
nano .env

Mandatory components:
✅ Asana (backlog) | ✅ CodeRabbit (code review) | ✅ 20 Skills (best practices) | ✅ Git Hooks (local validation) | ✅ GitHub (version control)
Without these components SpecLeap is NOT professional.
See SETUP.md for details.

3. Open in Your IDE 

code .        # VSCode
cursor .      # Cursor

# In the chat:
ayuda

Done! Type ayuda (help) to see all available commands.

💖 Support the Project

SpecLeap is 100% free and open-source. If you find it useful, you can support its development with a donation.

Support on Ko-fi

Donations help us:

  • ✅ Keep the framework updated
  • ✅ Develop new features
  • ✅ Improve documentation
  • ✅ Create more Agent Skills
  • ✅ Support the community

Start Today

100% free. No registration. No credit card. Just clone and start.

View on GitHub → Read Documentation