Guairdian

Language-agnostic AI code review system for Claude Code. Works with any codebase - PHP, JavaScript, Python, Go, Rust, Java, and more.

Usage

Install

npm install -g guairdian
cd your-project
guairdian install

This installs:

• ✅ Slash commands to .claude/commands/
• ✅ Agent templates to .guairdian/templates/agents/
• ✅ Report template to .guairdian/report-template.md
• ✅ Adds .guairdian/ to .gitignore

To update existing files with latest version:

guairdian install --force

Initialize (First Time)

In Claude Code:

/guairdian-init

Detects your language/framework and generates rules (30-60 seconds).

Review Code

Make changes, then in Claude Code:

/guairdian-check

Get a report with security, architecture, and quality findings (15-30 seconds).

Improve Accuracy (Optional)

/guairdian-feedback

Mark false positives to improve accuracy from ~75% to 90%+.

How It Works

Language-Agnostic Design: No hardcoded rules for any language.

1. Initialization (/guairdian-init)

• Detects project type: composer.json → PHP, package.json → JavaScript, etc.
• Detects framework: Laravel, React, Django, etc.
• Generates language-specific rules using AI agents
• Saves to .guairdian/ (gitignored)

2. Code Review (/guairdian-check)

• Loads generated rules from .guairdian/rules/
• Runs 4 agents in parallel:
  • Security: OWASP Top 10 vulnerabilities
  • Architecture: Structure and organization
  • Quality: Best practices and maintainability
  • Project Rules: CLAUDE.md conventions
• Validates findings (filters false positives)
• Generates markdown report

3. Learning (/guairdian-feedback)

• Review findings from last check
• Mark false positives
• Extract patterns to avoid similar issues
• Update confidence scores

What Gets Generated

.guairdian/
├── project-profile.json       # Detected language, framework
├── patterns.json              # Learned conventions
├── rules/                     # Generated for your project
│   ├── security.json
│   ├── architecture.json
│   ├── quality.json
│   ├── framework.json
│   └── custom.json
├── false-positives.json
└── review-history.json

Requirements

• Node.js 18+
• Claude Code CLI
• Git repository

Example

# Install
npm install -g guairdian
cd my-project
guairdian install

# Update commands (after npm link or new version)
guairdian install --force

# In Claude Code
/guairdian-init      # One-time setup
/guairdian-check     # Review changes
/guairdian-feedback  # Mark false positives

License

MIT License - see LICENSE file.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions