RH

Ralf Hüsing

<Product Engineer & AI Orchestrator />

AiNetLinter

Roslyn-basierter C#-Linter für den sicheren Einsatz KI-unterstützter Entwicklungsworkflows

Was bringt AiNetLinter?

Autonome KI-Agenten (wie Cursor, Claude Code oder Antigravity) schreiben C#-Code in atemberaubendem Tempo. Doch oft entsteht nach grünen Builds ein verdecktes Problem: KI-Agenten neigen dazu, phantomhafte Abhängigkeiten einzuführen, verschachtelte Monster-Klassen zu bauen oder die Code-Komplexität so in die Höhe zu treiben, dass die KI selbst nach 3 Iterationen den Überblick verliert.

AiNetLinter ist das Leitplanken-System für KI-Agenten: Es setzt genau da an, wo Build und Tests bereits grün sind (dotnet build ✓dotnet test ✓ainetlinter). Per Roslyn-Syntaxanalyse garantiert es, dass KI-generierter Code langfristig lesbar, wartbar und token-sparend bleibt.

Problem & Lösung im Entwickler-Alltag

❌ Der Schmerz ohne AiNetLinter

  • Halluzinierte Dependencies (Agenten nutzen nicht existierende Namespaces oder unkontrollierte Reflection-Tricks).
  • Explodierende Klassen-Komplexität, die KI-Context-Windows sprengt.
  • Versteckte Qualitätsmängel in C#-Code, Razor-Views, CSS und JS.
  • Linter-Frust in riesigen Legacy-Projekten durch hunderte alte Warnungen.

✅ Der Gewinn mit AiNetLinter

  • Phantom-Dependency-Ban: Verbietet Halluzinations-Fehlerquellen in KI-generiertem Code automatisch.
  • Codebase-Landkarten & Evals: Generiert auf Knopfdruck strukturierte Markdown-Skelette (--map) oder fertige LLM-Audit-Prompts (--eval) mit frischer Evidenz.
  • AI-Context-Footprint: Misst die transitiven Codezeilen-Metriken einer Klasse – schützt direkt vor unnötiger Token-Verschwendung.
  • Baseline / Ratchet (SHA-256): Friert Altlasten ein. Schlägt in Großprojekten sofort an, prüft aber nur geänderten Code.
  • Web-Asset-Linting: Prüft neben C# auch CSS (ExCSS), JavaScript (Esprima) und Razor-Templates auf KI-Fehler.
  • Auto-Fixer & Discovery-API: KI-Agenten können das Tool per CLI explorieren (--list-rules) und Fehler automatisch reparieren (--fix).

In 3 Schritten starten

1. Starten Sie die Analyse Ihrer C#-Solution oder Ihres Source-Ordners:

ainetlinter --config rules.json --path ./src/MeinProjekt.slnx

2. Generieren Sie eine Codebase-Landkarte für Ihren KI-Agenten oder lassen Sie Verstöße reparieren:

# Codebase-Skelett für LLMs erstellen:
ainetlinter --map skeleton --path ./src/

# Triviale Verstöße automatisch beheben:
ainetlinter --config rules.json --path ./src/ --fix

3. Übergeben Sie den Pfad zur Exe Ihrem KI-Agenten – dieser kann das Tool mit ainetlinter --list-rules selbstständig erkunden und als Qualitäts-Check einsetzen.

Repository & Quellcode

AiNetLinter ist Open Source (MIT-Lizenz) und steht auf GitHub zur Verfügung:

GitHub Repository: RalfHuesing/AiNetLinter