⚠️ Note on AI-Assisted Content: The documentation, code, and guidance across the Context Vibes initiative may be generated or significantly assisted by AI. This content is curated by our conceptual THEA Collective, but we urge you to exercise critical judgment, validate information, and be aware that AI-generated content can sometimes be incomplete or incorrect. Your feedback is invaluable.
Assembling the puzzle of modern, AI-augmented development.
The ContextVibes Initiative is an open-source project focused on solving a complex puzzle: How do we create an environment where developers are empowered by AI, not overwhelmed by it?
Our approach is to build this puzzle collaboratively, driven by the THEA Collective—our conceptual team of AI personas—and our community. We focus on the synergy between Guidance Systems (THEA), Intelligent Tooling (ContextVibes CLI), and Modern Development Templates.
We see our initiative as a large, intricate jigsaw puzzle. This analogy guides how we work and why the project is constantly evolving.
- The Image on the Box (The Vision): A future where developers and AI collaborate seamlessly.
- The Puzzle Pieces (Our Work): Every file in every repository is a single piece we are fitting into the larger picture.
- The Unfinished Picture (Our Opportunity): This puzzle will never be "finished." It will only become more complete as the community and core team contribute new pieces, making the picture clearer and more powerful over time.
This iterative process ensures our guidance, tools, and templates evolve to meet real-world needs.
Our initiative has three major components, each in its own repository but designed to connect perfectly.
THEA provides the background and context for everything else. It is the foundational knowledge, best practices, and structured guidance curated by the THEA Collective.
-
Principles for effective AI collaboration.
-
Reusable prompts, heuristics, and schemas.
-
Playbooks for common development and AI interaction tasks.
-
Explore the guidance and contribute to THEA: https://github.com/contextvibes/THEA
The CLI is the engine that does the work. It's the set of powerful, functional pieces that automates tasks and brings THEA's guidance to life in the developer's terminal.
-
Structured terminal output.
-
AI context generation.
-
Project-specific configurability.
-
Install the CLI and contribute to its development: Visit the Context Vibes CLI Repository
The templates are the concrete structures you can see and use immediately. They are pre-built sections of the puzzle that use the "sky" (THEA) for their design and the "machinery" (CLI) for their operation.
-
Embed THEA guidance (e.g., via
.idx/airules.md). -
Integrate with the ContextVibes CLI for enhanced workflows.
-
Provide a quick start for various project types (Go, Terraform, Dataform, etc.).
-
Explore our templates and the guidance for building them in the THEA repo:
This initiative thrives on community participation. Whether you want to contribute code to the CLI, refine a playbook in THEA, or propose a new template, your contributions help complete the picture.
- ContextVibes CLI: Contribute via its Contributing Guidelines and Issues Page.
- THEA Guidance System: Contribute via its Contributing Guidelines.
- Join the Discussion: https://github.com/orgs/contextvibes/discussions
Projects within the ContextVibes Initiative are typically released under the MIT License.
