Cookbook

Practical recipes for common HtmlGraph tasks. Copy, paste, and adapt these patterns to your needs.

Quick Navigation

Project Setup

• Initialize a New Project
• Install Git Hooks for Auto-Tracking
• Configure Agent Identity

Features & Tasks

• Create a Simple Feature
• Add Dependencies Between Features
• Mark Steps Complete Incrementally
• Query Features by Status/Priority

Tracks & Planning

• Create a Track with Spec and Plan
• Link Features to a Track
• Track Progress Across Multiple Features

Sessions & Activity

• Start a Work Session
• Query Session Events
• Generate Session Reports

Strategic Planning

• Find Bottlenecks
• Get Work Recommendations
• Identify Parallel Work
• Assess Project Risks

Integration

• Set Up CI/CD Automation
• Sync with External Tools
• Export to Other Formats

Troubleshooting

• Fix SQLite Index Corruption
• Resolve Drift Warnings
• Debug Missing Attribution

Recipe Format

Each recipe follows this structure:

1. Problem: What you're trying to accomplish
2. Solution: Complete, copy-paste ready code
3. Explanation: How it works
4. Variations: Alternative approaches or extensions

Contributing Recipes

Found a useful pattern? Submit a recipe!

1. Fork the repo
2. Add your recipe to the appropriate file
3. Follow the recipe format above
4. Submit a pull request

See Contributing Guide for details.