Project Blueprint

Generate production-ready project configurations by orchestrating Vibery ecosystem components.

Purpose

Instead of manually researching which agents, skills, MCPs, and commands to install, this skill analyzes project requirements and outputs a complete setup recipe.

Available Components

Vibery Ecosystem (auto-updated)

RUN: npx vibery list
TO: Get current available templates

Categories:
- 🤖 Agents: Tech-specific experts (nextjs-developer, stripe-pro, etc.)
- ⚡ Commands: One-shot tasks (create-pr, generate-tests, etc.)
- 🔌 MCPs: External integrations (supabase, github, shopify, etc.)
- 🪝 Hooks: Automation triggers (auto-commit, lint-on-save, etc.)
- ⚙️ Settings: Permission presets (allow-npm, deny-sensitive-files, etc.)
- 🎨 Skills: Complex workflows (frontend-design, mcp-builder, etc.)

---

Process

Phase 1: Project Classification

Entry Check

IF user provided: project type + tech stack + scale
    → Proceed to Phase 2
ELSE
    → Classify project first

Classification Questions

Project Type → Base Blueprint Mapping

SaaS MVP:
    → nextjs-developer + supabase + stripe-pro
    → Commands: create-pr, generate-tests, security-audit
    → Skills: frontend-design, backend-development

E-commerce:
    → nextjs-developer + shopify OR woocommerce
    → Commands: performance-audit, security-audit
    → Skills: frontend-design

API Service:
    → backend-architect + swagger + postgres-pro
    → Commands: generate-api-documentation, security-audit
    → MCPs: postgresql, redis

CLI Tool:
    → cli-developer + typescript-pro
    → Commands: generate-tests, prepare-release
    → Hooks: conventional-commits

Landing Page:
    → frontend-design + tailwind-pro
    → Commands: performance-audit
    → Hooks: format-on-save

Chrome Extension:
    → typescript-pro + chrome-devtools
    → Skills: frontend-design

MCP Server:
    → mcp-builder + typescript-pro
    → Commands: generate-tests
    → Skills: mcp-management

---

Phase 2: Stack Analysis

Entry Check

IF project classified:
    → Analyze tech stack requirements
ELSE
    → Return to Phase 1

Stack Detection

IF existing project:
    → Read package.json, requirements.txt, go.mod, Cargo.toml
    → Identify: framework, language, dependencies
    → Suggest components matching existing stack

IF new project:
    → Use classification from Phase 1
    → Recommend optimal stack for project type

Component Selection Rules

FOR each technology in stack:
    → Search: npx vibery search [technology]
    → Select: Most specific agent/skill available
    → Avoid: Generic alternatives if specific exists

Example:
    Next.js project → nextjs-developer (not react-specialist)
    Supabase auth → supabase MCP (not generic postgres)

---

Phase 3: Blueprint Generation

Entry Check

IF stack analyzed + components selected:
    → Generate blueprint
ELSE
    → Return to Phase 2

Blueprint Structure

# Project Blueprint: [Project Name]

## Quick Start
```bash
# 1. Install Vibery templates
npx vibery install [agent-1]
npx vibery install [agent-2]
npx vibery install [mcp-1]
npx vibery install [command-1]
npx vibery install [hook-1]

# 2. Configure MCP servers (if any)
# [MCP-specific setup commands]

# 3. Verify installation
npx vibery list --installed

Components Installed

Agents

MCPs

Commands

Hooks

CLAUDE.md

[Generate project-specific CLAUDE.md - see Phase 4]

Folder Structure

[Generate recommended structure - see Phase 4]

Workflows

[Generate common workflows - see Phase 4]

---

### Phase 4: Configuration Generation

#### CLAUDE.md Generation

BASED ON project type + stack: → Generate CLAUDE.md with:

# Project Context
- Tech stack summary
- Architecture overview
- Key directories

# Conventions
- Coding standards for this stack
- Naming conventions
- File organization rules

# Commands
- Dev, test, build, deploy commands

# Agent Instructions

...