Quaestor
A minimal Claude Code plugin for specification-driven development
Quaestor is a Claude Code plugin that provides Skills and slash commands for specification-driven development. Write lightweight specs, implement with context, ship with confidence.
Design Principles:
- Zen - Minimal surface area, maximum utility
- Engineer as Driver - You make decisions, Quaestor provides structure
- Light Spec-Driven - Just enough specification to stay aligned
NOTE: Quaestor has been many things, but mainly a learning sandbox for me. Nowadays, it's a tool that I and a small number of people use. From 1.0 forward, Quaestor will be boring and stable. New features will be planned and added as Anthropic releases new features for Claude Code. This is all to say that Quaestor is "feature complete," and hardly any skills, sub-agents, or commands will be added. I've gotta get back to work, and so do you.
What's Included
7 Skills (auto-activate based on context):
managing-specifications - Create and manage specificationsimplementing-features - Implement features with quality gatesreviewing-and-shipping - Code review and PR generationdebugging-issues - Systematic bug investigationsecurity-auditing - Security analysis and vulnerability detectionoptimizing-performance - Performance profiling and optimizationinitializing-project - Setup Quaestor in any project
3 Slash Commands:
/plan - Create specifications/implement - Implement specs with tracking/research - Explore codebase patterns
Spec Lifecycle:
- Folder-based state:
draft/ → active/ → completed/
- Automatic progress tracking via checkboxes
- Max 3 active specs (enforced)
Installation
As a Claude Code Plugin (Recommended)
Alternatively, you can add the marketplace and install separately:
/plugin marketplace add jeanluciano/quaestor
/plugin install quaestor:quaestor
See Claude Code plugins documentation for details.
Via pip/uv (Project-Level)
For project-level installation:
pip install quaestor
# or
uv pip install quaestor
Then initialize in your project:
quaestor init
Quick Start
# Install the plugin
/plugin install quaestor@quaestor-official
# Create a spec
/plan "User authentication with JWT"
# Implement it
/implement spec-auth-001
# Ship it
"Create a pull request for spec-auth-001"
Skills activate automatically based on what you're doing. Just describe what you want in natural language:
- "Show my active specs" → managing-specifications skill
- "Debug the login failure" → debugging-issues skill
- "Review this code for security issues" → security-auditing skill
How It Works
Specifications
Create lightweight specifications that define:
- What you're building (title and description)
- Why you're building it (motivation)
- What success looks like (acceptance criteria as checkboxes)
Specs live in .quaestor/specs/ and move through folders as they progress:
.quaestor/specs/
├── draft/ # Planned work
├── active/ # In progress (max 3)
└── completed/ # Finished
Skills
Skills are auto-activating workflows that trigger based on context. You don't invoke them directly - just describe what you want:
- Want to plan? Say "create a spec for X" → managing-specifications activates
- Want to implement? Use
/implement spec-id → implementing-features activates
- Want to ship? Say "create a PR" → reviewing-and-shipping activates
Example Session
# Create a spec
/plan "Add rate limiting to API endpoints"
# → spec-feature-042.md created in draft/
# Start implementing
/implement spec-feature-042
# → Skills guide you through implementation with quality checks
# Check progress
"What's the status of spec-feature-042?"
# → "spec-feature-042: 3/5 criteria complete (60%)"
# Ship it
"Create a pull request for spec-feature-042"
# → PR created with spec context included
Documentation
📚 Full Documentation
Contributing
jeanluciano