Skip to content

Commit 657f2de

Browse files
committed
Refine CLAUDE.md authoring guidelines
1 parent 7d73d6f commit 657f2de

1 file changed

Lines changed: 2 additions & 4 deletions

File tree

src/dot_claude/CLAUDE.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
- Always prefer simplicity over pathological corrections. Follow YAGNI, KISS, and DRY. No backward-compat shims or fallback paths unless they come free without adding cyclomatic complexity.
1+
- Prefer simplicity and follow YAGNI, KISS, and DRY. Do not add backward-compatibility shims or fallback paths unless required by the task or project.
22
- Favor colocation: keep related code, tests, types, and assets close to where they are used rather than splitting them into distant shared layers prematurely.
3-
- Only add comments to explain particularly unclear parts.
3+
- Add comments only when they explain non-obvious behavior, constraints, or rationale.
44
- Keep identifier names concise, but do not abbreviate English words unless the abbreviation is conventional in the target language. Respect the naming conventions of the original code.
5-
- Since the Bash tool is executed in a sandbox, file access or network connections may result in errors. In such cases, ask the user for instructions.
6-
- Reflect user corrections naturally in deliverables, without commentary about having applied them.

0 commit comments

Comments
 (0)