# Claude-Craft User Guides

Complete documentation for using Claude-Craft, from project creation to feature development and bug fixing.

---

## Select Your Language

| Language | Guides |
|----------|--------|
| **English** | [Getting Started](en/01-getting-started.md) \| [Project Creation](en/02-project-creation.md) \| [Feature Development](en/03-feature-development.md) \| [Bug Fixing](en/04-bug-fixing.md) \| [Tools](en/05-tools-reference.md) \| [Troubleshooting](en/06-troubleshooting.md) \| [Backlog](en/07-backlog-management.md) \| [New Project](en/08-setup-new-project.md) \| [Existing Project](en/09-setup-existing-project.md) |
| **Fran&ccedil;ais** | [D&eacute;marrage](fr/01-getting-started.md) \| [Cr&eacute;ation Projet](fr/02-project-creation.md) \| [D&eacute;veloppement](fr/03-feature-development.md) \| [Correction Bugs](fr/04-bug-fixing.md) \| [Outils](fr/05-tools-reference.md) \| [D&eacute;pannage](fr/06-troubleshooting.md) \| [Backlog](fr/07-backlog-management.md) \| [Nouveau Projet](fr/08-setup-new-project.md) \| [Projet Existant](fr/09-setup-existing-project.md) |
| **Espa&ntilde;ol** | [Inicio](es/01-getting-started.md) \| [Creaci&oacute;n Proyecto](es/02-project-creation.md) \| [Desarrollo](es/03-feature-development.md) \| [Correcci&oacute;n Bugs](es/04-bug-fixing.md) \| [Herramientas](es/05-tools-reference.md) \| [Soluci&oacute;n](es/06-troubleshooting.md) \| [Backlog](es/07-backlog-management.md) \| [Proyecto Nuevo](es/08-setup-new-project.md) \| [Proyecto Existente](es/09-setup-existing-project.md) |
| **Deutsch** | [Erste Schritte](de/01-getting-started.md) \| [Projekterstellung](de/02-project-creation.md) \| [Entwicklung](de/03-feature-development.md) \| [Fehlerbehebung](de/04-bug-fixing.md) \| [Werkzeuge](de/05-tools-reference.md) \| [Probleml&ouml;sung](de/06-troubleshooting.md) \| [Backlog](de/07-backlog-management.md) \| [Neues Projekt](de/08-setup-new-project.md) \| [Bestehendes Projekt](de/09-setup-existing-project.md) |
| **Portugu&ecirc;s** | [Introdu&ccedil;&atilde;o](pt/01-getting-started.md) \| [Cria&ccedil;&atilde;o Projeto](pt/02-project-creation.md) \| [Desenvolvimento](pt/03-feature-development.md) \| [Corre&ccedil;&atilde;o Bugs](pt/04-bug-fixing.md) \| [Ferramentas](pt/05-tools-reference.md) \| [Resolu&ccedil;&atilde;o](pt/06-troubleshooting.md) \| [Backlog](pt/07-backlog-management.md) \| [Novo Projeto](pt/08-setup-new-project.md) \| [Projeto Existente](pt/09-setup-existing-project.md) |

---

## Guide Overview

### 1. Getting Started
Quick overview of Claude-Craft, prerequisites, and your first project in 5 minutes.

### 2. Project Creation
Complete workflow for setting up a new project: technology selection, installation methods (Makefile, YAML), and post-installation configuration.

### 3. Feature Development
TDD workflow, using agents and slash commands, code generation templates, and quality checklists.

### 4. Bug Fixing
Diagnostic workflow, writing regression tests, hotfix procedures, and validation checklists.

### 5. Tools Reference
Detailed guide for MultiAccount Manager, StatusLine, and ProjectConfig Manager utilities.

### 6. Troubleshooting
Common issues and solutions for installation, agents, commands, and configuration.

### 7. Backlog Management
Complete SCRUM backlog workflow: generating backlog from specs, managing EPICs/User Stories/Tasks, and 15 project management commands.

### 8. Setup New Project
Step-by-step tutorial for installing Claude-Craft on a brand new project. Covers prerequisites, both installation methods (NPX and Makefile), verification, configuration, and first launch.

### 9. Setup Existing Project
Comprehensive guide for adding Claude-Craft to a project with existing code. Includes backup procedures, conflict resolution, codebase exploration, first AI-assisted modification, and team onboarding.

---

## Quick Links

- [Main README](../../README.md) - Project overview
- [Installation Guide](../INSTALLATION.md) - Detailed installation
- [Configuration Guide](../CONFIGURATION.md) - YAML configuration
- [Agents Reference](../AGENTS.md) - All 23 AI agents
- [Commands Reference](../COMMANDS.md) - 74+ slash commands
- [Technologies Guide](../TECHNOLOGIES.md) - Stack-specific guides

---

## Contributing

Found an error or want to improve the documentation? See [CONTRIBUTING.md](../../CONTRIBUTING.md).
