feat(framework): fw-4.18.0 — Polish Charter as debt-detection pattern#200
Merged
Conversation
…closes #199) Adds a new governance pattern doc naming the "Surface declaration without wiring" anti-pattern that polish Charters (closing Charter of an Etapa / SpecKit `Polish` Phase) consistently surface against the real binary — gaps that integration tests with mock adapters (`humatest`, in-memory event buses) systematically bypass. Four generalized sub-classes: - env var documented in runbook → consumer in code - metric instrument declared → record-call site - HTML body URL → registered route - public-by-contract route → public-prefix entry Originated in #199 from the Sentinel adopter (CHARTER-19 → CHARTER-27, AIDEC-2026-05-22-001). v0 status (proven N=1); CLI crystallization (`straymark analyze declared-vs-wired`) deferred to N=2 — same gate FOLLOW-UPS-BACKLOG-PATTERN uses. Changes: - dist/.straymark/00-governance/POLISH-CHARTER-PATTERN.md (EN + es + zh-CN) - dist/.straymark/00-governance/QUICK-REFERENCE.md `## Patterns` row (EN + es + zh-CN) - dist/.straymark/templates/charter/charter-template.md: 7th `Format conventions` bullet - dist/dist-manifest.yml: 4.17.0 → 4.18.0 - CHANGELOG.md: `## Framework 4.18.0` section - Doc-version cascade across governance/adopters/READMEs Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4 tasks
montfort
added a commit
that referenced
this pull request
May 23, 2026
…/ Issue #199 / PR #200 (#201) Adds a ~2,400-word blog post covering the Polish Charter as debt-detection pattern that landed as fw-4.18.0. Reconstructs the Sentinel adopter's #199 RFC: ten latent gaps surfaced in one polish session (two of them shipped-but-never-worked features live for 10 days), names the "Surface declaration without wiring" anti-pattern, and explains the B' decision (governance pattern doc + deferred CLI helper, N=1 → N=2 gate same as FOLLOW-UPS-BACKLOG-PATTERN). EN + ES + zh-CN translations following the established per-locale conventions (ES uses ISO date + topical tag translation; zh-CN uses short date + inline tag array, English tags retained). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #199. Adopts the RFC as Option B' (modified) — new governance pattern doc + small charter-template addition, no CLI helper yet.
CLI helper (`straymark analyze declared-vs-wired`) is deferred to N=2 — same crystallization gate that `FOLLOW-UPS-BACKLOG-PATTERN.md` uses. Listed under the new doc's `## Open questions`.
Decision context posted in #199 comment.
Test plan
Release tag `fw-4.18.0` will be pushed after merge per the established workflow.
🤖 Generated with Claude Code