Clairvoyance

ESP for AI Coding

Good software isn't written. It's designed.

Open your agent's third eye and see what it's been missing.

Claude Code

1 /plugin marketplace add codybrom/clairvoyance
2 /plugin install clairvoyance@clairvoyance-plugins

or via skills.sh

$ npx skills add codybrom/clairvoyance

Using Codex or OpenCode? See install instructions

Extrasensory Perspective

Your agent already knows how to code. Teach it how to see. Battle-tested philosophy on software design, grounded in decades of real-world engineering experience.

Structure

  • Deep Modules
  • Module Boundaries
  • Information Hiding
  • Pull Complexity Down
4 skills

Abstraction

  • General Vs Special
  • Error Design
  • Abstraction Quality
3 skills

Clarity

  • Naming Obviousness
  • Comments Docs
2 skills

Process

  • Strategic Mindset
  • Design It Twice
  • Code Evolution
  • Complexity Recognition
4 skills

Diagnostic

  • Red Flags
1 skill

See It in Action

Check out how Clairvoyance skills activate in real coding sessions. Your agent sees the design problem, applies the right principle and rewrites with intent.

clairvoyance · session replay
 
 
  
  
 
 
 
   
 
 
   
   
  
 
      
 
See through complexity
 

Adapted in part from the teachings of John Ousterhout and his book A Philosophy of Software Design. If you haven't read it, you should.

 
View on GitHub