Queen Claude - Project Initialization

Initialize the Queen Claude autonomous development system in your project.

What is Queen Claude?

Queen Claude transforms your development workflow with autonomous AI agents that can work independently on tasks while you sleep. The system is built around the philosophy: "Human sets prompt → goes to bed → LLM handles everything"

Quick Start

# Install globally
npm install -g queen-claude-init

# Navigate to your project
cd my-project

# Initialize Queen Claude
queen init

Or run without installing:

npx queen-claude-init

What Gets Created

Directory Structure

your-project/
├── .queen/
│   ├── database.db          # SQLite database for all project data
│   ├── config.json          # Queen Claude configuration
│   ├── logs/                # System logs
│   ├── worktrees/           # Git worktrees for parallel development
│   └── backups/             # Database backups
└── (your existing project files)

Database Schema

The initialization creates a complete SQLite database with tables for:

• Projects: Project overview and tech stack information
• Tasks: Development tasks with requirements, expected results, and git worktree coordination
• Documentation: Critical project knowledge for AI agents
• Problems & Solutions: Issue tracking and resolution knowledge base
• Agent Sessions: Real-time coordination of multiple AI agents
• Memory: Important knowledge that agents must remember
• Project Context: Current project state and architectural decisions
• Activity Log: Historical record of all agent activities

Features

Autonomous Task Management

• Task Requirements: Define what needs to be built
• Expected Results: Specify validation criteria for autonomous completion
• File Associations: Tell agents exactly which files to work with
• Git Worktree Integration: Parallel development in isolated branches

AI Agent Coordination

• Multi-Agent Support: Multiple AI agents can work simultaneously
• Session Management: Track what each agent is working on
• Real-Time Status: Monitor progress across all active agents
• Conflict Prevention: Separate worktrees prevent code conflicts

Knowledge Management

• Memory System: Store critical patterns, decisions, and team preferences
• Documentation Database: Essential project knowledge for new agents
• Problem-Solution Database: Learn from past issues and solutions
• Context Awareness: Maintain project state and architectural decisions

Git Worktree Workflow

• Branch Management: Automatic numbered feature branches (001-feature-name)
• Isolated Development: Each feature developed in separate worktree
• Merge Coordination: Track branch lifecycle from development to merge
• Parallel Work: Multiple features developed simultaneously

Initialization Process

The queen init command will:

1. Gather Project Information

   • Project name and description
   • Main features and tech stack
   • Development preferences

2. Create Directory Structure

   • .queen/ directory with subdirectories
   • Git worktree management setup

3. Initialize Database

   • Create all necessary tables
   • Insert project metadata
   • Add essential documentation
   • Store critical memories

4. Generate Configuration

   • Agent settings and limits
   • Database configuration
   • Logging preferences
   • Git worktree settings

Configuration

The generated config.json includes:

{
  "project": {
    "name": "Your Project",
    "description": "Project description",
    "initialized": "2024-01-01T00:00:00.000Z"
  },
  "agents": {
    "max_concurrent": 3,
    "default_agent": "claude",
    "session_timeout": 3600000
  },
  "git": {
    "worktree_base": ".queen/worktrees",
    "branch_prefix": "",
    "auto_cleanup": true
  }
}

Next Steps

After initialization:

1. Create Tasks: Define development work for AI agents
2. Set Up Worktrees: Configure git worktrees for parallel development
3. Launch Agents: Start autonomous development sessions
4. Monitor Progress: Watch agents work through project dashboard

Requirements

• Node.js 18.0 or later
• Git repository (for worktree functionality)
• SQLite compatible environment

Philosophy

Queen Claude is designed for developers who want:

• Autonomous Development: AI agents that work independently
• Parallel Execution: Multiple features developed simultaneously
• Knowledge Continuity: Learning from past work and decisions
• Quality Assurance: Built-in validation and testing
• Minimal Supervision: Set tasks and let agents handle the details

Support

For issues, feature requests, or questions:

• GitHub Issues: queen-claude/initialize-queen
• Documentation: Queen Claude Docs

Ready to revolutionize your development workflow? Run queen init and let AI agents handle the heavy lifting while you focus on the big picture.