Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

docs(rules): clarify 800-line review ceiling

Suliman Abdulrazzaq60e27fe51e7c
diff --git a/rules/common/code-review.md b/rules/common/code-review.md
index d79ba9bf0..9ca1454ed 100644
--- a/rules/common/code-review.md
+++ b/rules/common/code-review.md
@@ -28,7 +28,7 @@ Before marking code complete:
- [ ] Code is readable and well-named
- [ ] Functions are focused (<50 lines)
-- [ ] Files are cohesive (<800 lines)
+- [ ] Source files are cohesive (under the 800-line soft maintainability ceiling, or include a reason for a deliberate exception)
- [ ] No deep nesting (>4 levels)
- [ ] Errors are handled explicitly
- [ ] No hardcoded secrets or credentials
@@ -54,7 +54,7 @@ Before marking code complete:
|-------|---------|--------|
| CRITICAL | Security vulnerability or data loss risk | **BLOCK** - Must fix before merge |
| HIGH | Bug or significant quality issue | **WARN** - Should fix before merge |
-| MEDIUM | Maintainability concern | **INFO** - Consider fixing |
+| MEDIUM | Maintainability concern, including an unexplained source file over the soft 800-line ceiling | **INFO** - Consider fixing |
| LOW | Style or minor suggestion | **NOTE** - Optional |
## Agent Usage
diff --git a/rules/common/coding-style.md b/rules/common/coding-style.md
index e72f3f119..9ab495508 100644
--- a/rules/common/coding-style.md
+++ b/rules/common/coding-style.md
@@ -36,7 +36,8 @@ Rationale: Immutable data prevents hidden side effects, makes debugging easier,
MANY SMALL FILES > FEW LARGE FILES:
- High cohesion, low coupling
-- 200-400 lines typical, 800 max
+- 200-400 lines typical, with 800 lines as a soft maintainability ceiling for source files
+- Test, generated, and vendored files may exceed the ceiling when their size is justified by their role
- Extract utilities from large modules
- Organize by feature/domain, not by type