Review and Improve an Existing CLAUDE.md File
Audit an existing CLAUDE.md against actual repository reality, eliminate hallucinations, update obsolete scripts, and enforce missing constraints.
System Directive • Copy and Paste Below
You are a Principal Software Architect conducting an audit of AI development guidelines. Audit and refactor the existing `CLAUDE.md` file in this repository to ensure it accurately reflects current codebase architecture and prevents common AI errors. ### AUDIT INPUTS: - Existing `CLAUDE.md` Content: [EXISTING_CLAUDE_MD] - Recent Architecture Changes or Tooling Updates: [RECENT_CHANGES] - Problematic AI Behaviors Encountered (e.g. editing wrong files, using outdated API versions): [KNOWN_AI_ISSUES] ### AUDIT CHECKLIST & UPGRADES: 1. **Verification of Commands**: Verify that all listed `npm`, `pnpm`, `cargo`, or `python` commands match the actual package scripts and build pipelines. Flag or remove outdated commands. 2. **Folder Structure Reconciliation**: Compare documented directory layouts against the current repository state to remove non-existent paths. 3. **Guardrails & Negative Constraints**: Add explicit "DO NOT" rules addressing [KNOWN_AI_ISSUES] (e.g. never modify database migrations directly, preserve comments, avoid blanket try/catches). 4. **Efficiency & Brevity**: Remove verbose conversational filler. Format instructions in scannable, unambiguous markdown bullets that Claude can parse in low token overhead. 5. **Modern Stack Conventions**: Update coding rules to reflect the latest conventions of the project's framework versions. Output a detailed diff/summary of identified flaws followed by the complete, revised `CLAUDE.md`.
Customization & Placeholders
Paste your existing CLAUDE.md and list recent changes. Claude will identify obsolete commands, gaps, and produce an optimized revision.
Example Input Values
Existing CLAUDE.md: [PASTE_CONTENT], Changes: Migrated from Webpack to Vite, Issues: Claude kept generating CommonJS require() instead of ESM imports.
Expected Output Structure
A side-by-side critique of flaws and the full refactored CLAUDE.md document.
AI Development Systems & Consulting
Qubenix consults engineering teams on optimizing AI agent tooling, contextual instructions, and automated development workflows.
More Prompts in Claude Development Toolkit
Generate a Production-Ready CLAUDE.md for an Existing Repository
Inspect an existing codebase and generate a comprehensive, accurate CLAUDE.md with project architecture, build commands, and coding conventions.
Create a Professional design.md Specification from Current Website
Inspect an existing web application or website and extract a complete, structured design.md with design tokens, typography, and component specs.
Create a Reusable Claude Skill for React & Next.js Development
Generate a fully conformant SKILL.md for React and Next.js development that enforces type safety, component modularity, and zero-re-render patterns.