{"id":26650998,"url":"https://github.com/helloprkr/dotai_boiler","last_synced_at":"2025-03-25T02:49:25.128Z","repository":{"id":260731096,"uuid":"870753644","full_name":"helloprkr/dotai_boiler","owner":"helloprkr","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-07T07:14:35.000Z","size":38,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T08:24:39.111Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helloprkr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-10T15:51:21.000Z","updated_at":"2025-03-07T07:14:38.000Z","dependencies_parsed_at":"2024-11-02T06:28:07.972Z","dependency_job_id":"b3e24ef4-524f-4b8e-b0e8-1475c00ed9e3","html_url":"https://github.com/helloprkr/dotai_boiler","commit_stats":null,"previous_names":["helloprkr/dotai_boiler"],"tags_count":0,"template":false,"template_full_name":"udecode/dotai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helloprkr%2Fdotai_boiler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helloprkr%2Fdotai_boiler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helloprkr%2Fdotai_boiler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helloprkr%2Fdotai_boiler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helloprkr","download_url":"https://codeload.github.com/helloprkr/dotai_boiler/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245388762,"owners_count":20607163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-25T02:49:24.341Z","updated_at":"2025-03-25T02:49:25.120Z","avatar_url":"https://github.com/helloprkr.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧿 DotAI Boiler\n\n\u003cdiv align=\"center\"\u003e\n\n\u003c!-- Add logo once you have one\n\u003cimg src=\"https://github.com/helloprkr/dotai_boiler/assets/raw/main/docs/images/logo.png\" alt=\"DotAI Boiler Logo\" width=\"200\"/\u003e\n--\u003e\n\n[![DotAI Boiler](https://img.shields.io/badge/DotAI-Boiler-4285F4?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyem0xIDE3aC0ydi0yaDF2LTVoLTF2LTJoM3Y3em0wLTEySC0xMVY1aDJ2MnoiLz48L3N2Zz4=)](https://github.com/helloprkr/dotai_boiler)\n[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](./LICENSE)\n[![Code Quality](https://img.shields.io/badge/AI_Enhanced-Code_Quality-FF5700?style=for-the-badge)]()\n[![Stars](https://img.shields.io/github/stars/helloprkr/dotai_boiler?style=for-the-badge)](https://github.com/helloprkr/dotai_boiler/stargazers)\n[![Last Commit](https://img.shields.io/github/last-commit/helloprkr/dotai_boiler?style=for-the-badge)](https://github.com/helloprkr/dotai_boiler/commits/main)\n\n**A sophisticated framework for AI-assisted development workflows**\n\nDotAI Boiler transforms your development workflow by creating a structured knowledge ecosystem that evolves with your project, ensuring AI assistants maintain deep context across sessions while enforcing consistent implementation patterns. This sophisticated framework bridges the gap between human creativity and machine precision, dramatically reducing cognitive overhead and technical debt through its comprehensive Codex system, session management tools, and standardized blueprints that adapt to your specific project requirements.\n\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Architecture](#️-architecture) • [Advanced Features](#-advanced-features) • [Contributing](#-contributing) • [License](#-license)\n\n\u003c/div\u003e\n\n## 📋 Table of Contents\n\n- [🤖 DotAI Boiler](#-dotai-boiler)\n  - [📋 Table of Contents](#-table-of-contents)\n  - [✨ Features](#-features)\n  - [🚀 Installation](#-installation)\n    - [Prerequisites](#prerequisites)\n    - [Basic Installation](#basic-installation)\n    - [Advanced Installation Options](#advanced-installation-options)\n  - [📚 Usage](#-usage)\n    - [AI Codex](#ai-codex)\n    - [Session Management](#session-management)\n    - [Blueprints](#blueprints)\n    - [Quick Start Guide](#quick-start-guide)\n  - [🏗️ Architecture](#️-architecture)\n  - [🔧 Advanced Features](#-advanced-features)\n    - [Model Context Protocol (MCP)](#model-context-protocol-mcp)\n    - [AI Plugins](#ai-plugins)\n    - [Integration Capabilities](#integration-capabilities)\n  - [🛠️ Customization](#️-customization)\n    - [Creating Custom Rules](#creating-custom-rules)\n    - [Extending Blueprints](#extending-blueprints)\n  - [👥 Contributing](#-contributing)\n  - [📝 License](#-license)\n  - [🙏 Acknowledgements](#-acknowledgements)\n  - [📊 Project Status](#-project-status)\n\n## ✨ Features\n\n- **💡 AI Codex System**: Repository of learnings and errors to improve code quality over time\n- **🤝 AI Assistant Integration**: Seamless workflow with Ai/LLMs like GitHub Copilot, Claude, and ChatGPT\n- **💾 Session Management**: Maintain project context across multiple interactions with persistent memory\n- **🗺️ Blueprints**: Comprehensive guides for implementing specific technical architectures\n- **📝 Snippets**: Code templates for consistent implementation patterns across your project\n- **📏 MCP Rules**: Specialized rules for AI interactions with different technologies\n- **📚 Version Controlled AI Memory**: Track and manage AI learning across your project lifecycle\n- **🔄 Workflow Automation**: Streamline repetitive tasks with AI-powered scripts\n- **🧩 Plugin System**: Extend functionality with custom plugins and integrations\n\n## 🚀 Installation\n\n### Prerequisites\n\n- Git installed on your system\n- An AI assistant of your choice (Cursor Editor, GitHub Copilot, etc.)\n\n### Basic Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/helloprkr/dotai_boiler.git\n\n# Navigate to the project directory\ncd dotai_boiler\n\n# Initialize your project\n# Copy configuration files to your project root or use as a reference\ncp -r .ai/ /path/to/your/project/\n```\n\n### Advanced Installation Options\n\nFor advanced users who want to customize their installation:\n\n```bash\n# Install with specific blueprints only\ncp -r .ai/blueprints/supabase-drizzle/ /path/to/your/project/.ai/blueprints/\n\n# Install as a Git submodule for easier updates\ngit submodule add https://github.com/helloprkr/dotai_boiler.git .ai\n```\n\n## 📚 Usage\n\n### AI Codex\n\nThe Codex system maintains a repository of learnings and errors to improve code quality:\n\n```bash\n# Review the Codex\ncat .ai/codex/codex.md\n\n# Add a new learning to the Codex\necho \"# Learning: Optimizing React re-renders \\n\\n...\" \u003e .ai/codex/learn-react-optimization.md\n\n# Reference the Codex in your commits\ngit commit -m \"fix: Apply Codex learning on React optimization (ref: learn-react-optimization.md)\"\n```\n\n### Session Management\n\nCreate a \"memory layer\" for AI across multiple interactions:\n\n```bash\n# Start a new AI session\necho \"# Session: Implementing authentication \\n\\n...\" \u003e .ai/session/auth-implementation.md\n\n# Update the session with new information\necho \"## Database schema \\n\\n...\" \u003e\u003e .ai/session/auth-implementation.md\n\n# Reference the session when working with your AI assistant\n# @import .ai/session/auth-implementation.md\n```\n\n### Blueprints\n\nImplement specific technical architectures with step-by-step guides:\n\n- **Supabase + Drizzle + Server Actions**: Comprehensive backend architecture\n  ```bash\n  # View the blueprint\n  cat .ai/blueprints/supabase-drizzle/README.md\n  \n  # Follow implementation steps\n  cat .ai/blueprints/supabase-drizzle/01-setup.md\n  ```\n\n- **Flux + Replicate**: Image generation workflow\n  ```bash\n  # View the blueprint\n  cat .ai/blueprints/flux-replicate/README.md\n  ```\n\n- **Model Context Protocol (MCP)**: Optimized AI interactions\n  ```bash\n  # View the MCP documentation\n  cat .ai/rules/mcp/README.md\n  ```\n\n### Quick Start Guide\n\n1. Initialize DotAI Boiler in your project\n2. Create a session file for your current task\n3. Reference appropriate blueprints for implementation\n4. Use snippets for consistent code patterns\n5. Document learnings in the Codex for future reference\n\n## 🏗️ Architecture\n\n```\n.\n├── .ai/                  # AI-assisted development tools\n│   ├── actions/          # Automated actions for AI workflows\n│   ├── blueprints/       # Architecture implementation guides\n│   │   ├── supabase-drizzle/    # Supabase backend architecture\n│   │   ├── flux-replicate/      # Image generation workflow\n│   │   └── nextjs-complete/     # Full-stack Next.js architecture\n│   ├── codex/            # Repository of AI learnings and errors\n│   │   ├── codex.md      # Main codex document\n│   │   ├── learn.md      # Template for new learnings\n│   │   └── errors/       # Documented error patterns\n│   ├── components/       # Reusable UI/UX components\n│   ├── lib/              # Library documentation and examples\n│   │   ├── react/        # React-specific libraries\n│   │   └── node/         # Node.js utilities\n│   ├── plugins/          # Integration with external AI tools\n│   │   ├── v0/           # v0.dev integration\n│   │   └── replicate/    # Replicate models integration\n│   ├── rules/            # Rules for AI behavior\n│   │   ├── mcp/          # Model Context Protocol rules\n│   │   ├── typescript/   # TypeScript-specific rules\n│   │   └── nextjs/       # Next.js framework rules\n│   ├── scripts/          # Automation scripts\n│   │   ├── session.sh    # Session management utilities\n│   │   └── codex.sh      # Codex management utilities\n│   ├── session/          # Session management tools\n│   │   ├── start-session.md  # Start session template\n│   │   ├── end-session.md    # End session template\n│   │   └── template.md   # Session template\n│   ├── snippets/         # Code templates\n│   │   ├── react/        # React component templates\n│   │   ├── nextjs/       # Next.js templates\n│   │   └── typescript/   # TypeScript utility templates\n│   └── status/           # Session status tracking\n├── .cursor/              # Cursor editor configuration\n│   └── rules/            # MCP rules for the Cursor editor\n│       ├── go.mcp        # Go language rules\n│       ├── docker.mcp    # Docker containerization rules\n│       └── dagger.mcp    # Dagger CI/CD rules\n└── README.md             # Project documentation\n```\n\n## 🔧 Advanced Features\n\n### Model Context Protocol (MCP)\n\nThe Model Context Protocol provides specialized rules for AI interactions with different technologies:\n\n- **Cursor MCP Rules**: Optimized for Go, Dagger, and Docker development\n  ```\n  // Example Go MCP rule\n  @rule go_error_handling {\n    context: \"error handling pattern in Go\",\n    pattern: \"if err != nil { return nil, err }\",\n    explanation: \"Standard Go error handling pattern\"\n  }\n  ```\n\n- **Docker MCP Rules**: Best practices for Docker containerization\n  ```\n  // Example Docker MCP rule\n  @rule docker_multistage {\n    context: \"multi-stage Docker builds\",\n    pattern: \"FROM ... AS builder\\n...\\nFROM ...\\nCOPY --from=builder\",\n    explanation: \"Use multi-stage builds to reduce image size\"\n  }\n  ```\n\n### AI Plugins\n\n- **v0.dev Integration**: Generate React components from screenshots and natural language\n  ```bash\n  # Generate a component from description\n  cat .ai/plugins/v0/examples/navbar.md | curl -X POST https://v0.dev/api/generate\n  ```\n\n- **Replicate Models Integration**: Access specialized AI models for various tasks\n  ```bash\n  # Use Replicate for image generation\n  source .ai/plugins/replicate/setup.sh\n  replicate-run stability-ai/sdxl \"A futuristic city with flying cars\"\n  ```\n\n### Integration Capabilities\n\n- **GitHub Actions**: Automate workflows with AI-enhanced GitHub Actions\n- **Hugging Face**: Connect to specialized AI models for domain-specific tasks\n- **LangChain**: Build advanced AI applications with the LangChain framework\n\n## 🛠️ Customization\n\n### Creating Custom Rules\n\nYou can create custom MCP rules for your specific technology stack:\n\n1. Create a new rule file in `.ai/rules/custom/`\n2. Define your rules using the MCP syntax\n3. Reference your rules in your AI sessions\n\nExample custom rule:\n```\n// .ai/rules/custom/my-framework.mcp\n@rule my_framework_pattern {\n  context: \"recommended pattern for MyFramework\",\n  pattern: \"...\",\n  explanation: \"...\"\n}\n```\n\n### Extending Blueprints\n\nCreate custom blueprints for your organization's preferred architectures:\n\n1. Create a new directory in `.ai/blueprints/`\n2. Add README.md with overview and purpose\n3. Create step-by-step implementation guides\n4. Include code examples and configuration templates\n\n## 👥 Contributing\n\nWe welcome contributions to improve the DotAI Boiler framework! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n6. Add a changelog entry with your contribution\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- [Cursor](https://cursor.sh/) - The AI-native code editor\n- [OpenAI](https://openai.com/) - For advancements in AI assistance\n- [Anthropic](https://www.anthropic.com/) - For Claude's helpful capabilities\n- [All contributors](https://github.com/helloprkr/dotai_boiler/graphs/contributors) who have helped shape this framework\n\n## 📊 Project Status\n\nDotAI Boiler is in active development. We're constantly improving the framework based on real-world usage and feedback. Check the [GitHub repository](https://github.com/helloprkr/dotai_boiler) for the latest updates.\n\nCurrent version: `0.6.0-beta`\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**DotAI Boiler** — Elevating development workflows with artificial intelligence\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/helloprkr/dotai_boiler/stargazers\"\u003e⭐ Star us on GitHub\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelloprkr%2Fdotai_boiler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelloprkr%2Fdotai_boiler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelloprkr%2Fdotai_boiler/lists"}