# Quaestor
> 🏛️ Context management for AI-assisted development
[](https://pypi.org/project/quaestor/)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://jeanluciano.github.io/quaestor)
**Quaestor** transforms AI-assisted development through **specification-driven workflows**, intelligent agent orchestration, and streamlined context management for Claude Code.
## Key Features
- 🎯 **Specification-Driven Development** - Clear contracts with acceptance criteria and lifecycle management
- 🤖 **13 Specialized AI Agents** - Expert agents including new `speccer` for YAML generation
- 🔄 **Smart Automation Hooks** - Automatic spec validation and progress tracking
- ⚡ **40% Faster Context Loading** - Consolidated templates for better performance
- ✅ **Specification Validation** - Built-in `quaestor validate` command for spec files
## Quick Start
### Using uvx (Recommended - No Installation Required)
```bash
# Initialize Quaestor without installing it
uvx quaestor init
# Team mode - shared configuration
uvx quaestor init --mode team
# Update to latest version
uvx quaestor update
```
### Traditional Installation
```bash
# Install globally
pip install quaestor
# Initialize project
quaestor init
# Create your first specification
/plan "User Authentication System"
# Implement the specification
/impl spec-auth-001
```
## Project Modes
### Personal Mode (Default)
Perfect for individual projects:
```bash
quaestor init
```
- Commands installed globally in `~/.claude/commands/`
- Local settings in `.claude/settings.local.json` (not committed)
- Project files in `.quaestor/` (gitignored)
- CLAUDE.md with project-specific context
### Team Mode
For shared projects with consistent standards:
```bash
quaestor init --mode team
```
- Commands in `.claude/commands/` (committed, shared with team)
- Settings in `.claude/settings.json` (committed)
- Project files in `.quaestor/` (committed)
- CLAUDE.md with team standards and context
**Key Difference**: Personal mode keeps configuration local, Team mode shares everything with the team.
## Core Commands
- `/plan "Feature Name"` - Create specification with clear contracts
- `/impl spec-id` - Implement according to specification
- `/research "topic"` - Analyze codebase patterns and architecture
- `/review spec-id` - Validate implementation quality
- `/debug "issue"` - Systematic debugging and fixes
- `quaestor validate spec.yaml` - Validate specification file structure
## How It Works
### Specification-First Development
1. **Plan with Contracts** - `/plan` creates detailed specifications with input/output contracts
2. **Lifecycle Management** - Specs move through `draft/` → `active/` → `completed/` folders
3. **Agent Orchestration** - 13 specialized agents collaborate on implementation
4. **Quality Assurance** - Built-in testing and review workflows with automatic validation
### Example Workflow
```bash
# 1. Create specification
/plan "JWT Authentication API"
# → Creates spec-auth-001.yaml in draft/ folder
# 2. Implement with guided workflow
/impl spec-auth-001
# → Moves to active/, orchestrates architect → implementer → qa agents
# 3. Review and deploy
/review spec-auth-001
# → Validates quality, moves to completed/ when done
```
## Hook System
Quaestor's hooks integrate seamlessly with Claude Code using `uvx`, requiring no local installation:
- **Session Context Loader** - Automatically loads active specifications at session start
- **Progress Tracker** - Updates specification progress when TODOs are completed
- **Spec Validator** - Validates specification YAML files on save (blocks on errors)
- **No Python Required** - Hooks run via `uvx` without installing Quaestor in your project
The hooks are configured in `.claude/settings.json` and execute Quaestor commands remotely via `uvx`.
## Documentation
📚 **[Full Documentation](https://jeanluciano.github.io/quaestor)**
- [Installation & Setup](https://jeanluciano.github.io/quaestor/getting-started/installation/)
- [Quick Start Guide](https://jeanluciano.github.io/quaestor/getting-started/quickstart/)
- [Specification-Driven Development](https://jeanluciano.github.io/quaestor/specs/overview/)
- [Agent System](https://jeanluciano.github.io/quaestor/agents/overview/)
## Contributing
```bash
git clone https://github.com/jeanluciano/quaestor.git
cd quaestor
pip install -e .
pytest
```
## License
MIT License
---
<div align="center">
[Documentation](https://jeanluciano.github.io/quaestor) · [Issues](https://github.com/jeanluciano/quaestor/issues)
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "quaestor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "ai, development, context, claude, project-management, ai-tools",
"author": null,
"author_email": "Jean Luciano <jeanluciano@example.com>",
"download_url": "https://files.pythonhosted.org/packages/60/9e/854cad11156884db1099627d8159e24e588e9713c781f52c6e9a9b3ebe16/quaestor-0.6.3.tar.gz",
"platform": null,
"description": "# Quaestor\n\n> \ud83c\udfdb\ufe0f Context management for AI-assisted development\n\n[](https://pypi.org/project/quaestor/)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://jeanluciano.github.io/quaestor)\n\n**Quaestor** transforms AI-assisted development through **specification-driven workflows**, intelligent agent orchestration, and streamlined context management for Claude Code.\n\n## Key Features\n\n- \ud83c\udfaf **Specification-Driven Development** - Clear contracts with acceptance criteria and lifecycle management\n- \ud83e\udd16 **13 Specialized AI Agents** - Expert agents including new `speccer` for YAML generation\n- \ud83d\udd04 **Smart Automation Hooks** - Automatic spec validation and progress tracking \n- \u26a1 **40% Faster Context Loading** - Consolidated templates for better performance\n- \u2705 **Specification Validation** - Built-in `quaestor validate` command for spec files\n\n## Quick Start\n\n### Using uvx (Recommended - No Installation Required)\n```bash\n# Initialize Quaestor without installing it\nuvx quaestor init\n\n# Team mode - shared configuration\nuvx quaestor init --mode team\n\n# Update to latest version\nuvx quaestor update\n```\n\n### Traditional Installation\n```bash\n# Install globally\npip install quaestor\n\n# Initialize project\nquaestor init\n\n# Create your first specification\n/plan \"User Authentication System\"\n\n# Implement the specification\n/impl spec-auth-001\n```\n\n## Project Modes\n\n### Personal Mode (Default)\nPerfect for individual projects:\n```bash\nquaestor init\n```\n- Commands installed globally in `~/.claude/commands/`\n- Local settings in `.claude/settings.local.json` (not committed)\n- Project files in `.quaestor/` (gitignored)\n- CLAUDE.md with project-specific context\n\n### Team Mode\nFor shared projects with consistent standards:\n```bash\nquaestor init --mode team\n```\n- Commands in `.claude/commands/` (committed, shared with team)\n- Settings in `.claude/settings.json` (committed)\n- Project files in `.quaestor/` (committed)\n- CLAUDE.md with team standards and context\n\n**Key Difference**: Personal mode keeps configuration local, Team mode shares everything with the team.\n\n## Core Commands\n\n- `/plan \"Feature Name\"` - Create specification with clear contracts\n- `/impl spec-id` - Implement according to specification\n- `/research \"topic\"` - Analyze codebase patterns and architecture\n- `/review spec-id` - Validate implementation quality\n- `/debug \"issue\"` - Systematic debugging and fixes\n- `quaestor validate spec.yaml` - Validate specification file structure\n\n## How It Works\n\n### Specification-First Development\n1. **Plan with Contracts** - `/plan` creates detailed specifications with input/output contracts\n2. **Lifecycle Management** - Specs move through `draft/` \u2192 `active/` \u2192 `completed/` folders \n3. **Agent Orchestration** - 13 specialized agents collaborate on implementation\n4. **Quality Assurance** - Built-in testing and review workflows with automatic validation\n\n### Example Workflow\n```bash\n# 1. Create specification\n/plan \"JWT Authentication API\"\n# \u2192 Creates spec-auth-001.yaml in draft/ folder\n\n# 2. Implement with guided workflow\n/impl spec-auth-001 \n# \u2192 Moves to active/, orchestrates architect \u2192 implementer \u2192 qa agents\n\n# 3. Review and deploy\n/review spec-auth-001\n# \u2192 Validates quality, moves to completed/ when done\n```\n\n## Hook System\n\nQuaestor's hooks integrate seamlessly with Claude Code using `uvx`, requiring no local installation:\n\n- **Session Context Loader** - Automatically loads active specifications at session start\n- **Progress Tracker** - Updates specification progress when TODOs are completed\n- **Spec Validator** - Validates specification YAML files on save (blocks on errors)\n- **No Python Required** - Hooks run via `uvx` without installing Quaestor in your project\n\nThe hooks are configured in `.claude/settings.json` and execute Quaestor commands remotely via `uvx`.\n\n## Documentation\n\n\ud83d\udcda **[Full Documentation](https://jeanluciano.github.io/quaestor)**\n\n- [Installation & Setup](https://jeanluciano.github.io/quaestor/getting-started/installation/)\n- [Quick Start Guide](https://jeanluciano.github.io/quaestor/getting-started/quickstart/)\n- [Specification-Driven Development](https://jeanluciano.github.io/quaestor/specs/overview/)\n- [Agent System](https://jeanluciano.github.io/quaestor/agents/overview/)\n\n## Contributing\n\n```bash\ngit clone https://github.com/jeanluciano/quaestor.git\ncd quaestor\npip install -e .\npytest\n```\n\n## License\n\nMIT License\n\n---\n\n<div align=\"center\">\n\n[Documentation](https://jeanluciano.github.io/quaestor) \u00b7 [Issues](https://github.com/jeanluciano/quaestor/issues)\n\n</div>\n",
"bugtrack_url": null,
"license": null,
"summary": "AI-assisted development context management tool for maintaining consistency and productivity",
"version": "0.6.3",
"project_urls": {
"Homepage": "https://github.com/jeanluciano/quaestor",
"Issues": "https://github.com/jeanluciano/quaestor/issues",
"Repository": "https://github.com/jeanluciano/quaestor"
},
"split_keywords": [
"ai",
" development",
" context",
" claude",
" project-management",
" ai-tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "14551bb884344acb8a2b6bdddcf872d4f87ffa256588b6d9121b2c36b06512b9",
"md5": "36888df1a53398593c0c85a48e0ce22c",
"sha256": "11194a8b280629c8b3068bd76bfba3cb7516b048d51dde8d523bddc8304b94aa"
},
"downloads": -1,
"filename": "quaestor-0.6.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "36888df1a53398593c0c85a48e0ce22c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 148051,
"upload_time": "2025-08-07T02:15:14",
"upload_time_iso_8601": "2025-08-07T02:15:14.073855Z",
"url": "https://files.pythonhosted.org/packages/14/55/1bb884344acb8a2b6bdddcf872d4f87ffa256588b6d9121b2c36b06512b9/quaestor-0.6.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "609e854cad11156884db1099627d8159e24e588e9713c781f52c6e9a9b3ebe16",
"md5": "c08ad7bfa8e082f009120aa241a1e87d",
"sha256": "20b1830c6e569e91e4417154f70e2e34d739ff463dda902798f9ebb9b25b6bea"
},
"downloads": -1,
"filename": "quaestor-0.6.3.tar.gz",
"has_sig": false,
"md5_digest": "c08ad7bfa8e082f009120aa241a1e87d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 142934,
"upload_time": "2025-08-07T02:15:15",
"upload_time_iso_8601": "2025-08-07T02:15:15.302056Z",
"url": "https://files.pythonhosted.org/packages/60/9e/854cad11156884db1099627d8159e24e588e9713c781f52c6e9a9b3ebe16/quaestor-0.6.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 02:15:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jeanluciano",
"github_project": "quaestor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "quaestor"
}
JSON
