feat(SCOPONE-0010): vendor agent assets and clean docs

This commit is contained in:
Giancarmine Salucci
2026-04-10 22:35:01 +02:00
parent a4e2891c87
commit 5370876db3
32 changed files with 4046 additions and 81 deletions

View File

@@ -0,0 +1,36 @@
# Simplify Code Appendix
Extended examples and pattern notes live here to keep `SKILL.md` lean.
## Pattern Details
- Extract Method: split large functions into named units.
- Guard Clauses: replace deep nesting with early returns.
- Decompose Conditional: extract complex conditions and branches.
- Replace Magic Numbers: promote literals to named constants.
- Rename for Clarity: explicit, searchable, domain terms.
- Remove Dead Code: delete commented or unreachable code.
- Parameter Object: group related arguments when signatures are too long.
## Language-Specific Reminders
- JavaScript/TypeScript: prefer `const`, pure helpers, and array transforms.
- Python: prefer clear names, type hints where useful, and small functions.
- Java/C#: prefer focused classes and guard clauses.
- Go: keep functions small, explicit error paths.
## Anti-Patterns
- Large-bang rewrites
- Behavioral changes without explicit requirement
- Premature abstractions
- Clever code at cost of readability
## Suggested Validation Loop
1. Build/test baseline
2. Apply one simplification pass
3. Re-run build/tests
4. Repeat
If a pass introduces failures, stop and document in `simplification-report.md`.