flux-improve-claude-md

To add conditional blocks to CLAUDE.md, you restructure the file by separating foundational guidance from task-specific policies, wrapping the latter in <important if> tags to trigger instructions only when relevant conditions are met.

Inconsistent model behavior often occurs when long CLAUDE.md files mix foundational guidance with task-specific policies. Restructuring the file to separate these concerns ensures the model only applies task-specific rules when appropriate.

The best way to organize a long CLAUDE.md file is maintaining universal foundational content unwrapped at the top, then wrapping narrow task-specific sections with conditional tags to clarify exactly when those instructions apply.

Yes, restructuring CLAUDE.md preserves flux markers exactly as they appear. The <!-- BEGIN FLUX --> and <!-- END FLUX --> markers remain unwrapped during the conditional block wrapping process to maintain workflow integrity.

Yes, you can standardize conditional rules across multiple CLAUDE.md files. Applying conditional blocks separates concerns consistently, enabling reuse across different projects while maintaining standardized task-specific policy enforcement.

You should not use conditional blocks in CLAUDE.md for short files containing only universal foundational guidance. Conditional tags are designed specifically for long files that mix foundational content with complex task-specific policies.