-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the git-forest wiki! This comprehensive guide will help you understand, install, and effectively use git-forest to manage and improve your codebase systematically.
git-forest is a .NET-based CLI tool that helps development teams systematically transform fragmented Git work (branches, fixes, refactors) into durable, high-quality software by treating change as a living system.
Design Philosophy: Idempotent, deterministic, reconcile desired state, automation-friendly, clear ownership, safe concurrency.
- Installation - Install git-forest and get set up
- Quick Start Guide - Your first forest in 5 minutes
- Core Concepts - Understanding Plans, Plants, Planters, and Planners
- Working with Plans - Install, manage, and reconcile plans
- Managing Plants - Create, track, and complete work items
- Using Planters - Assign and execute work with planters
- Repository Overview for Team Leads - Comprehensive status reports
- Plans Catalog Overview - Browse all 54 pre-defined plans
- Engineering Excellence Plans - Code health and sustainability
- Quality & Reliability Plans - Testing and correctness
- Security & Compliance Plans - Security best practices
- Team & Process Plans - Developer experience
- More Plan Categories...
- GitHub Actions Integration - Automate forest workflows
- CI/CD Best Practices - Production-ready automation
- Exit Codes Reference - Stable exit codes for scripting
- Contributing Guide - How to contribute to git-forest
- Architecture Overview - System design and structure
- Building from Source - Development setup
- Extension Guide - Create custom planters and planners
- CLI Commands Reference - Complete command documentation
- Configuration Reference - All configuration options
- Plan Schema Reference - Creating custom plans
- Plant Lifecycle - Understanding plant status flow
- Common Issues - Solutions to frequent problems
- FAQ - Frequently asked questions
- Support Resources - Getting help
git-forest enables development teams to systematically transform fragmented Git work (branches, fixes, refactors) into durable, high-quality software by treating change as a living system.
It turns branches into plants, plans into growth rules, and AI agents (planners and planters) into long-term caretakers that continuously evolve, verify, and harden code until intent is fully realized and sustainably integrated.
Outcome: A self-tending codebase that preserves intent, reduces hidden technical debt, and compounds quality over time—shifting teams from "merge and forget" to cultivate and harvest.
# Initialize a forest in your git repository
git-forest init
# Install a plan to improve dependency health
git-forest plans install config/plans/engineering-excellence/dependency-hygiene.yaml
# Generate plants (work items) from the plan
git-forest plan dependency-hygiene reconcile
# List generated work items
git-forest plants list --plan dependency-hygiene
# Assign a planter to work on a specific plant
git-forest plant P01 assign dependency-cleaner
# Check status
git-forest status- Read Core Concepts to understand the forest metaphor
- Follow the Quick Start Guide to create your first forest
- Try the developer-experience plan walkthrough
- Start with Repository Overview Guide
- Explore the Plans Catalog to find relevant plans
- Learn about GitHub Actions Integration for automation
- Review Architecture Overview
- Read the Contributing Guide
- Check Building from Source to set up your environment
- GitHub Repository: tweakch/git-forest
- CLI Specification: CLI.md in repository
- Issue Tracker: GitHub Issues
- Versioning Policy: See repository for details
This wiki provides comprehensive documentation for git-forest. The CLI specification and technical reference remain version-controlled in the main repository, while this wiki focuses on guides, tutorials, and conceptual documentation.
Last Updated: Generated from git-forest repository
Contributing: To contribute to this wiki, submit pull requests to the git-forest repository with documentation updates, and they will be migrated here.
Ready to get started? Head to the Installation guide!