deepseek-harness/docs/rfc
Tianyi Cui 4dafad4db6 Add RFCs for the remaining quality-proposal ideas
Eight proposals grouped by category, each with problem statement,
concrete plan, and risks: property-based testing over the
protocol-shaped core (chunk streams, event logs, schema DSL);
mutation testing as the counterweight to the 100%-coverage gate;
deterministic tests + a universal replay-invariant fixture + nightly
race stress; architectural conformance (dependency-cruiser rules and
the LlmAdapter conformance kit); runtime arg validation at the model
boundary with a structured error taxonomy and dev-mode invariants;
doc-sync enforcement (typechecked doc snippets, API reports);
supply-chain checks and nightly vendor-drift verification against the
manifest; and deep-readonly public surfaces (logged-vs-in-flight
mutability boundary). AGENTS.md points at docs/adr and docs/rfc.
2026-06-11 15:27:07 +08:00
..
001-property-based-testing.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
002-mutation-testing.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
003-deterministic-and-stress-testing.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
004-architectural-conformance.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
005-runtime-validation-and-error-taxonomy.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
006-doc-sync-and-api-reports.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
007-supply-chain-and-vendor-drift.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
008-immutable-public-surfaces.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00
README.md Add RFCs for the remaining quality-proposal ideas 2026-06-11 15:27:07 +08:00

RFCs

Proposals for substantial future work — reviewed before implementation, unlike ADRs (which record decisions already made). Each RFC groups a related set of ideas from the quality/robustness proposal (2026-06-11); statuses move proposed → accepted → implemented (then usually graduate to an ADR).

# Title Status
001 Property-based testing for protocol-shaped code proposed
002 Mutation testing as the coverage counterweight proposed
003 Deterministic tests + replay invariant fixture + race stress proposed
004 Architectural rules: dependency-cruiser, adapter conformance kit proposed
005 Runtime arg validation, structured error taxonomy, dev-mode invariants proposed
006 Doc-sync enforcement and API extractor reports proposed
007 Supply chain checks and vendor drift verification proposed
008 Deep-readonly public surfaces proposed