DGS Review Agent

A highly scalable, multi-platform AI code review agent system powered by the Agent-Assistant Matrix Architecture.

This agent automatically reviews your code changes (git diff) against rigorous predefined checklists (Backend, Frontend, and Security) before you open a Pull Request.

Features

• Context-Aware Reviews: Automatically extracts your current git diff to ensure the AI evaluates only the code you actually wrote.
• Multi-Platform Support: Works seamlessly with Cursor, Windsurf, Claude Code, GitHub Copilot, and Antigravity.
• Matrix Architecture: Agent skills are dynamically injected based on their profile, ensuring lean and accurate context windows.
• Strict Adherence: AI is instructed strictly to map findings directly to your official organizational checklists.

🚀 Installation

We prioritize the git clone installation method to keep your internal checklists secure and avoid public NPM registries if preferred.

Method 1: Secure Git Clone (Recommended)

This method clones the agent directly into a hidden folder in your project and wires up the configuration.

cd your-target-project
git clone [email protected]:locbm9x/dgs-review-agent.git .dgs-review

# Install it for your specific AI tool
bash .dgs-review/cli/install.sh --target . --tool cursor

Method 2: Via NPM

Bạn có thể cài đặt theo 2 cách thông qua NPM:

Tùy chọn A: Cài đặt Local (Dự án độc lập)

npm install @locbm9x/dgs-review-agent --save-dev
npx dgs-review-agent install --tool cursor

Tùy chọn B: Cài đặt Global (Khuyên dùng nếu bạn cấu hình nhiều dự án)

npm install -g @locbm9x/dgs-review-agent
dgs-review-agent install --tool cursor

Supported Tools:

• --tool cursor → .cursor/rules/dgs-review.mdc
• --tool windsurf → .windsurf/rules/dgs-review.md
• --tool antigravity → .antigravity/workflows/dgs-review.md
• --tool copilot → Inject vào .github/copilot-instructions.md
• --tool claude-code → Inject vào CLAUDE.md
• --tool codex → Inject vào AGENTS.md

🛠 Usage

The primary way to trigger the agent is using slash commands, but each AI tool supports natural language triggers as well.

1. Cursor

Open Cursor Chat (Cmd+L / Ctrl+L) or Composer (Cmd+I / Ctrl+I) and type:

• /dgs-review
• @code-reviewer review these changes
• "Review my current git diff against the checklists"

2. Windsurf

Open Cascades and type:

• /dgs-review
• @code-reviewer review my staged changes
• "Run the DGS code review on my recent code"

3. GitHub Copilot

Open Copilot Chat in your IDE and type:

• @workspace /dgs-review
• "Review my staged changes against the project checklists"

4. Claude Code

In your terminal, run claude and type:

• /dgs-review
• "Read my git diff and run a full code review based on CLAUDE.md guidelines"

5. Antigravity & Codex

Simply trigger the command in your agent interface:

• /dgs-review

Scoped Reviews & Specialized Audits

You can always pass a scope or context to focus the AI on specific files or logic:

• /dgs-review "Focus exclusively on the JWT authentication flow"

If you want a pure security audit without the standard backend/frontend checklists:

• /dgs-security
• /dgs-security "Check the new file upload endpoint for vulnerabilities"

How it works under the hood

1. Command Triggered: The /dgs-review command tells the AI to begin the review workflow.
2. Context Hunt: The git-context-hunter skill runs git status and git diff to capture your staged/unstaged changes.
3. Agent Sub-routines: The code-reviewer agent reads the diff and delegates to the backend-reviewer, frontend-reviewer, and sec-reviewer.
4. Report: The AI generates a structured, easy-to-read Markdown report with Pass/Warn/Fail metrics mapped to checklist IDs.

👉 Architecture Deep Dive: View the Detailed Workflow Sequence Diagram for a step-by-step breakdown of how files and skills interact.

🗑 Uninstallation

Need to remove the agent from your project?

bash .dgs-review/cli/uninstall.sh --target .

(Or npx dgs-review-agent uninstall if installed via NPM).

Maintained by Techtus - Code less, Review better.