Solid Guard
Testing & Qualitysolid-guardSolid Guard is an Agent Skill for testing & quality published in the abbaye/WpfHexEditorIDE repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
INTERNAL DEV WORKFLOW for WpfHexEditor — Claude self-invokes after creating new C# files OR adding >50 lines to existing classes (especially under Services/, Managers/, *Manager.cs, *Service.cs). Heuristics that CORRELATE with SOLID violations: SRP (mixed UI+IO concerns, classes >300 lines + >15 public methods), OCP (massive switch statements >10 cases), DIP (newing services instead of injecting, static singleton mutation), ISP (fat interfaces, NotImplementedException stubs). LSP is out of scope (impossible to detect mechanically). All findings are ADVISORY (warn-only). Skip on: Tests/, Samples/, *.Designer.cs, *.g.cs.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/abbaye/WpfHexEditorIDE/blob/HEAD/Sources/.claude/skills/solid-guard/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/solid-guard, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
solid-guard (internal)
ADVISORY only. Heuristics that correlate with SOLID violations — not formal proofs. False positives are expected.
When I invoke
| Situation | Run? |
|---|---|
New .cs file, edit adds >50 lines, edit under Services//Managers//*Manager.cs/*Service.cs | yes |
Tests/, Samples/, *.Designer.cs, *.g.cs, comment/rename only | no |
Pipeline
scripts/solid-scan.ps1 -Files <paths> → SOLID: <summary> or OK + per-issue lines.
6 heuristics (all warn-only)
| Rule | Detected via | Letter |
|---|---|---|
srp-mixed-concerns | class touches System.IO/File.* AND System.Windows.* | S |
srp-class-too-broad | class >300 lines AND >15 public methods | S |
ocp-massive-switch | switch with >10 cases on a type/enum | O |
dip-newing-services | new XService(/new XManager( outside a Factory | D |
dip-static-deps | <Type>.Instance.<Member> = … (mutable singleton write) | D |
isp-fat-interface | interface >10 members OR NotImplementedException stubs | I |
LSP omitted — requires Roslyn semantic analysis. Full heuristic detail: references/solid-heuristics.md.
Suppressions
// solid-ok: <reason> silences a rule on that line. Auto-exempt: *Factory* files from dip-newing-services; *FileWatcher*/*FileMonitor* from srp-mixed-concerns.
Legitimate firing patterns:
| Rule | Legitimate case | Annotation |
|---|---|---|
srp-mixed-concerns | *Adapter.cs bridges IO→UI Dispatcher | // solid-ok: bridge adapter |
dip-newing-services | composition root (App.xaml.cs, *Module.cs) | rename to *Factory or annotate |
ocp-massive-switch | closed dispatch in parser/interpreter | // solid-ok: closed enum dispatch |
Output
SOLID: 1 srp-mixed-concerns, 2 dip-newing-services, 1 isp-fat-interface
FileMonitorService.cs:1 srp-mixed-concerns uses File.* AND System.Windows.Threading
CodeAnalysisRunner.cs:42 dip-newing-services new RoslynDiagnosticsCollector() — inject?
IDocumentService.cs:14 isp-fat-interface 14 members (consider splitting)
Maintenance
New heuristic → row in references/solid-heuristics.md + extend $rules in solid-scan.ps1.