Solokit Roadmap

January 14, 2026 · View on GitHub

Current Release: v0.3.0 Status: Production-ready, feature-complete framework

What is Solokit?

Solokit is a complete development framework for solo developers building production software with AI assistants like Claude Code. It combines production-ready project templates, automated quality gates, intelligent session management, and AI-powered knowledge capture into a cohesive workflow.

Current Capabilities

Core Features (Available Today)

Session Management

  • Complete session lifecycle with AI-powered briefings
  • Quality gates enforcement (tests, linting, security, coverage)
  • Automatic context loading and state management
  • Git workflow automation (branching, commits, PR creation)

Work Item System

  • 6 comprehensive work item types (feature, bug, refactor, security, integration_test, deployment)
  • Dependency resolution with critical path analysis
  • Milestone tracking and progress visualization
  • Spec-first architecture with validation
  • Dependency graph visualization (ASCII, DOT, SVG)

Knowledge Management

  • Automatic learning extraction and categorization (6 categories)
  • Duplicate detection and intelligent merging
  • Full-text search and filtering capabilities
  • Growing knowledge base across sessions

Quality Automation

  • Multi-language support (Python, JavaScript, TypeScript)
  • Test execution with coverage tracking
  • Security scanning (bandit, safety, npm audit)
  • Code quality checks (linting, formatting)
  • Documentation validation
  • Integration testing with Docker orchestration
  • Performance benchmarks and API contract validation
  • Deployment automation with rollback support

Project Templates

  • 4 production-ready stacks: T3 Stack, FastAPI, Refine, Next.js
  • 4 quality tiers: Essential, Standard, Comprehensive, Production-Ready
  • 16 total configurations with battle-tested tooling
  • Complete CI/CD, Docker, environment configs per tier

Developer Experience

  • Clean CLI with sk command
  • 15+ slash commands for Claude Code (/sk:*)
  • Comprehensive documentation and guides
  • Template-driven workflow
  • Interactive UI integration with Claude Code

Test Coverage & Quality

  • 3,802 tests across unit, integration, and end-to-end (97% coverage)
  • 100% pass rate maintained
  • Zero linting/type errors (ruff, mypy)
  • 8 CI/CD workflows ensuring quality
  • Battle-tested on real development projects

Installation

PyPI:

# macOS/Linux
pip3 install solokit

# Windows
py -m pip install solokit

First-time macOS users: When you run pip3 for the first time, macOS will prompt you to install Command Line Tools. This is normal and required - the installation takes 5-10 minutes.

From Source:

git clone https://github.com/ankushdixit/solokit.git
cd solokit

# macOS/Linux
pip3 install -e .

# Windows
py -m pip install -e .

Verify Installation:

sk status

See the README for troubleshooting common installation issues.

Near-Term Roadmap

Public Distribution (In Progress)

Goal: Make Solokit publicly available via PyPI

Tasks:

  • Complete rebrand from session-driven-development to solokit
  • Rename package, CLI commands, and all references
  • Update all documentation and README
  • Achieve 100% test pass rate (3,802 tests, 97% coverage)
  • Publish to PyPI as solokit
  • Update marketplace plugin (lightweight commands only)
  • Create comprehensive video tutorials
  • Write getting started guide

Benefits:

  • ✅ Simple installation: pip install solokit
  • ✅ Automatic updates via pip install --upgrade solokit
  • ✅ Wider adoption and discoverability
  • ✅ Professional distribution channel

Future Enhancements

These features may be added based on community feedback and real-world usage:

Template Expansion

  • Additional stack templates (Ruby on Rails, Django, Laravel, etc.)
  • Mobile app templates (React Native, Flutter)
  • Data science/ML templates
  • Serverless templates (AWS Lambda, Vercel Functions)
  • Community-contributed templates

Metrics & Analytics

  • Session velocity tracking
  • Work item completion trends
  • Learning accumulation insights
  • Quality gate statistics
  • Coverage trends over time
  • Time estimation vs. actual analysis

AI-Powered Enhancements

  • Context-aware session suggestions
  • Automatic priority recommendations
  • Smart dependency detection
  • Work item decomposition assistance
  • Time estimation from historical data
  • Spec quality analysis

Custom Work Item Types

  • User-defined work item schemas
  • Custom validation rules per type
  • Type-specific quality gates
  • Template system for custom specs

Enhanced Documentation

  • ADR (Architecture Decision Records) templates
  • Requirement → work item traceability
  • Auto-generated documentation from specs
  • Version tracking and change detection

Project Presets

  • Quick setup for common project types
  • Auto-configured quality gates by domain
  • Stack-specific best practices
  • Pre-configured CI/CD templates

Intentionally Excluded

The following features are not planned as they conflict with Solokit's core philosophy:

❌ Team Collaboration Features

  • Solokit focuses on solo development workflow
  • Multi-developer support adds complexity without benefit
  • Git provides sufficient collaboration when needed

❌ External Tool Deep Integrations

  • Notion, Linear, Jira, Slack integrations
  • Git-based workflow is sufficient
  • Avoids vendor lock-in and maintenance burden

❌ Web-Based Dashboard

  • Terminal-based workflow is core philosophy
  • CLI provides sufficient visibility
  • Keep it simple and fast

❌ Enterprise Features

  • SSO, audit logs, compliance reporting, RBAC
  • Out of scope for developer productivity tool
  • Focus remains on individual developers

❌ Spec-Kit Integration

  • Current spec system is comprehensive and battle-tested
  • Integration adds complexity without clear benefit
  • Our templates and validation work well

Success Metrics

v0.1.0 Release Metrics ✅

  • ✅ 3,710 tests passing (100% pass rate, 97% coverage)
  • ✅ Zero linting/type errors
  • ✅ Complete rebrand to Solokit
  • ✅ 4 production stacks × 4 quality tiers = 16 configurations
  • ✅ 6 work item types with comprehensive specs
  • ✅ Full session lifecycle with quality automation
  • ✅ Learning system with 6 categories
  • ✅ Used successfully on multiple real projects

Future Goals

Short-term:

  • 1,000+ PyPI downloads in first month
  • 100+ GitHub stars
  • 10+ community-contributed templates
  • 5+ video tutorials published

Long-term:

  • 10,000+ PyPI downloads
  • Active community contributions
  • Featured in developer productivity tools lists
  • Case studies from solo developers

Contributing

See CONTRIBUTING.md for development setup and contribution guidelines.

For bugs and enhancements, see:

Ways to Contribute:

  • Report bugs and suggest features
  • Submit stack templates for new technologies
  • Write guides and tutorials
  • Improve documentation
  • Share your Solokit workflow and learnings

Philosophy

Solokit is built on these principles:

  1. Spec-First: Write specifications before code
  2. Quality-First: Automate quality checks, don't skip them
  3. Context-First: AI briefings provide full project context
  4. Learning-First: Capture insights automatically
  5. Template-First: Start with production-ready foundations
  6. Solo-First: Optimized for individual developers, not teams

We believe solo developers can achieve team-level sophistication with the right tools and workflows.

Last Updated: 2025-11-10