🚀 DevMind Enterprise AI Operating System & CLI Suite (v3.0.0)

An intelligent, developer-friendly AI Engineering Operating System & Unified CLI Tool (devmind). It unifies Everything Claude Code (ECC), Graphify Knowledge Graphs, Specialized Agent Personas, Operational Workflows, Git & Database Intelligence, Project Memory Layer, ADR Management, and Antigravity IDE MCP Integration into a single cohesive operating framework.

---

📊 Graphical System Architecture & Workflow

1. Master System Pipeline (11-Step Integration)

flowchart TD
    Start(["▶ Start: ./setup-ai-project.sh [DIR]"]) --> Step1["1. Validate Target Project Directory"]

    subgraph Phase1 ["Phase 1: System-Level Dependency & CLI Installation"]
        Step1 --> Step2{"2. Verify System Tools, DevMind CLI & ECC Repo<br/>(git, curl, python3, node, uv, graphify, devmind, ECC)"}
        Step2 -- "Missing" --> AutoInstall["Auto-Install Missing Tools & CLI to ~/.local/bin/devmind"]
        Step2 -- "Ready" --> Phase2
        AutoInstall --> Phase2
    end

    subgraph Phase2 ["Phase 2: Intelligent Stack & Context Extraction"]
        Phase2 --> Step3["3. Detect Project Stack (Laravel, CodeIgniter, Frappe, Django, Node, React, etc.)"]
        Step3 --> Step4["4. Detect Test Suite & Database Architecture"]
        Step4 --> Step5["5. Generate Intelligence Docs & Memory (.devmind/memory/, docs/adr/, DATABASE.md, ARCHITECTURE.md, SECURITY.md)"]
    end

    subgraph Phase3 ["Phase 3: Agent Framework & Rule Mapping"]
        Step5 --> Step6["6. Generate Specialized Agents (.agents/agents/)"]
        Step6 --> Step7["7. Generate Operational Workflows (.agents/workflows/)"]
        Step7 --> Step8["8. Generate Domain Rules & Symlink ECC Skills (.agents/rules/, .agents/skills/)"]
        Step8 --> Step9["9. Create Master Operating Manual (.agents/AGENTS.md)"]
    end

    subgraph Phase4 ["Phase 4: Knowledge Graph, MCP & CLI Diagnostics"]
        Step9 --> Step10["10. Build Graphify Graph & HTML Visualizer + Configure Antigravity MCP"]
        Step10 --> Step11["11. Run devmind doctor & Engineering Score (0-100%)"]
    end

    Step11 --> End(["✅ Setup Complete: DevMind CLI & AI Pair Programming Ready"])

Loading

---

2. VS Code Extension & File Impact Workflow

sequenceDiagram
    autonumber
    actor User as Developer / AI Agent
    participant VSCode as VS Code Extension
    participant CLI as DevMind CLI Engine
    participant Graphify as Graphify & AST Parser
    participant Webview as Interactive HTML Webview

    User->>VSCode: Right-Click File -> "DevMind: File Impact Analysis"
    VSCode->>CLI: Execute `devmind impact <file_path>`
    CLI->>Graphify: Query graph.json (Downstream consumers & Upstream dependencies)
    CLI-->>VSCode: Terminal output (Matched node, dependents, upstream imports)
    VSCode->>Webview: Launch `DevMindGraphWebview` with query focus
    Webview-->>User: Interactive Vis.js 2D Knowledge Graph filtered & focused on node

Loading

---

3. System Flow & Memory Loop

                     DevMind
                        │
       ┌────────────────┼────────────────┐
       │                │                │
       ▼                ▼                ▼
   Graphify          Git Intel        ADR System
       │                │                │
       │                │         ┌──────┴──────┐
       │                │         │             │
       │                │       API AI       Agent AI
       │                │         │             │
       │                │         └──────┬──────┘
       │                │                │
       └────────────────┼────────────────┘
                        ▼
                  Project Memory
                        │
                        ▼
                  AI Coding Agent

---

🎨 VS Code Extension Graphical Interface

The native DevMind VS Code Extension (devmind-vscode) integrates AI intelligence directly into your IDE layout:

+------------------------------------+--------------------------------------------------+
| VS CODE ACTIVITY BAR               | EDITOR & INTERACTIVE GRAPH WEBVIEW               |
+------------------------------------+--------------------------------------------------+
| [DevMind OS Sidebar]               |  [graphify-out/graph.html]                       |
|                                    |  +--------------------------------------------+  |
|  🩺 System Health & Score          |  | 🧠 DevMind Knowledge Graph v2.0  [Search]   |  |
|     ├── Engineering Score: 89%     |  |                                            |  |
|     ├── Run Doctor Diagnostics     |  |   (Node A) ---> [Target File] ---> (Node B) |  |
|     └── Sync AI Context            |  |                     |                      |  |
|                                    |  |                     v                      |  |
|  🧠 Project Memory                 |  |                 (Node C)                   |  |
|     ├── decisions.md               |  +--------------------------------------------+  |
|     ├── known-issues.md            |                                                  |
|     └── project-history.md         |  OUTPUT CHANNEL: [DevMind OS]                    |
|                                    |  ============================================    |
|  📜 Architecture Decisions (ADRs)  |  Target Symbol/File: setup-ai-project.sh         |
|     ├── + Create New ADR           |  Matched Node: setup-ai-project.sh               |
|     └── 001-initial-arch.md        |  Direct Consumers:                               |
|                                    |    └── setup_ai_project_build_graphify_graph    |
|  📊 Knowledge Graph & Impact       |  ============================================    |
|     ├── Graphify Index: Active     |                                                  |
|     ├── Open Interactive Graph     |                                                  |
|     └── Analyze File Impact...     |                                                  |
+------------------------------------+--------------------------------------------------+
| STATUS BAR: $(brain) DevMind: 89% (Click to run Doctor diagnostics)                  |
+---------------------------------------------------------------------------------------+

---

💻 devmind CLI Suite Command Reference

The devmind CLI tool provides full control over AI context, task planning, dependency impact, security auditing, and project memory:

Command	Description
devmind doctor	Runs 8-dimensional diagnostic suite & calculates Engineering Score (0–100%).
devmind sync	Automatically updates Graphify graph, HTML visualizer, and intelligence docs.
devmind plan "<task>"	AI Task Planner: affected modules, risk level, required database tables & tests.
devmind impact <file>	Impact Analysis: dependency resolution & downstream/upstream consumers.
devmind blame <file>	Git Intelligence: commit history, author changes, and change rationale.
devmind audit security	Security Scanner: secret detection, SQLi, XSS, OWASP checks, and security score.
devmind db analyze	Database Intelligence v2: table relationships, foreign keys, missing indexes.
devmind review	AI Code Review Bot inspecting uncommitted git diff.
devmind adr create "<title>"	Creates a new Architecture Decision Record in docs/adr/.
devmind adr list	Lists existing Architecture Decision Records.
devmind infra audit	Audits production infrastructure (Nginx, PHP-FPM, Docker, Redis, MariaDB).

---

🧠 Project Memory Layer (.devmind/memory/) & ADRs

DevMind maintains a long-term engineering memory so AI agents never repeat past mistakes:

• decisions.md: Architectural & technical design choices.
• known-issues.md: Active technical debt & known bugs.
• failed-attempts.md: Past technical approaches that failed and rationale.
• project-history.md: System evolution log.
• docs/adr/: Sequential Architecture Decision Records (e.g., 001-initial-architecture.md).

🛠️ Directory Scoping & Manual Override

You can manually scope DevMind CLI actions (like sync, diagnostics, and knowledge graphs) to specific nested sub-repositories or folders (e.g., app/mycustom_app in Frappe/monorepos). Set this via the Target Repo setting in the VS Code extension sidebar or using the devmind.selectDirectory command.

🤖 AI-Driven Automated ADR Generation

When creating an ADR (devmind adr create "<title>"), DevMind automatically drafts its contents (Context, Decision, and Consequences) using a dual-automation strategy:

1. Direct API Integration: If environment keys (GEMINI_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or ANTHROPIC_API_KEY/CLAUDE_API_KEY) are present, the CLI queries the LLM directly via a lightweight request, feeding it the relevant git diff or commit context.
2. Coding Agent Auto-Population: If no keys are set but you are working inside an AI coding agent (like Antigravity, Claude Code, or Cursor), the CLI writes a <!-- DEVMIND_PENDING_ADR_AI_POPULATION --> marker and prints a visible terminal directive. The active agent intercepts this and automatically populates the ADR contents based on the git changes.

---

🛡️ Master AI Operating Manual (.agents/AGENTS.md)

• Forbidden Actions: No committing secrets, no force-pushing, no modifying core framework files, no commenting out failing tests.
• Before Changing Code: Mandatory search, Graphify dependency check, and implementation plan creation.
• After Changing Code: Test execution, git diff review, and devmind sync.

---

📊 DevMind Engineering Score Matrix

====================================================
      DEVMIND ENGINEERING SCORE & DIAGNOSTICS      
====================================================

  AI Context       [███████████████████░] 95%
  Architecture     [██████████████████░░] 90%
  Testing          [█████████████████░░░] 85%
  Security         [██████████████████░░] 90%
  Documentation    [███████████████████░] 95%
  Database         [██████████████████░░] 90%
  Code Quality     [█████████████████░░░] 88%
  Infrastructure   [████████████████░░░░] 82%

----------------------------------------------------
  Overall DevMind Engineering Score: 89% / 100% 🎉
====================================================

---

🚀 Quick Start & Dependency Setup

1. Run Automated Setup Script

./setup-ai-project.sh /path/to/project

This automatically verifies/installs Node.js, Python 3, uv, Graphify (uv tool install "graphifyy[gemini]"), Everything Claude Code, and the devmind CLI.

2. Build & Package VS Code Extension

cd vscode-extension
npm install
npm run compile
npx @vscode/vsce package --no-dependencies

3. Install VSIX Extension in VS Code

code --install-extension devmind-vscode-1.0.0.vsix