Skip to content

docs: engineering system — binding test & docs Definition of Done#197

Merged
omercelikdev merged 1 commit into
mainfrom
docs/engineering-system
Jul 26, 2026
Merged

docs: engineering system — binding test & docs Definition of Done#197
omercelikdev merged 1 commit into
mainfrom
docs/engineering-system

Conversation

@omercelikdev

Copy link
Copy Markdown
Owner

Makes the working discipline standing repo policy instead of conversation memory:

  • CLAUDE.md §3a (tests): every change ships with the test layers it touches, written and run by the author — unit, wire, differential (oracle), real-client, Stryker mutation (survivors analyzed), in-browser UI verification, edge-case sweep.
  • CLAUDE.md §3b (docs): roadmap/parity/ADR/README/CLAUDE.md and the docs website repo update in the same change; English-only for every artifact.
  • docs/testing.md: the full strategy — layers, commands, the edge-case checklist, per-vertical exit criteria.
  • README aligned (message mocking headline + links).
  • Two pre-release sweep findings codified as permanent tests (OTP digit boundaries; unicode attachment name over real SMTP).

🤖 Generated with Claude Code

…trategy

Establishes the standing discipline every session (human or AI) must
follow, so it never depends on conversation memory:

- CLAUDE.md §3a: tests are part of every change — written AND run by
  the author (unit, wire, differential, real-client, mutation with
  survivor analysis, in-browser UI verification, edge-case sweep);
  green CI is confirmation, not discovery
- CLAUDE.md §3b: documentation is part of every change — roadmap,
  parity, ADRs, README, CLAUDE.md itself, AND the docs website repo
  (a user-facing change the website does not document is unfinished);
  everything committed anywhere is English only
- docs/testing.md: the full strategy — the seven layers, when each is
  required, how to run them, the edge-case checklist, and what every
  vertical must leave behind
- README: message mocking joins the headline capabilities; docs-site
  messages link; testing-strategy link
- codified two edge cases from the pre-release sweep as permanent
  tests: OTP digit boundaries (4 and 8 match; 3 and 12 must not) and
  a unicode attachment filename round-tripping through real SMTP

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@omercelikdev
omercelikdev merged commit 5d0eae5 into main Jul 26, 2026
3 checks passed
@omercelikdev
omercelikdev deleted the docs/engineering-system branch July 26, 2026 22:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant