setup

Initializes Specture project configuration in bootstrap, adopt, or reconfigure modes.

1|Updated May 1, 2026
One-click install
npx skills add https://github.com/FerEscobarDev/Specture --skill setup-ferescobardev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/FerEscobarDev/Specture/tree/main/skills/setup
Command: npx skills add https://github.com/FerEscobarDev/Specture --skill setup-ferescobardev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a spec-driven development workflow requires consistent configuration files, conventions, and architectural decision records, which are tedious and error-prone to create by hand. This Skill automates the initialization of the .specture/ configuration directory so every project starts from a validated, coherent baseline. ## Core Features & Use Cases - Three Detection Modes: Automatically detects whether a project is empty (Bootstrap), has existing code (Adopt), or is already configured (Reconfigure), and adapts the workflow accordingly. - Stack Detection and Wizard: Scans manifest files like package.json, *.csproj, go.mod, or pyproject.toml to infer the stack in Adopt mode, or runs an interactive question wizard in Bootstrap mode. - Configuration Generation: Produces stack.yml, conventions.md, rules.yml, settings.yml, ADR files, .gitignore entries, and a project CLAUDE.md from templates. - Use Case: A developer adopts Specture in an existing NestJS + PostgreSQL codebase; the Skill detects the stack, drafts a configuration, validates it with the user, and writes all config files plus an adoption ADR. ## Quick Start Ask the assistant to configure Specture for this project by saying "configura el proyecto" or invoking the setup command.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Specture in an existing project?▼

Invoke the setup skill and it detects Adopt mode when source files exist without `.specture/stack.yml`. It scans manifests like package.json, *.csproj, or go.mod to infer the stack, shows you a draft configuration for validation, then writes all config files.

What files does Specture setup generate?▼

Setup generates `.specture/stack.yml`, `conventions.md`, `rules.yml`, `settings.yml`, an initial ADR in `.specture/decisions/`, four `.gitignore` entries for state and telemetry, and a root `CLAUDE.md` that imports the Specture framework.

Can I change Specture configuration after initial setup?▼

Yes, Reconfigure mode handles updates to stack, conventions, rules, or settings. If a change supersedes an existing ADR, it creates a new ADR marked as superseding the old one rather than deleting prior decisions.

Does Specture setup work with monorepos or multiple apps?▼

Yes, the wizard asks which apps the project contains (backend API, web, mobile, landing) and records them under `structure.apps` in stack.yml with a `by-app-suffix` root layout. CLI or library projects can use a flat layout instead.

Why does Specture setup fail verification before completing?▼

Verification fails if stack.yml is invalid YAML, conventions.md still contains placeholders, settings.yml lacks the correct schema_version, no ADR exists, or CLAUDE.md is missing. The skill fixes each failing check before reporting completion.