Last Updated: September 19, 2025
Generate 22 enterprise-grade project documents using AI assistants. Works with Claude Code CLI and Cursor IDE with no dependencies or complex setup required.
For Claude Code users. Zero setup required.
- Open Claude Code and paste the contents of CLAUDE_ONE_PASTE.md
- Type
/new-project
and answer 3 questions - Documentation generates under
~/ai-dev/completed-docs/<project-name>/
Intelligent conversation-based documentation generator for Claude Code users.
- Copy the command file to your Claude commands directory:
cp ~/ai-dev/commands/new-project.md ~/.claude/commands/
- In any Claude Code conversation, type:
/new-project
- Answer 3 questions:
- Starting Point:
greenfield
(new project) orbrownfield
(existing project) - Audience:
startup
,business
, orenterprise
- Scope:
mvp
(4 docs),standard
(12 docs), orcomprehensive
(22 docs)
- Starting Point:
- Claude automatically generates the appropriate documentation set
- Files created in
completed-docs/<your-project-name>/
with index and metadata
- MVP (4 docs): PRD, Tasks, Project Brief, Brainstorming
- Standard (12 docs): Core product, technical, and UX documentation
- Comprehensive (22 docs): Complete enterprise documentation suite
For Cursor IDE users. Structured workflow integration.
- Copy
.cursorrules/new-project.mdc
to your project's.cursorrules/
directory - Use command:
@new-project "my-app" mvp
- Documentation generates under
completed-docs/
For organizations requiring structured intake and governance.
make enterprise PROJECT="my-project" # Interactive 17-question intake make enterprise-ci PROJECT="my-project" ANSWERS="..." # CI/automation with fixture data
β Enterprise Features:
- 17-question structured intake with multi-input modes (interactive, file, stdin)
- Automated header injection with project metadata and cross-references
- CI/CD integration via GitHub Actions workflow
- Governance controls with CODEOWNERS and PR templates
Traditional clone and configure approach.
git clone https://github.com/jeremylongshore/vibe-prd.git ~/ai-dev cd ~/ai-dev make verify # Confirms all 22 templates are ready
Create a new folder in completed-docs/ named after my project, then generate all 22 docs using the templates in professional-templates/. Ask me for a single free-form project summary (I can paste as much as I want). Use deductive reasoning to fill gaps. Output all final docs into completed-docs/<my-project>/ and include an index.md summarizing what was generated and any assumptions.
Use @.cursorrules/01-create-prd.mdc Here's my feature: [describe your feature]
Then follow the guided workflow in .cursorrules/
for structured documentation.
Feature | vibe-prd | Traditional Tools | Manual Documentation |
---|---|---|---|
Speed | 22 docs in minutes | Hours per document | Days/weeks |
AI Integration | Claude + Cursor native | Limited AI support | No AI assistance |
Enterprise Quality | Professional templates | Basic formats | Inconsistent quality |
Setup Complexity | Zero dependencies | Docker/complex setup | N/A |
Template Coverage | 22 comprehensive docs | 5-10 basic templates | Start from scratch |
Workflow Options | 4 methods (One-Paste, /new-project, Cursor, Enterprise) | 1-2 basic options | Start from scratch |
- PRD - Product Requirements Document
- Market Research - Competitive analysis & market sizing
- Competitor Analysis - SWOT analysis & positioning
- User Personas - Target audience profiling
- Project Brief - Executive summary & charter
- Architecture Decision Records (ADR) - Technical decisions & rationale
- System Architecture - Technical design & infrastructure
- Frontend Specification - UI/UX technical requirements
- Operational Readiness - Production deployment checklist
- User Stories - Feature requirements from user perspective
- User Journeys - End-to-end user experience mapping
- Acceptance Criteria - Definition of done for features
- Task Generation - Implementation breakdown
- Task Processing - Development workflow management
- Risk Register - Risk identification & mitigation
- Brainstorming - Ideation & concept development
- Metrics Dashboard - KPI tracking & analytics
- Test Plan - Comprehensive testing strategy
- QA Gates - Quality checkpoints & criteria
- Release Plan - Deployment strategy & rollout
- Post-Mortem - Issue analysis & lessons learned
- Usability Testing - User testing protocols & playbooks
- Startup Teams - Rapid documentation without sacrificing quality
- Enterprise Organizations - Standardize documentation across teams
- Solo Developers - Professional docs without enterprise overhead
- Product Managers - Comprehensive requirements gathering
- UX Teams - User research and journey documentation
- DevOps Teams - Operational readiness and deployment planning
~/ai-dev/ # π― Clean, organized AI development workspace βββ professional-templates/ # 22 master templates (read-only) β βββ 01_prd.md # Product Requirements Document β βββ 02_adr.md # Architecture Decision Record β βββ 03_generate_tasks.md # Task breakdown templates β βββ ... (19 more) # Complete enterprise suite βββ completed-docs/ # Generated project documentation β βββ <your-project>/ # Individual project folders β βββ index.md # Project summaries βββ docs/ # π Comprehensive documentation β βββ guides/ # User guides (Claude CLI, Cursor IDE, Quick Start) β βββ examples/ # Real-world examples and templates β βββ AI_ASSISTANT_PROMPTS.md # AI integration guidance β βββ SOP.md # Development standards βββ .cursorrules/ # Cursor IDE integration workflows βββ form-system/ # Interactive form interface βββ scripts/ # Automation scripts βββ archive/ # Legacy files (preserved for reference) βββ working-mds/ # Development reports & session logs
Asks targeted follow-up questions to extract information needed for comprehensive documentation.
All templates include {{DATE}}
placeholders for automatic timestamp insertion.
- Claude Code CLI: Free-form input with AI deductive reasoning
- Cursor IDE: Structured workflows with guided prompts
- No vendor lock-in
- Works with existing development workflows
- Scales from solo projects to enterprise teams
make verify # Verify all 22 templates exist make tree # Show complete repository structure ls -la professional-templates/ | wc -l # Should show 22 templates
# Input: "Building a customer support chatbot with Slack integration" # Output: 22 comprehensive documents including PRD, architecture, test plans, and deployment strategies
# Input: "iOS fitness tracking app with social features" # Output: Complete documentation suite from user personas to technical architecture
Contributions welcome:
- Report issues and bugs
- Suggest new template types
- Submit documentation improvements
- Propose feature enhancements
- Keep the 22 core templates canonical
- New template additions belong in separate folders
- Follow our documentation standards
- VS Code Extension - Native IDE integration
- Team Collaboration - Multi-user project documentation
- Custom Template Builder - Create your own template sets
- API Integration - Programmatic documentation generation
- More AI Providers - Gemini, GPT-4, and Anthropic Claude support
- Detailed Workflow: See
UNIFIED_AI_WORKFLOW.md
- Cursor Setup: See
.cursorrules/vibe-basics.md
- Template Reference: All 22 templates in
professional-templates/
- AI Integration: See
CLAUDE.md
for AI assistant guidance
Advisory-only workflows that do not block PRs:
- Runs: Weekly (Mondays 05:00 UTC) or manually via "Run workflow"
- Purpose: Checks for accessibility issues and markdown link validation
- Note: Safe fallback to basic link checking if pa11y tools not configured
- Runs: Weekly (Mondays 04:00 UTC) or manually via "Run workflow"
- Purpose: Lighthouse CI performance analysis of public site
- Usage: Provide
site_url
input when running manually, or configureSITE_URL
repo variable/secret - Note: Skips gracefully if no URL provided
Both audits upload artifacts when available and never gate merges.
π’ Enterprise Pipeline Protection:
- Enterprise-critical paths require @jeremylongshore review via CODEOWNERS
- All changes must pass Enterprise E2E workflow before merge
- Branch protection enforces linear history and conversation resolution
- See Branch Protection Guide for complete governance details
π Protected Paths:
/.github/workflows/enterprise-e2e.yml /scripts/run-enterprise.mjs /scripts/generate-enterprise.mjs /form-system/enterprise-cli.js /form-system/enterprise-questions.yaml /completed-docs/
- Stuology β Core Contributor β‘
Contributions of any size are welcome! See CONTRIBUTING.md for details.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: jeremy@intentionsolutions.com
- 22 professional templates covering product strategy through deployment
- Multiple workflows - Claude One-Paste, manual setup, or Cursor IDE integration
- Zero dependencies - no Docker, complex installs, or vendor lock-in
- Proven patterns - enterprise-grade documentation structure
- AI-assisted - intelligent questioning flows and template population
- Templates: Add or adjust in
professional-templates/
(keep originals canonical; add variants under a new folder). - Claude Command: Edit
commands/new-project.md
for new intake logic or tiers. - Cursor: Explore
.cursorrules/
to guide IDE-first users. - Form System: Change questions in
form-system/questions.yaml
to fit your org.
PRs welcome. Keep changes scoped and tested. See CONTRIBUTING.md.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: jeremy@intentionsolutions.com