# helloprkr/dotai_boiler architecture

> Architecture diagram of the GitHub repository helloprkr/dotai_boiler, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/helloprkr/dotai_boiler
- Repository: https://github.com/helloprkr/dotai_boiler

## Overview

##### Project type and purpose
- DotAI Boiler is an open-source AI-assisted development framework. It provides a structured “knowledge ecosystem” for managing AI workflows, codified learnings, session state, blueprints, snippets, rules, plugins, and automation scripts to accelerate consistent, AI-driven development.

##### File structure
- Top-level directories:
- `.ai/` – core AI tooling and assets
– `actions/` – automated AI workflows
– `blueprints/` – prescriptive architecture guides (Next.js, Supabase + Drizzle, Flux-Replicate, etc.)
– `codex/` – persistent AI learnings, error logs, templates
– `components/`, `lib/`, `plugins/`, `rules/`, `scripts/`, `session/`, `snippets/`, `status/` – modular subsystems supporting AI sessions, custom rules, code patterns, and tracking
- `.cursor/` – Cursor editor-specific MCP rules
- Root files – GitHub config, top-level README, changelog, contribution guidelines
- Patterns: modular plugin/blueprint architecture, rule-driven engine (MCP), file-based session persistence

##### README for additional insights
- Architecture section outlines `.ai/` submodules
- Describes integration points: LLMs (OpenAI, Claude), v0.dev, Replicate, GitHub Actions, Hugging Face, LangChain
- Emphasizes extensibility: custom rules, custom blueprints, plugin system

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Core Tooling Layer
    subgraph "Core Tooling"
        AI_Core["AI Tooling Core"]:::core
        Actions["Actions Engine"]:::core
        Blueprints["Blueprint Library"]:::core
        Snippets["Snippets & Components"]:::core
        RuleEngine["MCP Rule Engine"]:::core
        PluginManager["Plugin Manager"]:::core
        Automation["Automation Scripts"]:::core
    end

    %% Persistence Layer
    subgraph "Persistence"
        Codex["Codex Repository"]:::persistence
        Session["Session Manager"]:::persistence
    end

    %% Editor & CI Layer
    subgraph "Editor & CI"
        Cursor["Cursor Editor"]:::editor
        Copilot["GitHub Copilot"]:::editor
        CI["CI/CD (GitHub Actions, Dagger)"]:::editor
    end

    %% External Integrations
    subgraph "External Integrations"
        LLM["LLM Providers"]:::external
        V0["v0.dev API"]:::external
        Replicate["Replicate"]:::external
        HF["Hugging Face"]:::external
    end

    %% Root Configuration
    subgraph "Root Configuration"
        README["README.md"]:::editor
        CONTRIBUTING["CONTRIBUTING.md"]:::editor
        CHANGELOG["CHANGELOG.md"]:::editor
    end

    %% Connections
    Cursor -->|requests| AI_Core
    Copilot -->|requests| AI_Core
    AI_Core -->|reads/writes| Codex
    AI_Core -->|persists state| Session
    AI_Core -->|fetches templates| Blueprints
    AI_Core -->|fetches patterns| Snippets
    PluginManager -->|calls API| LLM
    PluginManager -->|calls API| V0
    PluginManager -->|calls API| Replicate
    PluginManager -->|calls API| HF
    Automation -->|triggers| CI
    RuleEngine -->|enforces rules| AI_Core
    RuleEngine -->|enforces rules| Cursor

    %% Click Events
    click AI_Core "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/"
    click Actions "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/actions"
    click Blueprints "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/blueprints"
    click Codex "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/codex"
    click Session "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/session"
    click Snippets "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/components"
    click RuleEngine "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/rules/mcp"
    click PluginManager "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/plugins"
    click Automation "https://github.com/helloprkr/dotai_boiler/tree/main/.ai/scripts"
    click Cursor "https://github.com/helloprkr/dotai_boiler/blob/main/.cursor/rules/typescript.mcp"
    click README "https://github.com/helloprkr/dotai_boiler/blob/main/README.md"
    click CONTRIBUTING "https://github.com/helloprkr/dotai_boiler/blob/main/CONTRIBUTING.md"
    click CHANGELOG "https://github.com/helloprkr/dotai_boiler/blob/main/CHANGELOG.md"

    %% Styles
    classDef core fill:#cce5ff,stroke:#0366d6
    classDef persistence fill:#d4edda,stroke:#28a745
    classDef external fill:#ffe5b4,stroke:#ff8c00
    classDef editor fill:#e2e3e5,stroke:#6a737d
```
