codybrom

codybrom/clairvoyance

Plugin Claude Code

Plugin marketplace listing 1 plugin: clairvoyance.

codybrom/clairvoyance

Plugin Claude Code

ESP for AI Coding — Agent skills on the philosophy of software design, grounded in decades of engineering experience.

codybrom/clairvoyance

Agent

Generates a design alternative in isolation, without seeing the first design. Used by the design-it-twice skill when a first design already exists in conversation.

codybrom/clairvoyance

Skill Claude CodeCodex

Evaluates whether abstractions provide a genuinely different way of thinking or are structurally shallow. Use when adjacent layers feel redundant, wrappers add boilerplate without depth, or an abstraction feels leaky. Not for a single module's interface-to-implementation ratio (use deep-modules) or information leakage…

codybrom/clairvoyance

Skill Claude CodeCodex

Evaluates whether changes to existing code maintain or degrade design quality. Use when reviewing diffs, PRs, or recently modified files to judge whether each change looks designed-in or bolted-on. Not for scanning design smells (use red-flags) or assessing overall design investment (use strategic-mindset).

codybrom/clairvoyance

Skill Claude CodeCodex

Reviews comment quality and documentation practices: the four comment types, comments-first workflow, and comment rot. Use when reviewing comments or docs, when comments just repeat the code, or when something is hard to describe in a sentence. Not for naming or code obviousness (use naming-obviousness).

codybrom/clairvoyance

Skill Claude CodeCodex

Diagnoses whether complexity exists and where it comes from, using the three-symptom, two-root-cause framework. Use when code feels harder to work with than it should but the specific problem is unclear. Not for scanning known design smells (use red-flags) or evaluating a module's depth (use deep-modules).

codybrom/clairvoyance

Skill Claude CodeCodex

Measures module depth: whether the interface is simple relative to the implementation behind it. Use when an interface has too many parameters or methods, many small classes each do too little, or methods just forward calls. Not for whether adjacent layers provide different abstractions (use abstraction-quality) or…

codybrom/clairvoyance

Skill Claude CodeCodex

Generates and compares at least two fundamentally different design alternatives on concrete criteria before committing. Use when the user asks to design something twice, or before committing to any significant design of classes, modules, APIs, or architecture. Not for judging strategic vs. tactical investment in…

codybrom/clairvoyance

Skill Claude CodeCodex

Orchestrates a structured design review, running the other skills as a diagnostic funnel from complexity triage to a full red-flags sweep. Use when reviewing a file, module, or PR for overall design quality and you want a comprehensive, prioritized assessment. Not for applying one specific lens (use that skill…

codybrom/clairvoyance

Skill Claude CodeCodex

Routes a vague symptom or complaint to the most relevant Clairvoyance skill via a decision tree. Use when someone describes a problem but doesn't know which skill to reach for. Not for a comprehensive review (use design-review) or a checklist scan (use red-flags).

codybrom/clairvoyance

Skill Claude CodeCodex

Reviews error handling and exception design, applying the "define errors out of existence" principle. Use when reviewing error handling, when a module throws too many exceptions, or when callers must handle errors they shouldn't need to know about. Not for general caller-burden complexity (use pull-complexity-down)…

codybrom/clairvoyance

Skill Claude CodeCodex

Evaluates whether interfaces are appropriately general-purpose. Use when checking interface generality, when if-branches or parameters serve only one caller, or when getters/setters expose internal representation. Not for information leakage across boundaries (use information-hiding) or auditing configuration…

codybrom/clairvoyance

Skill Claude CodeCodex

Checks for information leakage across module boundaries, including temporal decomposition and false encapsulation. Use when modules change together, implementation details leak across boundaries, or structure follows execution order rather than knowledge ownership. Not for merge/split decisions (use module-boundaries)…

codybrom/clairvoyance

Skill Claude CodeCodex

Evaluates where module boundaries are drawn and whether modules should be merged or split. Use when deciding whether to combine or separate two modules, when modules are tightly coupled, or when a change to one forces changes to another. Not for depth within a single module (use deep-modules) or abstraction-layer…

codybrom/clairvoyance

Skill Claude CodeCodex

Reviews naming quality and code obviousness via the isolation test, scope-length principle, and consistency audit. Use when names feel vague, something is hard to name (a design signal, not a vocabulary problem), or behavior isn't obvious on first read. Not for comment quality or documentation (use comments-docs).

codybrom/clairvoyance

Skill Claude CodeCodex

Checks whether complexity is pushed to callers or absorbed by implementations — the direction complexity flows. Use when callers must do significant setup, handle errors the module could resolve, or configure things they don't understand. Not for module depth (use deep-modules), knowledge leakage (use…

codybrom/clairvoyance

Skill Claude CodeCodex

Scans code against 17 design smells (the book's 14 named Red Flags plus 3 process-stage signals) and produces a structured diagnostic report. Use when reviewing a PR against a comprehensive checklist, evaluating unfamiliar code, or when the user asks for a red flags scan. Not for diagnosing why code feels complex (use…

codybrom/clairvoyance

Skill Claude CodeCodex

Assesses whether code reflects strategic or tactical thinking, including the 10-20% investment rule and tactical-tornado patterns. Use when evaluating design investment, when code was written under time pressure, or when working code consistently degrades the system. Not for judging whether a specific diff looks…