sim-xia/blind-auditor

"Code -> audit -> amend -> audit again -> pass."
Blind Auditor is a **mandatory code auditing system** built on the MCP (Model Context Protocol). It uses a unique **"Thinking Isolation"** mechanism to force AI Agents to enter an independent "audit phase" and self-review their code before outputting the final result.
🧠 Core Philosophy: Thinking Isolation
Traditional AI coding is often "generate and output," which allows errors and biases to slip through. Blind Auditor introduces a middle layer:
1. **Intercept**: When the Agent wants to output code, it must first submit it to Blind Auditor.
2. **Isolate**: Blind Auditor does not return the result immediately. Instead, it injects a **mandatory system instruction**, forcing the Agent to pause its current persona and switch to a "Ruthless Auditor" role.
3. **Audit**: In this isolated context, the Agent must scan the generated code line by line against the predefined rules.json.
4. **Release**: The code is unlocked and returned to the user only when the audit score meets the threshold (default > 80) and there are no Critical issues.
🎯 Key Features
- **🛡️ Zero Trust Architecture**: Default distrust of the Agent's initial draft; it must pass an audit.
- **💰 Zero Extra Cost**: Reuses the host IDE's current session model, requiring no additional API Key.
- **⚖️ Bias Removal**: Forces a perspective switch via Prompt injection to break generation inertia.
- **📏 Strict Compliance**: Hard-codes team code standards (rules.json) into the generation process, which is more effective than simple Prompts.
- **🔄 Auto-Fix Loop**: Automatically triggers a "fix-resubmit" loop upon audit failure until compliance is met or the maximum retry count is reached.
---
🚀 Quick Start
1. Prerequisites
This project requires Python 3.10+ and uv.
2. Configure Audit Rules (rules.json)
Create or edit rules.json in the project root. This is the auditor's "Rulebook".
**Configuration Fields**:
- severity:
- CRITICAL: Fatal error. If found, the audit fails immediately. Usually carries a high penalty.
- WARNING: Warning. Moderate penalty; accumulation can lead to failure.
- PREFERENCE: Style preference. Low penalty.
- weight: The penalty points deducted when this rule is violated (Total score: 100).
3. Configure IDE (Antigravity / Cursor / Windsurf)
Step A: Add System Prompt (Critical)
To ensure the Agent knows it must use this tool, add the following instruction to your .cursorrules or IDE System Prompt settings:
Step B: Configure MCP Server
Add the following to your MCP client configuration file (e.g., claude_desktop_config.json or IDE settings):
**Note**: Replace /path/to/your/blind-auditor with the actual absolute path where you cloned this repository.
---
🔧 Tool Details
1. submit_draft
Submit a code draft.
- **Input**: code (content), language (programming language)