skills.rest
rickardp
rickardpCOMMUNITY
Explore all skills by this author →
GitHub

blueprint:setup-repo

Generate a spec-driven repository skeleton with ADRs and docs.

2|Updated Jan 25, 2026
Search Tags:#workflow#documentation#adr#setup#specs#repo
One-click install
npx skills add https://github.com/rickardp/blueprint-mode --skill blueprint-setup-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blueprint:setup-repo
Source: https://github.com/rickardp/blueprint-mode/tree/main/plugins/blueprint-mode/skills/setup-repo
Command: npx skills add https://github.com/rickardp/blueprint-mode --skill blueprint-setup-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting a new software project often lacks a consistent, decision-focused blueprint. This Skill automates the creation of a spec-driven repository structure, including ADRs, patterns, and documentation scaffolds, so teams start with a stable foundation.

Core Features & Use Cases

  • ADR and spec scaffolding: Generates initial architecture decisions, goals, and patterns to guide implementation.
  • Documentation scaffolding: Creates docs/specs directories (product, tech stack, boundaries) and a ready-to-fill ADR log.
  • Guided setup workflow: Enforces a safe, configurable process that asks questions and records decisions while preserving team preferences.

Quick Start

Run the assistant command to create a new repository blueprint using /blueprint:setup-repo with your project details.

Frequently Asked Questions about blueprint:setup-repo

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

FAQPage Schema
How do I set up ADRs and specs in a new repository?▼

To set up ADRs and specs in a new repository, this Skill generates a spec-driven skeleton with architecture decision records, docs/specs directories, and patterns. It configures a guided workflow that asks project questions and records decisions.

What is a spec-driven repository structure?▼

A spec-driven repository structure is a project skeleton that includes architecture decision records, docs/specs directories for product and tech stack boundaries, and guardrails. It enforces a decision-focused blueprint to guide implementation.

Can I configure the ADR scaffolding to match my team's existing preferences?▼

Yes, the ADR scaffolding can be configured to match your team's existing preferences. The setup workflow enforces a guided, safe process that asks questions and records decisions while preserving team preferences and runtimes.

What's the best way to start a project with architecture decision records?▼

The best way to start a project with architecture decision records is to automate the creation of a spec-driven repository skeleton. This generates initial ADR logs, patterns, and documentation scaffolds for a stable foundation.

Does the generated repository blueprint include a testing setup?▼

Yes, the generated repository blueprint includes a minimal initial testing setup. Alongside ADRs and documentation scaffolds, it enforces boundaries and patterns to guide implementation with a stable foundation.

When should I use an ADR-driven workflow for my project?▼

You should use an ADR-driven workflow for new projects that require structured decision records, architecture decisions, and guardrails. It provides a consistent, decision-focused blueprint when starting a new software project.

Related Skills

Explore More Software Engineering Skills→
yankeeinlondonyankeeinlondon
3

schematic-define

Define and validate REST and WebSocket API contracts for client generation.

Community
Advanced
pradeepmoulipradeepmouli
2

speckit-plan

Convert feature specifications into structured plan.md technical designs.

Community
Advanced
cyberpunk042cyberpunk042

scaffold

Generates a starter repository from an architecture document with boilerplate, tests, git init, and commit.

Community
Advanced
kmylpenterkmylpenter

np

Initialize a new project directory with a standardized KFG structure and Git setup.

Community
Intermediate