improve-claude-md

Improve instruction adherence by rewriting CLAUDE.md to wrap domain guidance in targeted <important if> conditional blocks. This selectively reveals rules based on task context, overriding irrelevant system reminders.

Claude Code injects a system reminder stating content may be irrelevant, which can dilute instruction adherence. Wrapping your domain guidance in targeted <important if> blocks reinforces relevance and controls when rules apply.

The best way to structure conditional system prompts is keeping foundational project identity visible at the file top while gating detailed rules behind <important if> blocks. This preserves commands tables and yields structured deployment outputs.

Use conditional blocks by wrapping conditionally relevant sections of CLAUDE.md in <important if> syntax with explicit conditions. This requires YAML frontmatter with name and description fields to function correctly.

Rewriting CLAUDE.md preserves the commands table and structural guidance while adding conditional <important if> blocks. The process yields a structured output suitable for deployment without losing existing command definitions.

Use conditional guidance blocks in CLAUDE.md when domain guidance must be selectively revealed based on task context. This fits use cases like writing API prompts where only specific rules should influence the current response.