Intent Blueprint Docs

Enterprise-grade AI documentation generator

Transform project ideas into 22 professional documents in minutes. Works with Claude, Cursor, VS Code, and any MCP-compatible tool.

Beta Notice: This project is in active development. Core features are functional but APIs may change. We welcome feedback and contributions.

What It Does

You describe your project. Blueprint generates up to 22 professional documents covering product strategy, technical architecture, user experience, development workflow, and quality assurance.

Key differentiators:

• MCP-native - First-class integration with Claude, Cursor, and any MCP-compatible AI tool
• Scope tiers - Generate 4 docs (MVP), 12 (Standard), or all 22 (Comprehensive)
• Enterprise pipeline - Structured 17-question intake with governance controls
• Extensible - Plugin system for custom formatters, validators, and integrations

Installation

# Install CLI globally
npm install -g @intentsolutions/blueprint

# Or use directly with npx
npx @intentsolutions/blueprint init

Requirements: Node.js 18+

Quick Start

CLI Usage

# Interactive project setup
blueprint init

# Generate with options
blueprint generate -n "My Project" -d "A cool app" -s standard -a business

# AI-guided interview mode
blueprint interview

# List available templates
blueprint list

MCP Server (Claude / Cursor)

Add to your Claude or Cursor MCP config:

{
  "mcpServers": {
    "blueprint": {
      "command": "npx",
      "args": ["@intentsolutions/blueprint-mcp"]
    }
  }
}

Available MCP Tools:

Tool	Description
blueprint_generate	Generate docs from project description
blueprint_interview	Start AI-guided intake session
blueprint_list_templates	Show available templates
blueprint_customize	Customize a single template
blueprint_export	Export to GitHub / Linear / Jira / Notion

IDE Integration

Works with any IDE that supports MCP:

• Claude Code - Native via MCP config
• Cursor - MCP server auto-discovery
• VS Code - Via MCP extension
• Google Antigravity - Gemini agent integration
• Amp (Sourcegraph) - VS Code extension compatible

Documentation Scopes

Scope	Documents	Best For
MVP	4 docs	Quick starts, prototypes
Standard	12 docs	Most projects
Comprehensive	22 docs	Enterprise, compliance

Template Categories

Category	Count	Includes
Product & Strategy	5	PRD, Market Research, Competitor Analysis, User Personas, Project Brief
Technical Architecture	4	ADRs, System Architecture, Frontend Spec, Operational Readiness
User Experience	3	User Stories, User Journeys, Acceptance Criteria
Development Workflow	5	Task Generation, Task Processing, Risk Register, Brainstorming, Metrics
Quality Assurance	5	Test Plan, QA Gates, Release Plan, Post-Mortem, Usability Testing

Template Marketplace

Install curated template packs for your industry or framework:

# Search and install packs
blueprint pack search fintech
blueprint pack install blueprint-fintech
blueprint pack list

Category	Packs	Description
Verticals	fintech, healthtech, saas	Industry-specific templates
Compliance	soc2, hipaa, gdpr	Regulatory documentation
Frameworks	nextjs, fastapi, rails	Framework-optimized templates

Packages

Package	Description	npm
@intentsolutions/blueprint	CLI tool
@intentsolutions/blueprint-mcp	MCP server
@intentsolutions/blueprint-core	Core engine

Plugin System

Extend Blueprint with custom plugins:

import { createPluginManager } from '@intentsolutions/blueprint';

const manager = createPluginManager();

manager.register({
  name: 'my-formatter',
  version: '1.0.0',
  type: 'formatter',
  format: async (content, options) => {
    return { content: transformedContent, format: 'custom' };
  }
});

Plugin Types: Formatter, Validator, Processor, Integration, Hook

See Plugin Development Guide for details.

Programmatic Usage

import {
  generateAllDocuments,
  writeDocuments,
  listTemplates
} from '@intentsolutions/blueprint-core';

const docs = generateAllDocuments({
  projectName: 'My Project',
  projectDescription: 'A revolutionary app',
  scope: 'standard',
  audience: 'business'
});

writeDocuments(docs, './docs/my-project');

Status

Current Version: 2.0.0 (Beta)

Feature	Status
22 Professional Templates	Stable
CLI Tool	Stable
MCP Server	Stable
Core Engine	Stable
Enterprise Pipeline	Stable
Template Marketplace	Beta
Plugin System	Beta
Export Integrations	Beta
Analytics Dashboard	Beta
Web UI	Planned
Team Collaboration	Planned

Development

# Clone and setup
git clone https://github.com/intent-solutions-io/intent-blueprint-docs.git
cd intent-blueprint-docs
npm install
npm run build

# Development mode
npm run dev

# Run tests
npm run test

# Lint
npm run lint

# Verify templates
make verify

Documentation

All project documentation lives in 000-docs/ using the doc-filing system:

Doc	Title
000	Standards Catalog
001	Product Vision & Roadmap
002	System Architecture
003	Template Specification
004	MCP Server Integration
005	Contributing Guide
006	Security Policy
007	Release & Publishing
008	Plugin Development
009	Testing & QA

Contributing

Contributions welcome! See the Contributing Guide.

License

Apache 2.0 - See LICENSE

---

By Intent Solutions