PM-OS Developer Toolkit

A self-contained developer toolkit for AI-assisted software development. Use it to develop PM-OS itself or extract it to any project for universal "vibe coding" capabilities.

What's Included

• Session Management - Persistent context across Claude Code sessions
• Confucius - Lightweight note-taking for decisions, assumptions, blockers
• Ralph - Multi-iteration feature development with acceptance criteria tracking
• Quint/FPF - Evidence-based reasoning with freshness tracking
• Preflight - Tool validation and discovery

Quick Start

Option 1: Use Within PM-OS

cd /path/to/pm-os/developer
source scripts/boot.sh

Option 2: Extract to Another Project

# From PM-OS developer directory
./scripts/extract.sh /path/to/your/project/.developer

# Or copy manually
cp -r /path/to/pm-os/developer /your/project/.developer
cd /your/project/.developer
./scripts/setup.sh
source scripts/boot.sh

Claude Code Commands

After booting, these commands are available:

Command	Description
/boot-dev	Initialize developer environment
/session-save	Save current session context
/session-load	Load previous session
/ralph-init	Start new feature with criteria
/ralph-status	Check feature progress
/preflight	Validate tool setup

Directory Structure

developer/
├── tools/           # Python tool modules
│   ├── core/        # Path resolution, config
│   ├── session/     # Session management
│   ├── ralph/       # Feature tracking
│   ├── quint/       # Reasoning tools
│   └── preflight/   # Validation
├── scripts/         # Bootstrap scripts
├── .claude/commands/# Agent commands
├── data/            # Runtime data (git-ignored)
└── docs/            # Documentation

Requirements

• Python 3.8+
• See requirements.txt for Python packages

Documentation

• Getting Started - Detailed setup guide
• Architecture - How tools work together
• Portability - Extracting to other projects
• Tool Reference - API documentation

Environment Variables

Variable	Description	Default
PM_OS_DEVELOPER_ROOT	Path to developer toolkit	Auto-detected
PM_OS_MODE	Operating mode	developer
GEMINI_API_KEY	For Orthogonal Challenge	Optional

License

Part of PM-OS. See main repository for license.