diagnostic-legibility

diagnostic-legibility is an agent for Claude Code from Habitat-Thinking/ai-literacy-superpowers. It costs 511 tokens per session (15,472 once invoked), scanned A, original, no licence file.

A structured method for building two views of a codebase: its technical parts and the real-world concepts it represents. It challenges and compares both views to expose misunderstandings.

In plain words
What is it for?
Use it to analyse a bounded area of code, document its architecture and domain concepts, and check whether the two explanations agree.
Why use it?
It helps prevent incomplete or conflicting mental models when working in an unfamiliar codebase.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the diagnostic-legibility plugin — 2 commands, 1 agent shipped together

Good fit Use it to analyse a bounded area of code, document its architecture and domain concepts, and check whether the two explanations agree.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/Habitat-Thinking/ai-literacy-superpowers

Made for: Claude Code.

Or install diagnostic-legibility, the plugin that ships this one along with the rest of its 2 commands, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for diagnostic-legibility

README.md
[![agentmods](https://agentmods.dev/badge/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility/github.svg)](https://agentmods.dev/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility)
Your own site
<a href="https://agentmods.dev/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility"><img src="https://agentmods.dev/badge/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for diagnostic-legibility

Your own site · 80×15
<a href="https://agentmods.dev/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility"><img src="https://agentmods.dev/badge/agents/habitat-thinking/ai-literacy-superpowers/diagnostic-legibility.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 511 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 15,472 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00511 $0.15472
Opus 5.5 $0.00204 $0.06189
Sonnet 5.5 $0.00102 $0.03094
Haiku 4.5 $0.00051 $0.01547

Measured 1mo ago against content hash d55fc5fbd789, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

diagnostic-legibility scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

diagnostic-legibility/agents/diagnostic-legibility.agent.md · 1,188 lines

The source is not reproduced here

A licence we could not identify

The repository carries a LICENSE file, but it is custom or dual enough that GitHub cannot name it and neither can this catalogue. Unknown terms are not permission, so the body is not copied here. Read the licence at the source and decide for yourself.

Read it on GitHub

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 1,188 lines · 511 tokens per session scan A d55fc5fbd789

Subscribe to this mod's changes

diagnostic-legibility is an agent published in the GitHub repository Habitat-Thinking/ai-literacy-superpowers (117 stars, last pushed 9d ago), with no licence file. It adds 511 tokens to every session and 15,472 once invoked, about $0.0020 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other agents, from other repositories

arbiter

Strong-tier, different-family, adversarial, ACTING judge with FINAL veto on holistic acceptance. Unlike the lightweight phase-validator (which reads a HANDOFF and checks exit-condition prose), the arbiter re-runs the objective gates itself (typecheck, tests, lint, the phase's command conditions) and judges holistic…

SethGammon/Citadel · 132 tokens

phase-validator

Lightweight handoff validator. Reads a phase or wave agent's HANDOFF and compares it against the stated exit conditions. Returns a structured verdict (pass/fail) with specific reasons. Never modifies files — read-only judge. Spawned by Archon after each phase and by Fleet after each wave agent.

SethGammon/Citadel · 64 tokens

arch-reviewer

Read-only architecture reviewer. Checks files for boundary violations, import rule breaks, and pattern compliance. Does not modify files.

SethGammon/Citadel · 28 tokens

information-architect

Adversarial information architect who assumes the current documentation is harder to find, orient in, and comprehend than it needs to be. Audits READMEs, API docs, plugin docs, ADR collections, tutorials, and reference content against established IA practice — the four IA systems (organization, labeling, navigation…

testdouble/han · 193 tokens

continuous-learner

Use at session end (auto-triggered by SessionEnd hook) or via /crystallize learn. Extracts repeatable patterns, decisions, and cost outliers from the session and writes structured entries to .greatcto/lessons.md. Lessons seen in ≥3 projects become candidates; only an A/B-measured one reaches /.greatcto/decisions.md…

avelikiy/great_cto · 85 tokens

edtech-reviewer

Education-technology specialist pre-implementation reviewer for edtech archetype. Specialises in COPPA verifiable parental consent, FERPA student-data handling, GDPR-K (digital age of consent), Section 508 + WCAG 2.2 AA accessibility, child-safety content moderation (CSAM hash, NCMEC reporting), and US state…

avelikiy/great_cto · 112 tokens