<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**

- [How-to Guides - Task-Oriented Solutions](#how-to-guides---task-oriented-solutions)
  - [Setup & Configuration](#setup--configuration)
  - [Ontology & Code Generation](#ontology--code-generation)
  - [Development & Troubleshooting](#development--troubleshooting)
  - [CI/CD & Deployment](#cicd--deployment)
  - [Marketplace](#marketplace)
  - [How to Use These Guides](#how-to-use-these-guides)
  - [Problem Not Listed?](#problem-not-listed)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

# How-to Guides - Task-Oriented Solutions

Practical guides for solving specific problems and completing common tasks. How-to guides are **problem-oriented, task-based** solutions that help you accomplish your goals.

## Setup & Configuration

Get ggen installed and configured:

- **[Installation](installation.md)** - Set up ggen on your system
- **[Configure Hooks](configure-hooks.md)** - Lifecycle hooks for automation
- **[Troubleshoot](troubleshoot.md)** - Common issues and solutions

## Ontology & Code Generation

Work with ontologies and generate code:

- **[Use RDF Ontologies](use-rdf-ontologies.md)** - Work with RDF/OWL domain models
- **[Create Templates](create-templates.md)** - Write custom code generation templates
- **[Custom SPARQL Queries](custom-sparql-queries.md)** - Query ontologies for analysis
- **[Multi-Language Generation](multi-language-generation.md)** - Generate across Rust, TypeScript, Python

## Development & Troubleshooting

Debug and optimize your workflow:

- **[Debug CLI Commands](debug-cli-commands.md)** - Troubleshoot CLI issues
- **[Performance Optimization](performance-optimization.md)** - Speed up generation
- **[Error Recovery](error-recovery.md)** - Handle failures gracefully
- **[Migrate Legacy Projects](migrate-legacy-projects.md)** - Incremental migration strategy

## CI/CD & Deployment

Automate and deploy:

- **[Deploy Production](deploy-production.md)** - Production deployment patterns
- **[Set Up Maturity Gates in CI/CD](maturity-cicd-gates.md)** - Quality automation
- **[Track Implementation Workflows](track-implementation-workflows.md)** - Process mining

## Marketplace

Work with the package ecosystem:

- **[Assess Package Maturity](assess-package-maturity.md)** - Evaluate package quality
- **[Get Package Recommendations](package-recommendations.md)** - Find packages for your needs
- **[Compare Packages](compare-packages.md)** - Compare available packages
- **[Advanced Marketplace Search](advanced-marketplace-search.md)** - Advanced search techniques

## How to Use These Guides

1. **Find your problem** in the list above
2. **Follow the step-by-step solution** - Each guide is focused on a specific task
3. **Try the examples** - Copy and adapt code snippets to your project
4. **Reference related guides** - Links help you explore related topics
5. **Check troubleshooting** - If stuck, see the troubleshooting section

## Problem Not Listed?

- 📚 **Tutorials** - [Learn the fundamentals](../tutorials/)
- 📖 **Reference** - [Look up specific commands](../reference/)
- 💡 **Explanations** - [Understand design decisions](../explanations/)
