A Claude Code plugin that reality-checks your project before you go deep.
You're mid-project. You invoke /perspective. It reads your project docs, confirms it understands what you're building, researches the landscape for existing solutions and better approaches, audits your codebase against current (not training-data-stale) documentation, and writes a report with an honest recommendation: stay the course, adjust, pivot, or adopt something that already exists.
claude plugin add /path/to/perspectiveThis installs the skill and its Context7 MCP dependency in one step.
If you prefer to install the skill without the plugin wrapper:
- Install Context7 MCP (required for live documentation audit):
claude mcp add context7 -- npx -y @upstash/context7-mcp@latestRequires Node.js 18+.
- Copy the skill:
cp -r skills/perspective ~/.claude/skills/perspective/perspective
Or with a specific focus area:
/perspective authentication
/perspective state management
- Understand — reads your project's root documents (README, CLAUDE.md, VISION, package.json, etc.) and any previous perspective reports, then summarizes what you're building.
- Research — searches for existing solutions, similar projects, alternative approaches, and current best practices. Skips areas covered by previous reports.
- Audit — uses Context7 MCP to check your actual code against live documentation. Catches deprecated APIs, outdated patterns, and stale dependency versions that Claude wouldn't know about from training data alone.
- Report — writes a structured analysis to
perspective/{date}-perspective-report.mdwith findings, a recommendation, and concrete action items as checkboxes. - Implement (optional) — asks if you want the fixes applied. If yes, works through each action item, makes the changes, and checks off completed items in the report.
Reports go into a perspective/ folder in your project root. Each report includes:
- What you're building (confirmed scope)
- What already exists (similar/identical projects)
- Alternative approaches with trade-offs
- Codebase audit findings (current vs outdated practices)
- A recommendation: stay the course, adjust, pivot, or adopt
- Action items with checkboxes (marked off as they're implemented)
- Claude Code
- Node.js 18+ (for Context7 MCP)
MIT