Skip to content
This repository was archived by the owner on Mar 4, 2026. It is now read-only.

BrownKit v0.1.0 - Initial Release

Choose a tag to compare

@jacopone jacopone released this 21 Oct 21:41
· 2 commits to main since this release

πŸŽ‰ BrownKit v0.1.0 - Initial Release

First production-ready release of BrownKit for transforming brownfield codebases into Speckit-ready projects.

✨ Features

Core Functionality

  • 9 CLI Commands: assess, structure, testing, quality, validate, graduate, resume, status, install-completion
  • 4 Language Plugins: Python, JavaScript, Rust, Go with extensible handler interface
  • 6-Phase Workflow: Assessment β†’ Structure β†’ Testing β†’ Quality β†’ Validation β†’ Graduation
  • 7 Readiness Gates: Comprehensive graduation criteria validation

Enhancement Features

  • Environment Variables: 7 configuration options for flexible deployment
  • Error Handling: 20+ custom exceptions with actionable suggestions
  • Performance: In-memory and disk caching with profiling
  • Shell Completion: bash, zsh, fish support

Test Infrastructure

  • Test Fixtures: 4 realistic brownfield projects
  • Contract Tests: 15+ plugin interface compliance tests
  • Integration Tests: 20+ end-to-end workflow tests
  • Test Runner: Multi-mode script with coverage reporting

πŸ“¦ Installation

pip install brownkit

πŸš€ Quick Start

# Assess your codebase
brownfield assess --quick

# Generate refactoring plan
brownfield structure

# Add tests and quality gates
brownfield testing
brownfield quality

# Validate and graduate
brownfield validate
brownfield graduate

πŸ“Š Statistics

  • 150 files
  • 26,257 lines of code
  • 54+ Python modules
  • 35+ test cases
  • 2,000+ lines of documentation

πŸ”— Documentation

πŸ™ Acknowledgments

Built with Claude Code


Full Changelog: See CHANGELOG.md