OpenParable
Skip to content
← Back to skills

Solid Guard

Testing & Quality
solid-guard

Solid 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

SituationRun?
New .cs file, edit adds >50 lines, edit under Services//Managers//*Manager.cs/*Service.csyes
Tests/, Samples/, *.Designer.cs, *.g.cs, comment/rename onlyno

Pipeline

scripts/solid-scan.ps1 -Files <paths> → SOLID: <summary> or OK + per-issue lines.

6 heuristics (all warn-only)

RuleDetected viaLetter
srp-mixed-concernsclass touches System.IO/File.* AND System.Windows.*S
srp-class-too-broadclass >300 lines AND >15 public methodsS
ocp-massive-switchswitch with >10 cases on a type/enumO
dip-newing-servicesnew XService(/new XManager( outside a FactoryD
dip-static-deps<Type>.Instance.<Member> = … (mutable singleton write)D
isp-fat-interfaceinterface >10 members OR NotImplementedException stubsI

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:

RuleLegitimate caseAnnotation
srp-mixed-concerns*Adapter.cs bridges IO→UI Dispatcher// solid-ok: bridge adapter
dip-newing-servicescomposition root (App.xaml.cs, *Module.cs)rename to *Factory or annotate
ocp-massive-switchclosed 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.