docs: convert negative patterns to positive actionable instructions #10

Merged

clawdie merged 2 commits from docs/positive-language-rewrite into main

2026-06-21 14:19:23 +02:00

Author	SHA1	Message	Date
Sam & Claude	7e787c4c3b	docs: define hermes-bsd role vs Colibri in Clawdie collective Some checks failed Contributor Attribution Check / check-attribution (pull_request) Has been cancelled Details History Check / check-common-ancestor (pull_request) Has been cancelled Details Nix / nix (macos-latest) (pull_request) Has been cancelled Details Nix / nix (ubuntu-latest) (pull_request) Has been cancelled Details Typecheck / typecheck (apps/shared) (pull_request) Has been cancelled Details Supply Chain Audit / changes (pull_request) Has been cancelled Details Typecheck / typecheck (apps/bootstrap-installer) (pull_request) Has been cancelled Details Typecheck / typecheck (apps/desktop) (pull_request) Has been cancelled Details Typecheck / typecheck (ui-tui) (pull_request) Has been cancelled Details Typecheck / typecheck (web) (pull_request) Has been cancelled Details Supply Chain Audit / Scan PR for critical supply chain risks (pull_request) Has been cancelled Details Supply Chain Audit / Check PyPI dependency upper bounds (pull_request) Has been cancelled Details hermes-bsd = agent harness (what you talk to) Colibri = control plane (what supervises) Connected via glasspane + MCP bridge; no duplication.	2026-06-21 14:16:43 +02:00
Sam & Claude	4a1073847e	docs: convert negative patterns to positive actionable instructions Some checks failed Typecheck / typecheck (apps/shared) (pull_request) Has been cancelled Details Contributor Attribution Check / check-attribution (pull_request) Has been cancelled Details History Check / check-common-ancestor (pull_request) Has been cancelled Details Nix / nix (macos-latest) (pull_request) Has been cancelled Details Nix / nix (ubuntu-latest) (pull_request) Has been cancelled Details Typecheck / typecheck (ui-tui) (pull_request) Has been cancelled Details Supply Chain Audit / changes (pull_request) Has been cancelled Details Typecheck / typecheck (apps/bootstrap-installer) (pull_request) Has been cancelled Details Typecheck / typecheck (apps/desktop) (pull_request) Has been cancelled Details Typecheck / typecheck (web) (pull_request) Has been cancelled Details Supply Chain Audit / Scan PR for critical supply chain risks (pull_request) Has been cancelled Details Supply Chain Audit / Check PyPI dependency upper bounds (pull_request) Has been cancelled Details Rewrite 'do not X' / 'never Y' / 'avoid Z' / 'cannot W' patterns across documentation files into positive 'do ABC to achieve XYZ' instructions. Files changed: - AGENTS.md (180 lines): 30+ patterns converted including caching, profiles, known pitfalls, testing, change-detector tests - CONTRIBUTING.md (50 lines): 14+ patterns including memory providers, cross-platform rules, skill authoring, security - README-FreeBSD.md: operator-user instructions - apps/desktop/DESIGN.md (49 lines): 12 design constraint patterns - docs/observability/README.md: 4 observer contract patterns Hard safety invariants preserved: - Secrets never in logs → 'Keep secrets out of logs. Redact from log output' - Tests never write to ~/.hermes → 'Use _isolate_hermes_home fixture' - Prompt cache never broken → 'Past context stays immutable mid-conversation'	2026-06-21 13:24:20 +02:00