Skip to content

Commit 0c40901

Browse files
committed
docs(codex): add over-engineering and root-cause guidance to AGENTS.md
- avoid speculative abstractions and generalization beyond task scope - require fixing root causes instead of applying quick workarounds
1 parent d187ad3 commit 0c40901

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

chezmoi/dot_codex/AGENTS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@
99
- Avoid `any` and minimize type assertions with `as`.
1010
- Prefer non-destructive operations for arrays and objects.
1111
- Prefer `const` over `let` unless reassignment is required.
12+
- Avoid speculative abstractions, configuration options, or generalization beyond what the current task requires. Prefer the simplest solution that satisfies the stated requirement over one that anticipates hypothetical future needs.
13+
- Fix the root cause, not the symptom. Avoid workarounds such as suppressing errors, catching and ignoring exceptions, or hardcoding special cases to make a failure disappear without resolving the underlying issue.
1214

1315
## Verification
1416

0 commit comments

Comments
 (0)