SpecLeap Framework

2.1.1 · active · verified Sun Apr 19

SpecLeap is a Spec-Driven Development (SDD) framework designed to transform AI-powered IDEs (like VSCode, Cursor, JetBrains) into 'spec-first' development environments. Currently at version 2.1.1, it focuses on delivering quality software by enforcing immutable 'CONTRATO.md' specifications, leveraging specialized AI agents (Backend, Frontend, Product), and utilizing conversational commands (e.g., `refinar`, `planificar`, `implementar`) in Spanish. Key differentiators include its multi-project support, enforcement of global code standards (Laravel, React), and an optional CLI for automation. It aims to solve common AI development problems like contextless code generation, incomplete specifications, lack of memory, and uncontrolled scope changes by providing a structured, persistent, and guided development flow. The framework's release cadence is not specified in the provided documentation.

Common errors

```
Error: Node.js version is too old. Expected >=18.0.0 but got vX.Y.Z
```
cause The system's current Node.js version does not meet SpecLeap's minimum requirement.

fix Update your Node.js to version 18 or higher. You can use `nvm install 18 && nvm use 18` or download the latest LTS from nodejs.org.
```
GitHub token invalid or insufficient permissions. Please check your token scopes.
```
cause The provided GitHub Personal Access Token is either incorrect, expired, or lacks the required `repo` and `workflow` permissions for SpecLeap's operations.

fix Generate a new GitHub Personal Access Token at https://github.com/settings/tokens (classic token), ensuring both `repo` and `workflow` scopes are enabled.
```
Asana token invalid or workspace not accessible.
```
cause The Asana Personal Access Token provided during setup is incorrect, revoked, or does not grant access to any associated Asana workspace.

fix Verify your Asana token at https://app.asana.com/0/my-apps and ensure it is active and correctly copied. Also confirm that your Asana account has access to the intended workspace.

Warnings

breaking SpecLeap requires Node.js version 18.0.0 or higher. Attempting to install or run the framework with older Node.js versions will result in errors or prevent proper operation.
Fix: Upgrade your Node.js environment to version 18.0.0 or newer. Tools like nvm (Node Version Manager) can help manage multiple Node.js versions easily: `nvm install 18 && nvm use 18`.
gotcha The installation is an interactive process that requires generating and providing multiple API tokens (GitHub, Asana) with specific permissions. Failure to provide correct tokens or adequate scopes will halt the setup.
Fix: Before running the installer, obtain a GitHub Personal Access Token with `repo` and `workflow` scopes, and an Asana Personal Access Token. Follow the 'Tokens Necesarios' section in the documentation for detailed instructions.
gotcha The initial setup of SpecLeap is comprehensive, involving the installation of 34 Agent Skills and configuring various services. This process is time-consuming, typically taking 10-15 minutes, and requires a stable internet connection for downloads and configurations.
Fix: Allocate sufficient time for the installation to complete without interruption. Ensure you have a reliable internet connection to prevent download failures during the Agent Skill setup.

Install

npm install specleap-framework npm
yarn add specleap-framework yarn
pnpm add specleap-framework pnpm

Imports

SpecLeap CLI
wrong:
```
import { algunaFuncion } from 'specleap-framework'
```
correct:
```
npx specleap-framework@latest
```
SpecLeap is primarily a CLI-driven framework for project initialization and orchestration of AI agents. It is not intended for direct programmatic import into user applications. Its core functionality is accessed via the `npx` command for setup and interaction.

Quickstart

This command initiates the interactive SpecLeap framework installer, which prompts for necessary API tokens (GitHub, Asana) and sets up the complete project structure along with 34 specialized Agent Skills.

npx specleap-framework@latest

view raw JSON →