OpenMoneta Dev Kit

Biến Cursor IDE / OpenCode / Claude Code / Codex thành một team developer hoàn chỉnh với quy trình 6 bước (Lean Mode), adaptive planning, hooks enforcement, token-aware doc routing và sub-agents on-demand.

Cài đặt nhanh (npm)

npm install -g openmoneta-dev-kit && openmoneta install

1 lệnh cài cho cả Cursor + OpenCode. Dùng Claude Code? Cài thêm openmoneta install --claude. Dùng Codex? Cài thêm openmoneta install --codex (sau đó trust hooks qua /hooks). Sau đó khởi tạo project:

cd /path/to/project
openmoneta init
openmoneta init --claude   # nếu dùng Claude Code (tạo shim CLAUDE.md)
openmoneta init --codex    # nếu dùng Codex (không cần shim — đọc AGENTS.md natively)

| Lệnh mới | Tương đương lệnh cũ | |---|---| | openmoneta install | install.sh + install-opencode.sh | | openmoneta install --claude | install-claude-code.sh | | openmoneta install --codex | install-codex.sh | | openmoneta init | init-project.sh . | | openmoneta check | update.sh --check | | openmoneta update --yes | update.sh --yes | | openmoneta uninstall | uninstall.sh |

Khởi tạo project

cd /path/to/project
openmoneta init

Update

openmoneta update              # global + sync project hiện tại
openmoneta update --yes        # auto-sync, skip nếu đã latest
openmoneta check               # chỉ kiểm tra version mới
openmoneta docs                # audit module README thiếu/lỗi thời + sync INDEX

Cài đặt thủ công (git clone)

Dành cho máy không có Node.js hoặc muốn tự quản lý:

git clone https://github.com/rapperkey/OpenMoneta-Dev-Kit ~/OpenMoneta-Dev-Kit
bash ~/OpenMoneta-Dev-Kit/install.sh

Có gì trong này?

• 11 skills (4 core + 1 core conditional + 6 on-demand) — phân tích yêu cầu, thiết kế module, plan, systematic debugging, safe push, test, security, bảo trì docs
• openmoneta docs — audit module README thiếu/lỗi thời (stale) + skill docs-maintenance backfill docs cho dự án cũ
• 4 sub-agents — 1 core + 3 on-demand (security-auditor, qa-autonomous, ui-tester)
• 4 hooks + plugin + adapter — enforce token-aware reading, adaptive plan scope, và verify cuối phiên (module README + close plan); OpenCode đạt parity qua plugin guard session.idle, Claude Code + Codex qua hook adapter mỏng tái dùng bash hooks gốc
• Token Routing — bảng map keyword → module giúp AI giảm 70-90% token đọc
• npm package — npm install -g openmoneta-dev-kit, không cần git, không cần clone
• Auto-update check — notify khi có version mới (cache 24h)
• Adaptive Planning — task nhỏ không cần plan; task lớn/rủi ro tạo plan Draft, user review
• Safe Push — sync remote trước push, không đè code người khác
• OpenCode Support — global rules/skills/agents + plugin guard
• Claude Code Support — hook adapter + manifest install vào ~/.claude/ (không đụng skills/agents riêng của user) + shim CLAUDE.md → @AGENTS.md (docs/12-claude-code.md)
• Codex Support — hook adapter (plan gate qua apply_patch, Stop block cứng) + manifest 2-home (~/.codex/ + ~/.agents/skills/) + health-check chống "hooks chết im lặng" do trust model (docs/13-codex.md)

Đóng góp

Xem docs/09-customize-va-dong-gop.md:

• Quy trình PR.
• Thêm skill / sub-agent / hook / template.
• Bumping version + CHANGELOG.

Liên hệ

• Issues: GitHub repo của tổ chức.
• Slack: #openmoneta-dev-kit.
• Maintainer: .

License

MIT (xem LICENSE).