Skip to content

v1.6.0 — /context-report pre-empts committee-recurring findings

Choose a tag to compare

@mmaripanguec mmaripanguec released this 25 Jul 19:39
· 3 commits to main since this release
591aec4

Changed — /context-report skill & documentation standard

Lessons distilled from generating several application context reports, encoded so future runs clear the review committee on the first pass:

  • Valid CML — declare every context used in a relation (incl. external systems), keep the upstream/downstream direction right, one downstream strategy per upstream (ACL or Conformist, not both).
  • ADRs as decision atoms — Context, Options considered with trade-offs, Decision, Consequences; outcome-only prose fails.
  • Given/When/Then verifiable quality scenarios with anchor + RED/AMBER/green verdict.
  • Cross-document count reconciliation — two authoritative docs must never contradict each other on the same seal; reconcile or fix.
  • Complete Annex A inventories — promise N, list N.
  • Honest severity calibration — a parametrized query with a constant-bounded table name is a mitigated smell, not a critical injection; reward calibration, reject both alarmism and omission.

Documentation standard (§5 ADR) gains a Common pitfalls note naming the three most frequent failures.

Fully generic — no example-stack or client/domain references. All 7 self-test suites green (178 asserts).