feat(SCOPONE-0010): vendor agent assets and clean docs
This commit is contained in:
36
.github/skills/simplify-code/APPENDIX.md
vendored
Normal file
36
.github/skills/simplify-code/APPENDIX.md
vendored
Normal 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`.
|
||||
Reference in New Issue
Block a user