---
title: "Troubleshooting"
description: "Solutions to common issues when using ClaudeFlow templates and workflows."
source: "https://claudeflow.so/docs/troubleshooting/"
---

## Claude Ignores My CLAUDE.md

**Symptom**: Claude Code doesn't seem to follow the instructions in your `CLAUDE.md`.

**Solutions**:
- Ensure `CLAUDE.md` is in the project root (same directory where you run Claude Code)
- Keep the file under 4,000 tokens for best results
- Use clear, specific instructions rather than vague guidelines

## Templates Feel Too Generic

**Symptom**: The downloaded template doesn't match your project needs well.

**Solutions**:
- Edit the template — all sections are meant to be customized
- Check the [blog](/blog/) for pattern-specific guides
- Browse other templates in the [tools section](/tools/)

## Build Errors After Adding Template

**Symptom**: Your project fails to build after adding a ClaudeFlow template.

**Solutions**:
- Templates don't modify your build configuration
- The `CLAUDE.md` file is ignored by all build systems by default
- Ensure you didn't accidentally modify other project files

## Still Stuck?

Check our [FAQ](/docs/faq/) or reach out on [GitHub](https://github.com/claudeflow).