gh-venturo-id-venturo-claude-plugins-venturo-planner/commands/new-project.md

description

description
Initialize a new project with complete database design and API planning

New Project Creation

You will guide the user through creating a complete project plan with database design (ERD, DBML, PostgreSQL) and API contracts for all features.

Workflow

This command uses an incremental 5-phase workflow to create project documentation step-by-step.

Interactive Discovery

Ask the user these questions first:

1. Project name (e.g., "E-Commerce Platform", "Inventory Management System")
2. Project description (brief business purpose)
3. List of features/modules (e.g., user_management, product_catalog, order_management, inventory)
4. Authentication requirements (JWT, OAuth, session-based, etc.)
5. Common entities (users, roles, permissions, etc.)
6. Database type (PostgreSQL recommended)

Present a complete plan and ask for confirmation before proceeding.

Implementation Phases

After confirmation, execute these phases sequentially (read each phase file when needed):

1. Project Planning - phases/new-project/01-project-planning.md
2. ERD Generation - phases/new-project/02-project-erd.md
3. DBML Generation - phases/new-project/03-project-dbml.md
4. PostgreSQL Migrations - phases/new-project/04-project-migrations.md
5. API Contracts - phases/new-project/05-project-api-contract.md

After each phase:

• Stop and report what was created
• Ask user to review
• Wait for "continue" before next phase

Key Implementation Rules

Database Standards:

• Read DATABASE_STANDARDS.md before starting
• Enforce all audit standards
• UUID primary keys (VARCHAR 40)
• 6 audit trail columns required
• NO foreign key constraints
• Proper indexing

File Naming:

• ERD: docs/database/erd/project-overview.mmd
• DBML: docs/database/dbml/project-schema.dbml
• Migrations: docs/database/migrations/{timestamp}_initial_schema.sql
• API: docs/api/contracts/project-api.md

Example Usage

User: /venturo-planner:new-project

Claude: I'll help you create a new project plan with complete database design and API contracts.

        Let me ask some questions first:

        1. What is the name of your project?

User: E-Commerce Platform

Claude: 2. What is the business purpose of this project?

User: Online marketplace for selling products with inventory management

Claude: 3. What features/modules will this project have?
        (e.g., user_management, product_catalog, order_management)

User: user_management, product_catalog, order_management, inventory, payments

[Continues through all questions, presents plan, executes phases]

Output Files

• docs/database/erd/project-overview.mmd - Complete project ERD
• docs/database/dbml/project-schema.dbml - Complete DBML schema
• docs/database/migrations/{timestamp}_initial_schema.sql - PostgreSQL migration
• docs/api/contracts/project-api.md - Complete API contract
• Individual files per feature

Integration

After completion, the generated documentation can be used with:

• venturo-go - For backend implementation
• venturo-react - For frontend implementation (via OpenAPI from backend)