MrLesk/groma.md

Public

groma.md - Your architecture as OKF Markdown in Git, and one C4 map you can walk. Scanned from source, curated by you and your agents.

agents architecture backlog backlog-md c4 c4-model cli coding-agents diagram documentation git isometri markdown okf okf-format tui

Star339 Fork23 Watch1 Mở trên GitHub

Bee AI phân tích repositoryBETA

AI đọc README và cây file để tóm tắt, gợi ý cách dùng và đánh giá repository. Mọi con số lấy từ kho Bee, không do AI ước lượng.

Cập nhật lần cuối: 15/10/2026

Đăng nhập để hỏi Bee AI

Tóm tắt bởi Bee AI

Công cụ phân tích mã nguồn và tạo bản đồ kiến trúc C4 thời gian thực, lưu trữ dưới dạng Markdown OKF ngay trong kho Git cho lập trình viên và coding agent.

Phân tích mã nguồn tĩnh cục bộ, không gửi mã lên dịch vụ AI bên ngoài và chạy hoàn toàn offline sau khi cài đặt scanner.
Lưu trữ toàn bộ kiến trúc dưới dạng tài liệu Markdown chuẩn OKF trong thư mục groma/, giúp xem và đánh giá thay đổi trực tiếp trên PR.
Cập nhật trực tiếp khi lưu tệp, hỗ trợ phác thảo kiến trúc nháp (drafts) và ghim tác vụ từ Backlog.md.
Hỗ trợ nhiều ngôn ngữ lập trình qua hệ thống plugin scanner như TypeScript, Python, Go, Rust, Java, C#/.NET, PHP và Swift.

Lưu ý

Dự án đang ở giai đoạn nguyên mẫu thử nghiệm (early prototype), có thể gặp một số lỗi chưa hoàn thiện.
Trên hệ điều hành macOS, công cụ yêu cầu phần cứng Apple Silicon.
Tệp tĩnh xuất bằng groma export chứa cả mã nguồn, cần kiểm tra cẩn thận trước khi chia sẻ công khai.

Điểm BeeTính thuần từ số liệu trong kho Bee, không phải AI chấm: bách phân vị sao 30% · độ tươi lần push 25% · fork và watcher 15% · README, giấy phép, mô tả 20% · có bản phát hành 10%.

64/100Điểm tổng thể

Độ phổ biến17
Độ tươi100
Cộng đồng23
Tài liệu100
Phát hành100

Mức độ khóTrung bình
Phù hợp vớiLập trình viên · DevOps
Loại dự ánCông cụ
Giấy phépMIT

Kiến trúc & Công nghệ

Công nghệ AI nhận ra từ README và cây file — chỉ những mục nằm trong danh sách Bee kiểm.

Tech stack

TypeScript
React
Angular
Vue.js
.NET
Go
Java
Scala
Python
Rust
PHP
Swift

Kiến trúc tổng quan

Repository → công nghệ chính → các thư mục cấp 1 có thật trong repo; vai trò do AI mô tả.

Repositorygroma.mdCông cụ

Công nghệ chính

TypeScript

src/Chứa mã nguồn chính của ứng dụng và công cụ CLI.
packages/Chứa các gói mã nguồn con trong mô hình monorepo.
plugins/Chứa các plugin quét mã nguồn (scanners) cho các ngôn ngữ.
docs/Chứa tài liệu hướng dẫn sử dụng và thông tin kỹ thuật.
examples/Chứa các ví dụ mẫu cấu hình và tích hợp.
test/Chứa các bộ kiểm thử tự động của dự án.
scripts/Chứa các tiện ích kịch bản phục vụ phát triển hoặc dựng dự án.
groma/Thư mục lưu trữ định nghĩa kiến trúc chuẩn OKF Markdown của chính dự án.

src/Chứa mã nguồn chính của ứng dụng và công cụ CLI.
packages/Chứa các gói mã nguồn con trong mô hình monorepo.
plugins/Chứa các plugin quét mã nguồn (scanners) cho các ngôn ngữ.
docs/Chứa tài liệu hướng dẫn sử dụng và thông tin kỹ thuật.
examples/Chứa các ví dụ mẫu cấu hình và tích hợp.
test/Chứa các bộ kiểm thử tự động của dự án.
scripts/Chứa các tiện ích kịch bản phục vụ phát triển hoặc dựng dự án.
groma/Thư mục lưu trữ định nghĩa kiến trúc chuẩn OKF Markdown của chính dự án.

Hướng dẫn nhanh

Các bước để bắt đầu với repository này.

bash

git clone https://github.com/MrLesk/groma.md.git
cd groma.md

Các use case chính

Những ứng dụng có thể xây dựng từ repository này.

Khám phá và điều hướng trực quan kiến trúc dự án qua giao diện web C4 tương tác từ mức hệ thống xuống thành phần mã nguồn.
Cho phép coding agent đọc hiểu kiến trúc hiện tại thông qua CLI và cập nhật quan hệ, trách nhiệm của các module.
Theo dõi sự thay đổi kiến trúc giữa các commit hoặc nhánh qua GitHub Action tự động so sánh bản đồ trước và sau.
Xuất kiến trúc, luồng quan hệ và mã nguồn thành trang web tĩnh bằng lệnh xuất chuyên dụng.

Repository tương tự

Cùng chủ đề trong kho Bee.

Nội dung do AI sinh, có thể sai hoặc thiếu — số liệu lấy từ kho Bee, không do AI ước lượng. Cập nhật lần cuối: 15/10/2026.