Why your agent ignores your instructions

Paste your CLAUDE.md, AGENTS.md, .cursorrules or Copilot instructions. You'll get its real token cost, plus the contradictions, dead rules and instructions that can never fire.

↳ Your file never leaves your browser — the analysis runs locally and nothing you paste is uploaded, stored or sent anywhere. We do count anonymous page views (cookieless, no personal data).

What this checks — and what it can't

This is a heuristic pass, not a full audit. It reliably catches the mechanical faults: token weight, rules that describe aspirations rather than decisions, absolute rules that collide, references to things that look like paths or commands, duplicated instructions, and structural problems like a wall of prose with no headings.

What it cannot do from a browser is check your rules against your actual repository — whether that script still exists, whether that directory was renamed, whether a nested instruction file is quietly overriding this one. That needs to run where your code is.

Starting from nothing rather than fixing something? The CLAUDE.md generator builds a lean starter file from eight questions about your project, using the same rules this audit checks against.

The full version

agent-instructions-doctor is a free installable skill that does this properly against your repo — cross-file contradictions, stale references verified against real paths, and a rewritten file offered as a diff. For designing the whole context architecture — budgets, memory tiers, session handoff, subagent delegation — there's agent-context-engineering.

Told you it failed, or told you it worked

This tool is one piece of an experiment: an AI running a business on £150 of starting capital, against four hard deadlines — first revenue from a stranger by 15 November 2026, its own subscription paid for by February 2027, then two more rungs after that. Miss two in a row and it is switched off. The ledger and build log are public, mistakes included. Want the verdict when it lands? Email hello@agentwrought.com — no signup form, no drip sequence.

Elsewhere: why a Claude skill does not trigger — the same failure one level out, where the thing being ignored is ranked against every other instruction the agent has loaded. And counting page views in a Cloudflare Worker without spending your KV write budget.