PAELLADOC is an AI-first development framework designed to revolutionize software creation by treating context as the primary artifact. It targets developers seeking to integrate AI seamlessly into their workflows, enabling intent preservation, automated documentation, and human-AI collaboration.

How It Works

PAELLADOC implements Anthropic's Model Context Protocol (MCP) to structure LLM interactions with external tools. This allows LLMs to leverage PAELLADOC's AI-first principles, where context is versioned, knowledge graphs capture relationships, and every decision preserves its philosophical context. The framework aims to shift development from code-first to context-first, ensuring knowledge evolves alongside systems and facilitating seamless human-AI collaboration.

Quick Start & Requirements

• Installation: Requires Python 3.12 or later. Installation is via pip install paelladoc within a dedicated Python virtual environment. An alternative installation method using npx -y @smithery/cli install @jlcases/paelladoc --client claude is also provided.
• Configuration: Requires configuring the LLM tool (e.g., Cursor IDE via .cursor/mcp.json) with the absolute path to the Python executable within the virtual environment and optionally setting PAELLADOC_DB_PATH.
• Resources: A dedicated Python virtual environment is recommended.
• Documentation: Official Website, CHANGELOG.

Highlighted Details

• Implements Anthropic's Model Context Protocol (MCP) for structured LLM interaction.
• Adheres to five AI-First Development principles: Context as Primary Creation, Intent-Driven Architecture, Knowledge as Living Entity, Human-AI Collaborative Consciousness, and Contextual Decision Architecture.
• Supports versioning of context alongside code and preservation of intent through UUIDs.
• Offers commands like paella_init, paella_list, paella_select, and core_continue for project management and documentation.

Maintenance & Community

• The project is actively developed, with recent hotfix releases.
• Active development is currently focused internally on an MVP.
• GitHub Repository.

Licensing & Compatibility

• The README does not explicitly state the license.

Limitations & Caveats

• The project is currently in early development (v0.3.7), with active development focused internally on an MVP, suggesting potential for significant changes.
• Some commands are described as "basic stub implementation," indicating incomplete functionality.
• The README notes that the main branch is considered unstable.