npm package: @kenkaiiii/queen-init
Description: Initialize Queen Claude autonomous development system with Queen Styles design system enforcement
Author: kenkaiiii
Latest version: 3.5.0

# 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

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

# Navigate to your project
cd my-project

# Initialize Queen Claude
queen init
```

Or run without installing:
```bash
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:

```json
{
  "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](https://github.com/queen-claude/initialize-queen/issues)
- Documentation: [Queen Claude Docs](https://docs.queen-claude.com)

---

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