Agentic Software Engineering · Architecture

Kiến trúc Agentic SE

gmind là Agent Memory Layer — tầng trung tâm kết nối Agentic Coding Expert, GSAFe 6.0 Workflow, Codebase, và LLM. Mọi ngữ cảnh đều đi qua gmind trước khi đến AI Agent.

Sơ đồ Kiến trúc Tổng thể

Luồng Agentic Software Engineering

👨‍💻

Agentic Coding Expert

Human Developer

Ra yêu cầu, phê duyệt kết quả, quyết định kiến trúc. Giữ quyền L3 Approval tại mọi ranh giới giai đoạn.

↑│↓
⚡

Agentic IDE

Cursor · Windsurf · Kilo Code

Giao diện coding tích hợp AI Agent. IDE gửi yêu cầu tới Agent, Agent gọi gmind để lấy ngữ cảnh trước khi sinh code.

↑│↓
🔄

AgenticSE GSAFe 6.0 Workflow

CE → PI Planning → Execution → Verification

Quy trình phát triển phần mềm có cấu trúc: Spike Research → PRD → Plan → Task Decomposition → Code → CI/CD Gate. Nguyên tắc Bốn Mắt và Escalation 5 cấp.

↑│↓
🧠

gmind — Agent Memory Layer

Context Gateway · Knowledge Graph · Universal Tracking

Tầng trung tâm: thu thập, tổng hợp, và tối ưu ngữ cảnh từ toàn bộ hệ thống. Agent chỉ cần gọi gmind — không truy cập trực tiếp bất kỳ nguồn dữ liệu nào.

gmind search-codebasegmind contextgmind tracegmind coveragegmind gapsgmind impactgmind escalate
↑│↓
💾

Codebase & Storage

  • ›FrankenSQLite — State SSOT (MVCC)
  • ›Zvec — Semantic Search (Docs/Chat)
  • ›FastCode — AST Code Intelligence
  • ›Git + GitHub — VCS & CI/CD
  • ›JSONL — Git-synced backup
←── gmind queries ──→
↑│↓
🤖

LLM Providers

  • ›Gemini 3 Pro — Primary reasoning
  • ›Claude 4 — Code generation
  • ›GPT-4.1 — Specialized tasks
  • ›Routing: gmind tối ưu prompt & context window
  • ›Token optimization: TOON format nén 40%
Sơ đồ Kiến trúc Chi tiết

Gmind — Agent Memory Layer

gmind là tầng trung tâm kết nối Coding IDE, LLM, GitHub, Vector Search (Zvec), GraphRAG (FastCode), và Beads (FrankenSQLite). Mọi luồng dữ liệu đều đi qua gmind.

Mũi tên chuyển động thể hiện hướng luồng dữ liệu thực tế trong hệ thống.

Gmind Architecture Diagram
Monorepo Đa ngôn ngữ

Cấu trúc Thư mục

Go (go.work) · Rust (Cargo.toml) · TypeScript (pnpm-workspace.yaml). Điều phối bởi Turborepo.

cli/ — gmind Context Layer

gmind/ Go CLI (Cổng Ngữ cảnh) · beads_rust/ Issue Tracker (Rust) · mcp_mail/ Agent Coordination

apps/ — Ứng dụng Web

website/ Showcase Next.js (Vercel) · webui/ PM Dashboard (RTM, SAFe views)

packages/ — Thư viện Chia sẻ

design-system/ UI Tokens · fastcode/ AST Engine · core-types/ Shared DTOs

/gmind/
├── cli/ ⬡ Middle Layer
│   ├── gmind/ // Go Context Gateway
│   ├── beads_rust/ // Rust Issue Tracker
│   └── mcp_mail/ // Agent Coordination
├── apps/
│   ├── website/ // Showcase (Vercel)
│   └── webui/ // PM Dashboard
├── packages/
│   ├── design-system/ // Shared UI
│   ├── fastcode/ // AST Engine
│   └── core-types/ // Shared DTOs
├── .agents/
│   ├── skills/ // 30+ Agent Skills
│   └── workflows/ // GSafe Workflows
└── docs/
    ├── PRDs/ // 6 PRDs (core-gmind)
    └── researches/ // 16 Spikes
Theo dõi Phổ quát

Beads-ID: Chiếc Chìa Khoá Duy Nhất

Beads-ID (br-xxx / bd-xxx) là Nút Đồ thị Phổ quát — Khoá Chính xuyên suốt mọi lớp và mọi nguồn dữ liệu.

📋

Mục PRD

br-prd01-s4.2

YAML front matter

📐

Phần tử Kế hoạch

br-plan-42

satisfies → PRD

✅

Task / Issue

bd-x1y2

implements → Kế hoạch

💾

Git Commit

Beads-ID: trailer

committed-for → Task

💬

Chat / Cuộc họp

thread_id

discussed-in → Task

🔀

Pull Request

gh pr search

pr-for → Task

Mục PRD      ←──satisfies──  Phần tử KH   ←──implements──  Task      ←──Beads-ID──  Commit
(br-prd02-s1)                (br-plan-01)                  (bd-a1b2)                (git log)