Skip to content

/orchestre:create (MCP) ​

Initialize a new Orchestre project with intelligent template selection and complete development environment setup.

Note: For existing projects, use /orchestre:initialize (MCP) instead.

Overview ​

  • Purpose: Smart project initialization
  • Category: Core Orchestration
  • Type: Dynamic prompt
  • MCP Tool: initialize_project

Syntax ​

bash
/orchestre:create (MCP) [template] [project-name] [path]
/orchestre:create (MCP) [repository-url] [project-name] [path]
/orchestre:create (MCP) . [template]  # Initialize in current directory

Parameters ​

ParameterRequiredDescriptionOptions
templateYes*Template to usemakerkit, cloudflare, react-native
repository-urlYes*Git repository URLAny valid Git URL
project-nameYes**Name of the projectAlphanumeric + hyphens or . for current dir
pathNoTarget directoryRelative or absolute path

*Either template or repository-url is required **Use . as project-name to initialize in current directory

Usage Examples ​

Basic Project Creation ​

bash
# Create a SaaS application
/orchestre:create (MCP) makerkit my-saas-app

# Create an edge API
/orchestre:create (MCP) cloudflare edge-api

# Create a mobile app
/orchestre:create (MCP) react-native mobile-app

Custom Repository ​

bash
# Clone from a custom repository
/orchestre:create (MCP) https://github.com/makerkit/next-supabase-saas-kit-turbo my-saas

# Clone from private repository (requires Git authentication)
/orchestre:create (MCP) https://github.com/your-org/private-template my-project

Current Directory ​

bash
# Initialize template in current directory
/orchestre:create (MCP) . makerkit

# Initialize from custom repo in current directory
/orchestre:create (MCP) . https://github.com/user/template

What Happens ​

When you run /orchestre:create (MCP), the command:

  1. Validates Input - Checks project name and template
  2. Creates Structure - Sets up directory hierarchy
  3. Installs Template - Copies template files
  4. Configures Project - Sets up configuration
  5. Installs Commands - Adds template-specific commands
  6. Creates Documentation - Initial CLAUDE.md files

Template Selection ​

MakerKit (SaaS) ​

Best for:

  • Multi-tenant SaaS applications
  • Subscription-based products
  • Team collaboration tools
  • B2B platforms

Includes:

  • Authentication system
  • Billing integration
  • Team management
  • Admin dashboard

Cloudflare (Edge) ​

Best for:

  • High-performance APIs
  • Globally distributed apps
  • Serverless functions
  • Real-time applications

Includes:

  • Workers setup
  • KV storage
  • Durable Objects
  • R2 configuration

React Native (Mobile) ​

Best for:

  • Cross-platform mobile apps
  • Native mobile experiences
  • Offline-first applications
  • Mobile companions to web apps

Includes:

  • Expo configuration
  • Navigation setup
  • Native modules
  • Push notifications

Command Behavior ​

Discovery Phase ​

The command first explores:

  • Current directory structure
  • Existing projects
  • Available templates
  • System requirements

Execution Phase ​

typescript
// Internal flow
1. Call initialize_project tool
2. Create project structure
3. Copy template files
4. Install dependencies
5. Set up git repository
6. Create initial documentation

Output ​

🎭 Creating new Orchestre project...
📋 Template: makerkit
📁 Location: ./my-saas-app
✅ Project structure created
📚 Template files copied
🔧 Configuration complete
📖 Commands installed: 15
🎯 Knowledge pack ready

Next steps:
1. cd ./my-saas-app
2. Review CLAUDE.md for project context
3. Create requirements.md with your specifications
4. Run: /orchestrate requirements.md

Post-Creation ​

Immediate Next Steps ​

  1. Navigate to Project

    bash
    cd ./my-saas-app
  2. Review Documentation

    • Read CLAUDE.md for template overview
    • Check .orchestre/prompts.json for available prompts
  3. Define Requirements

    • Create requirements.md
    • Describe your specific needs
  4. Start Development

    bash
    /orchestrate requirements.md

Project Structure ​

After creation:

my-saas-app/
├── .orchestre/
│   ├── prompts.json      # Available prompts
│   ├── CLAUDE.md         # Orchestration memory
│   ├── patterns/         # Code patterns
│   └── memory-templates/ # Documentation templates
├── src/                  # Source code
├── tests/               # Test files
├── docs/                # Documentation
├── CLAUDE.md            # Project context
├── package.json         # Dependencies
└── README.md           # Human documentation

Best Practices ​

1. Choose Descriptive Names ​

bash
# Good names
/create makerkit customer-portal
/create cloudflare analytics-api
/create react-native fitness-tracker

# Poor names
/create makerkit app
/create cloudflare api
/create react-native myapp

2. Understand the Template ​

Before creating:

  • Review template features
  • Check included packages
  • Understand conventions
  • Consider requirements fit

3. One Project at a Time ​

Create and set up one project before starting another:

bash
/create makerkit project-1
cd project-1
# Set up and verify
cd ..
/create cloudflare project-2

Error Handling ​

Common Errors ​

ErrorCauseSolution
Invalid project nameSpecial charactersUse only letters, numbers, hyphens
Template not foundTypo in templateCheck available templates
Directory existsName conflictChoose different name
Permission deniedNo write accessCheck directory permissions

Recovery ​

If creation fails:

  1. Check error message
  2. Fix the issue
  3. Delete partial creation
  4. Run command again

Advanced Usage ​

Custom Target Directory ​

bash
# Specify location (coming soon)
/create makerkit my-app --target ./projects/saas/my-app

Template Inspection ​

Before creating, explore templates:

bash
# View available templates
/status templates

# Research template features
/research "MakerKit Next.js features"

Batch Setup ​

For multiple related projects:

bash
# Create workspace
mkdir my-workspace && cd my-workspace

# Create projects
/create cloudflare api-gateway
/create makerkit admin-portal
/create react-native mobile-client

Integration with Other Commands ​

Typical Workflow ​

Command Chaining ​

bash
# Initialize and plan
/create makerkit my-app && cd my-app && /orchestrate "E-commerce platform with subscriptions"

# Quick start
/create cloudflare api && /execute-task "Create health check endpoint"

Prompt Adaptation ​

This prompt dynamically adapts based on:

Context Discovery ​

  • Current Directory: Checks if already in a project
  • Available Templates: Discovers installed templates
  • Git Status: Understands repository state
  • System Capabilities: Adapts to OS and tools available

Intelligence Patterns ​

  • Detects existing projects to prevent conflicts
  • Suggests appropriate templates based on description
  • Adapts initialization for monorepo vs standalone
  • Configures based on detected development environment
  • Learns from previous project setups

Template Intelligence ​

  • Each template brings its own command set
  • Commands are discovered, not hardcoded
  • Adapts to template-specific conventions
  • Evolves as templates are updated

Memory Integration ​

This prompt actively uses and updates distributed memory:

Creates ​

  • CLAUDE.md - Root project context
  • .orchestre/CLAUDE.md - Orchestration memory
  • .orchestre/prompts.json - Available prompts configuration
  • .orchestre/templates/ - Memory templates
  • docs/[feature]/CLAUDE.md - Feature contexts

Initializes ​

  • Project philosophy and principles
  • Technical stack decisions
  • Development conventions
  • Team structure (if specified)

Memory Templates ​

  • Each template includes memory structures
  • Pre-configured for common patterns
  • Extensible for project specifics
  • Git-tracked for team sharing

Template Commands ​

Each template adds specialized prompts:

MakerKit Commands ​

  • /add-feature - Add new features
  • /setup-stripe - Configure payments
  • /add-team-feature - Multi-tenancy
  • See all 22 commands →

Cloudflare Commands ​

  • /add-worker-cron - Scheduled jobs
  • /add-r2-storage - Object storage
  • /implement-queue - Message queuing
  • See all 10 commands →

React Native Commands ​

  • /add-screen - New screens
  • /add-offline-sync - Offline capability
  • /setup-push-notifications - Push setup
  • See all 9 commands →

Direct Invocation ​

This is a dynamic prompt that Claude executes directly:

bash
# Simply type the command
/create makerkit my-saas

# Claude will:
# 1. Call the initialize_project MCP tool
# 2. Create complete project structure
# 3. Install template-specific prompts
# 4. Initialize distributed memory
# 5. Set up development environment

Tips and Tricks ​

Quick Validation ​

Validate project name before creation:

javascript
// Valid: letters, numbers, hyphens
const valid = /^[a-z0-9-]+$/.test(projectName);

Template Comparison ​

Not sure which template?

bash
/research "Compare MakerKit vs Cloudflare for SaaS development"

Clean Restart ​

If you need to start over:

bash
rm -rf ./my-app
/create makerkit my-app

Built with ❤️ for the AI Coding community, by Praney Behl