Agent skill
clean-code-hard-limits-zero-tolerance
Sub-skill of clean-code: Hard Limits (Zero-Tolerance).
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/workspace-hub/clean-code/hard-limits-zero-tolerance
SKILL.md
Hard Limits (Zero-Tolerance)
Hard Limits (Zero-Tolerance)
| Metric | Hard Limit | Target | Action When Exceeded |
|---|---|---|---|
| File length | 400 lines | 200 lines | Split by responsibility |
| Function length | 50 lines | 20–30 lines | Extract helpers |
| Class public methods | 10 methods | 5–7 methods | Extract sub-classes or use composition |
| Nesting depth | 4 levels | 2 levels | Extract guard clauses or sub-functions |
| Import count per file | 20 imports | 10–12 imports | Sign of a God Object — split the file |
Exception 1 — Legacy solver: Low-churn files with full test coverage may remain until a
dedicated refactor WRK is approved. Document with # noqa: clean-code at the top of the file.
Exception 2 — Pure declarative data: Files whose content is ≥95% frozen dataclass/dict
literals with zero logic (no conditionals, no I/O, no imports from sibling modules) are exempt
from the 400L limit. The logic module that consumes them must still be ≤400L.
Example: activity_definitions.py (1,419L) — 14 return Activity(...) builder functions.
Test: if every function body is a single return SomeDataclass(...), it is a data file, not a
God Object.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
vamseeachanta/workspace-hub
gsd-complete-milestone
Archive completed milestone and prepare for next version
vamseeachanta/workspace-hub
gsd-reapply-patches
Reapply local modifications after a GSD update
vamseeachanta/workspace-hub
gsd-verify-work
Validate built features through conversational UAT
vamseeachanta/workspace-hub
gsd-thread
Manage persistent context threads for cross-session work
vamseeachanta/workspace-hub
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
vamseeachanta/workspace-hub
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?