Clairvoyance
OnlineSoftware design skills for AI coding agents, inspired by A Philosophy of Software Design.
What it can do: 17 tools
deep-modulesread-onlyMeasures 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 camodule-boundariesread-onlyEvaluates 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 chinformation-hidingread-onlyChecks 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 exepull-complexity-downread-onlyChecks 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 theygeneral-vs-specialread-onlyEvaluates 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 foerror-designread-onlyReviews 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 sabstraction-qualityread-onlyEvaluates 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. Nonaming-obviousnessread-onlyReviews 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 behacomments-docsread-onlyReviews 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 tostrategic-mindsetread-onlyAssesses 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 whendesign-it-twiceread-onlyGenerates 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 ofcode-evolutionread-onlyEvaluates whether changes to existing code maintain or degrade design quality. Use when the user asks to review a diff or PR (for example before merging it), or asks about recently modified files, to judge whether each ccomplexity-recognitionread-onlyDiagnoses 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 scanningred-flagsread-onlyScans 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 the user asks for a red flags or design smell scan, asks to check coddesign-reviewread-onlyOrchestrates a structured design review, running the other skills as a diagnostic funnel from complexity triage to a full red-flags sweep. Use when the user asks for a comprehensive or prioritized design assessment of adiagnoseread-onlyRoutes 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-fetch-referenceread-onlyFetch a supporting file from a Clairvoyance skill's references/ folder, when the skill's instructions point to one. Available: information-hiding (back-door-leakage.md); pull-complexity-down (configuration-parameter-audi
Connect it
claude mcp add --transport http clairvoyance https://clairvoyance.fyi/mcpSettings → Connectors → Add custom connector
URL: https://clairvoyance.fyi/mcp{
"mcpServers": {
"clairvoyance": {
"url": "https://clairvoyance.fyi/mcp"
}
}
}{
"servers": {
"clairvoyance": {
"type": "http",
"url": "https://clairvoyance.fyi/mcp"
}
}
}Questions
What does Clairvoyance do?
Software design skills for AI coding agents, inspired by A Philosophy of Software Design. It exposes 17 tools to AI assistants.
What tools does Clairvoyance provide?
17 tools, including deep-modules, module-boundaries, information-hiding, pull-complexity-down, general-vs-special, error-design, abstraction-quality, naming-obviousness, comments-docs, strategic-mindset, design-it-twice, code-evolution….
How do I connect Clairvoyance to Claude, ChatGPT or Cursor?
Add the remote MCP endpoint https://clairvoyance.fyi/mcp as a custom connector or MCP server. Copy-paste setup is on this page.
Does Clairvoyance require an account or API key?
No sign-in was needed to list its tools. Individual tools may still need an account or API key.
Is Clairvoyance online?
As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.
Who publishes Clairvoyance?
clairvoyance.fyi. The official MCP Registry verified that the publisher controls this domain before accepting the listing.
Similar in Design & UI
-
Google StitchOnlineOfficialPopular
Interact with the Stitch API using natural language commands.
-
Google DesignOnlineOfficialPopular
Provides UX capabilities to enhance the design output and understanding of AI systems.
-
JustClaw-ItOnlineOfficialPopularNew
Licence-cleared code for coding agents, with attribution. Free search, MCP prompts and a skill pack.
-
Icons8Online · sign-in requiredOfficialPopular
Search and fetch genuine Icons8 icons and Ouch illustrations as SVG, PNG or animation.
-
Creative MarketOnlineOfficialNew
Find fonts, templates, and graphics from indie creators on Creative Market. Read-only, no account.
-
Generative IconsOnlineNew
Animated UI icons by LottieFiles. Search by meaning, set color, style and motion, export dotLottie.