chore: add 17 operational rules and rule index

- Create .claude/rules/ with all 17 standard rule files (01-security through 17-document-imports)
- Add Operational Rules section with Rule Index to .claude/CLAUDE.md
This commit is contained in:
Hibryda 2026-03-05 23:14:34 +01:00
parent afc5a7f895
commit b659a6a6bd
18 changed files with 373 additions and 0 deletions

View file

@ -0,0 +1,32 @@
---
paths:
- "src/**/*.{ts,js,py,go,rs,dart,kt,java}"
- "lib/**/*.{ts,js,py,go,rs,dart,kt,java}"
- "**/*.env*"
- "**/config.*"
- "**/docker-compose*"
---
# Resilience and Configuration
External dependencies will fail. Configuration must be externalized.
## Resilience
- Every external call must have a **timeout**. No indefinite waits.
- **Critical** deps: fail visibly, return error. **Non-critical**: log, serve cached/default, degrade gracefully.
- **Circuit breakers** for repeatedly failing deps. Exponential backoff.
- **Retries**: bounded, exponential backoff + jitter, idempotent operations only. Non-idempotent mutations require an idempotency key.
- Make degradation **visible**: log it, expose in health check.
- **Health checks**: verify actual dependency connectivity, not just "process running."
## Configuration
- Externalize all config. Document every knob: purpose, default, valid range, environments.
- Sensible defaults — runnable with zero config for local dev.
- Maintain `.env.example` with all variables and descriptions.
- Validate required config at startup — fail fast. Log effective config (secrets masked).
## Graceful Shutdown
- Stop accepting new requests, drain in-flight work, release resources (12-Factor IX).