Centauro - Context Engineering Plugin for Claude Code
A comprehensive Context Engineering framework plugin that brings professional context management capabilities to any Claude Code project.
Overview
Centauro implements the C = A(c₁, c₂, c₃, c₄, c₅, c₆) framework, providing a complete system for creating, analyzing, validating, and managing context files in your Claude Code projects. It ensures high-quality, consistent, and efficient context engineering through proven methodologies and automated workflows.
Features
🤖 Dual Interface
Skill-Assisted Mode - 70% of usage
- The
centauro:context-engineering skill activates automatically when you discuss context engineering tasks
- Provides guidance and executes context operations (create, analyze, validate)
- Triggered by natural language like "analyze my contexts" or "create a context file"
- Lightweight: ~10k tokens (Core + Task-Specific levels)
Agent-Driven Mode - 30% of usage
- Explicit control with
@context-manager for complex bulk operations
- Use when you need comprehensive context management or batch processing
- Example:
@context-manager analyze all c₂ contexts for quality and discrepancies
- Full context: ~45k tokens (all levels, comprehensive knowledge base)
Note: Context loading is command-driven. Use /centauro:prepare (recommended) for smart preparation with reuse detection, or /centauro:load and /centauro:curate for manual control.
🎯 Core Capabilities
- Progressive Disclosure Architecture - 3-level context loading (Core 2-5k tokens → Task-Specific +5-10k → Deep +5-10k) for optimal performance
- Context Classification - Intelligent categorization into c₁-c₆ components
- Quality Analysis - 4-dimensional quality framework (Relevance, Completeness, Consistency, Efficiency)
- Context Curation - 3-phase quality-gated curation system with smart reuse detection and automated synthesis
- Validation - Detect contradictions, gaps, and discrepancies across contexts
- Lifecycle Management - Create, update, version, and delete contexts safely
- Portfolio Management - Inventory, prioritize, and organize your context ecosystem
📊 Quality Framework
Contexts are evaluated using a weighted quality formula:
Q = 0.40·Relevance + 0.30·Completeness + 0.20·Consistency + 0.10·Efficiency
With a standardized grading scale:
- A (≥0.90): Excellent, production-ready
- B (0.80-0.89): Good, minor improvements optional
- C (0.70-0.79): Acceptable, refinement recommended
- D (0.60-0.69): Deficient, significant work required
- F (<0.60): Inadequate, consider rewriting
Installation
From a Marketplace
/plugin install centauro@your-marketplace
From Local Directory
- Clone or copy this plugin to your plugins directory
- Use Claude Code's plugin management to load it
Quick Start
Initialize Your Project
First, set up the Context Engineering infrastructure in your project:
/centauro:setup
This creates a .centauro/ directory with:
contexts/ - Organized subdirectories for c₁-c₅ componentscontexts/.gitignore - Protection for sensitive filestemplates/ - For your custom context templatesREADME.md - Framework documentation and usage guide
Available Commands
Context Operations:
/centauro:setup - Initialize the Context Engineering infrastructure/centauro:build - Build context files through guided interview/centauro:detect - Analyze task to determine needed context files/centauro:process <file-or-description> - Process files/folders into context system
Quality & Curation:
/centauro:assess-quality - Assess context quality with 4D framework/centauro:prepare <task> [--quality-threshold 0.70] [--force] - Recommended: Smart context preparation with reuse detection (30-120s)
- Checks for existing curated memories and offers reuse
- Runs fresh 3-phase curation if needed or declined
- Use
--force to skip reuse check
/centauro:curate <task> - Create quality-gated curated memory for a task (30-120s)/centauro:load <task-or-number> - Load previously curated memory (fast, ~2s)
Learning & Reflection:
/centauro:reflect [focus-area] - Extract learnings from current session
Start Creating Contexts
After initialization, you can immediately start working with contexts using either interface.
Usage
Loading Contexts (Command-Driven)
Recommended: Smart context preparation (checks for reuse, creates if needed):
/centauro:prepare "implement OAuth2 authentication"
# Phase 0: Checks for existing curated memories
# - If found: Shows match quality and asks to reuse
# - If declined/not found: Runs fresh 3-phase curation (30-120s)
# Creates curated memory in .centauro/contexts/c4-memory/curated/
# Force fresh curation (skip reuse check)
/centauro:prepare "implement OAuth2 authentication" --force
