clairvoyance plugin
ESP for AI Coding — Agent skills on the philosophy of software design, grounded in decades of engineering experience.
How to install the clairvoyance plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add codybrom/clairvoyance
/plugin install clairvoyance@clairvoyance-pluginsWhat's inside clairvoyance
17 parts read from the plugin's own files.
Agents 1
Call as @agent-clairvoyance:name- @agent-clairvoyance:clean-room-alternative
No description in the file.
Skills 16
Claude loads it when the task matches- abstraction-quality
Evaluates whether software abstractions provide genuine conceptual shifts or merely add redundant, shallow layers and boilerplate.
- code-evolution
Evaluates whether code modifications maintain or degrade design quality by analyzing diffs and pull requests for structural integrity.
- comments-docs
Evaluates code comment quality and documentation practices using specific frameworks like the four comment types and the comments-first workflow.
- complexity-recognition
Diagnoses software complexity using a framework of three symptoms and two root causes to identify why code is difficult to maintain.
- deep-modules
Evaluates whether a module's interface is simple relative to its implementation to prevent over-decomposition and shallow abstractions.
- design-it-twice
Generates and compares at least two fundamentally different design alternatives using concrete criteria before committing to an architecture.
- design-review
Orchestrates a multi-phase diagnostic funnel to perform comprehensive design assessments of files, modules, or pull requests.
- diagnose
Routes vague software symptoms or complaints to the most relevant specialized skill using a decision tree.
- error-design
Reviews error handling and exception design using principles to reduce interface complexity and eliminate unnecessary exceptions.
- general-vs-special
Evaluates whether software interfaces are appropriately general-purpose to prevent over-specialization and representation leakage.
- information-hiding
Analyzes code to detect information leakage across module boundaries and identify improper temporal decomposition or false encapsulation.
- module-boundaries
Evaluates module boundaries to determine whether components should be merged or split based on coupling and knowledge ownership.
- naming-obviousness
Evaluates code readability by auditing variable and method names using isolation tests, scope-length principles, and consistency checks.
- pull-complexity-down
Analyzes code to ensure complexity is absorbed by implementations rather than being pushed to callers through excessive configuration or error handling.
- red-flags
Scans code against 17 design smells to produce a structured diagnostic report identifying structural, boundary, and documentation issues.
- strategic-mindset
Evaluates whether code reflects strategic design investment or tactical shortcuts to prevent long-term system degradation.
Using clairvoyance in Claude Code
Ask for an agent by name:
@agent-clairvoyance:clean-room-alternativeSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update clairvoyance@clairvoyance-plugins
- Refresh the marketplace
- /plugin marketplace update clairvoyance-plugins
- Turn it off for now
- /plugin disable clairvoyance@clairvoyance-plugins
- Remove it
- /plugin uninstall clairvoyance@clairvoyance-plugins
Skills in clairvoyance
- comments-docscodybrom/clairvoyance
Evaluates code comment quality and documentation practices using specific frameworks like the four comment types and the comments-first workflow.
2 files18stars - design-it-twicecodybrom/clairvoyance
Generates and compares at least two fundamentally different design alternatives using concrete criteria before committing to an architecture.
2 files18stars - design-reviewcodybrom/clairvoyance
Orchestrates a multi-phase diagnostic funnel to perform comprehensive design assessments of files, modules, or pull requests.
2 files18stars - information-hidingcodybrom/clairvoyance
Analyzes code to detect information leakage across module boundaries and identify improper temporal decomposition or false encapsulation.
2 files18stars - pull-complexity-downcodybrom/clairvoyance
Analyzes code to ensure complexity is absorbed by implementations rather than being pushed to callers through excessive configuration or error handling.
2 files18stars - red-flagscodybrom/clairvoyance
Scans code against 17 design smells to produce a structured diagnostic report identifying structural, boundary, and documentation issues.
2 files18stars - abstraction-qualitycodybrom/clairvoyance
Evaluates whether software abstractions provide genuine conceptual shifts or merely add redundant, shallow layers and boilerplate.
18stars - code-evolutioncodybrom/clairvoyance
Evaluates whether code modifications maintain or degrade design quality by analyzing diffs and pull requests for structural integrity.
18stars - complexity-recognitioncodybrom/clairvoyance
Diagnoses software complexity using a framework of three symptoms and two root causes to identify why code is difficult to maintain.
18stars - deep-modulescodybrom/clairvoyance
Evaluates whether a module's interface is simple relative to its implementation to prevent over-decomposition and shallow abstractions.
18stars - diagnosecodybrom/clairvoyance
Routes vague software symptoms or complaints to the most relevant specialized skill using a decision tree.
18stars - error-designcodybrom/clairvoyance
Reviews error handling and exception design using principles to reduce interface complexity and eliminate unnecessary exceptions.
18stars - general-vs-specialcodybrom/clairvoyance
Evaluates whether software interfaces are appropriately general-purpose to prevent over-specialization and representation leakage.
18stars - module-boundariescodybrom/clairvoyance
Evaluates module boundaries to determine whether components should be merged or split based on coupling and knowledge ownership.
18stars - naming-obviousnesscodybrom/clairvoyance
Evaluates code readability by auditing variable and method names using isolation tests, scope-length principles, and consistency checks.
18stars - strategic-mindsetcodybrom/clairvoyance
Evaluates whether code reflects strategic design investment or tactical shortcuts to prevent long-term system degradation.
18stars
clairvoyance plugin questions
How do I install the clairvoyance plugin?
In Claude Code run /plugin marketplace add codybrom/clairvoyance, then /plugin install clairvoyance@clairvoyance-plugins.
What does the clairvoyance plugin include?
clairvoyance bundles 1 agent, 16 skills.
Which agents come with clairvoyance?
clean-room-alternative. Call one with @agent-clairvoyance:clean-room-alternative.
How do I update or remove the clairvoyance plugin?
Update it with claude plugin update clairvoyance@clairvoyance-plugins in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall clairvoyance@clairvoyance-plugins.