How does it handle existing agent instruction files?

The skill includes a safety-first check for CLAUDE.md and AGENTS.md, specifically detecting symlinks to ensure it updates the correct target file without deleting existing configurations.

What files are included in the generated structure?

It creates a /docs folder containing specs (product, tech-stack, boundaries) and ADRs, a /patterns folder for code standards, a /tests folder, and agent instruction files.

Does this skill work with any tech stack?

Yes. While it has optimized defaults for Node.js, Bun, Python, and Go, it can be used to set up a spec-driven structure for any programming language or framework.

What is spec-driven development in this context?

Spec-driven development is an approach where technical specifications, product vision, and architectural decisions are documented in a structured format to guide both human developers and AI agents effectively.

Blueprint Project Architect

Name: Blueprint Project Architect
Author: rickardp

byrickardp

•

Productivity & Workflow

Automates the creation of new repositories using a spec-driven development structure including ADRs and agent instructions.

Blueprint Project Architect streamlines the initial phase of software development by establishing a standardized, documentation-first repository structure for AI-assisted coding. It automatically generates essential project files such as product specifications, Architectural Decision Records (ADRs), tech stack documentation, and agent-specific instructions (CLAUDE.md/AGENTS.md). By inferring tech stack defaults and enforcing testing patterns from the start, it ensures that projects are built on a solid foundation of well-defined requirements and clear architectural boundaries.

Key Features

01Automated repository scaffolding with spec-driven folder structures

02Standardized generation of Architectural Decision Records (ADRs) with rationale

03Built-in testing framework configuration and project boundaries setup

04Intelligent tech stack inference based on minimal user input (Node, Bun, Python, Go)

051 GitHub stars

06Smart management of CLAUDE.md and AGENTS.md with symlink awareness

Use Cases

01Standardizing documentation and testing patterns across team repositories

02Starting new microservices with pre-defined architectural standards and ADRs

03Bootstrapping greenfield projects with established AI-agent guardrails

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rickardp/blueprint-mode setup-repo

For use in Claude.ai and ChatGPT

Download Skill