Skip to content

Commit ae4a703

Browse files
docs(standards): add critical rule 7 — never suppress failing checks
Add a seventh critical rule to all agent shim files and update the homepage OpenClaw prompt. Never suppress failing checks — fix the root cause instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 440291d commit ae4a703

File tree

5 files changed

+13
-0
lines changed

5 files changed

+13
-0
lines changed

.cursorrules

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@ Critical Rules:
1919
6. Use the shared logging library. No raw `echo` for status messages. Use
2020
`log_info`, `log_warn`, `log_error`, `log_debug`, and `die` from
2121
`lib/log.sh`.
22+
7. Never suppress failing checks. When a lint, format, security, or test
23+
check fails, fix the underlying issue. Never comment out code, add
24+
suppression annotations, disable rules, or mark CI jobs as
25+
allowed-to-fail to bypass a failing check.
2226

2327
Quick Reference:
2428

.opencode/agents.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,10 @@ agents:
2424
6. Use the shared logging library. No raw `echo` for status messages. Use
2525
`log_info`, `log_warn`, `log_error`, `log_debug`, and `die` from
2626
`lib/log.sh`.
27+
7. Never suppress failing checks. When a lint, format, security, or test
28+
check fails, fix the underlying issue. Never comment out code, add
29+
suppression annotations, disable rules, or mark CI jobs as
30+
allowed-to-fail to bypass a failing check.
2731
2832
Quick Reference:
2933

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ See DEVELOPMENT.md for the complete reference.
1111
4. **Respect `.editorconfig`.** Never override formatting rules (indent style, line endings, trailing whitespace) without explicit instruction.
1212
5. **Write idempotent scripts.** Every script must be safe to re-run. Check before acting: `command -v tool || install_tool`, `mkdir -p`, guard file writes with existence checks.
1313
6. **Use the shared logging library.** No raw `echo` for status messages. Use `log_info`, `log_warn`, `log_error`, `log_debug`, and `die` from `lib/log.sh`.
14+
7. **Never suppress failing checks.** When a lint, format, security, or test check fails, fix the underlying issue. Never comment out code, add suppression annotations, disable rules, or mark CI jobs as allowed-to-fail to bypass a failing check.
1415

1516
## Quick Reference
1617

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ See DEVELOPMENT.md for the complete reference.
1111
4. **Respect `.editorconfig`.** Never override formatting rules (indent style, line endings, trailing whitespace) without explicit instruction.
1212
5. **Write idempotent scripts.** Every script must be safe to re-run. Check before acting: `command -v tool || install_tool`, `mkdir -p`, guard file writes with existence checks.
1313
6. **Use the shared logging library.** No raw `echo` for status messages. Use `log_info`, `log_warn`, `log_error`, `log_debug`, and `die` from `lib/log.sh`.
14+
7. **Never suppress failing checks.** When a lint, format, security, or test check fails, fix the underlying issue. Never comment out code, add suppression annotations, disable rules, or mark CI jobs as allowed-to-fail to bypass a failing check.
1415

1516
## Quick Reference
1617

content/_index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,9 @@ the retrofit guide at: https://devrail.dev/docs/getting-started/retrofit/
7070
4. Respect `.editorconfig` formatting rules.
7171
5. Write idempotent scripts. Check before acting.
7272
6. Read DEVELOPMENT.md in the repo for full standards reference.
73+
7. Never suppress failing checks. Fix the root cause, don't comment
74+
out code, add suppression annotations, or mark CI jobs as
75+
allowed-to-fail.
7376
7477
## Available Make Targets
7578
- `make lint` — run all linters

0 commit comments

Comments
 (0)