Skip to content

feat(framework): fw-4.17.0 — emergent-observation design meta-pattern#160

Merged
montfort merged 1 commit into
mainfrom
feat/fw-4.17.0-emergent-observation-design
May 16, 2026
Merged

feat(framework): fw-4.17.0 — emergent-observation design meta-pattern#160
montfort merged 1 commit into
mainfrom
feat/fw-4.17.0-emergent-observation-design

Conversation

@montfort
Copy link
Copy Markdown
Contributor

Summary

Motivation

Issue #150#156 documented how a Sentinel agent surfaced spec-drift across 7 Charters without trigger and without operator request. The pattern was empirically reproducible. fw-4.16.0 codified one application of this behaviour (Pattern 1: pre-declare SpecKit refresh). This PR codifies the meta: the property of the framework's documentation aparatus that produces emergent observations across multiple application axes — so that:

  1. Framework evolution preserves the property deliberately (anti-patterns section calls out what regresses it).
  2. Adopters have vocabulary to recognize the pattern when they experience it.
  3. Future application axes (MCARD/SBOM/ADR/Constitution) can be canonicalized via the same upstream-acceptance flow.

The N=1-domain caveat (Principle #12) is declared explicitly in the new doc. Graduation to v1 awaits a second domain validating an additional axis.

Test plan

  • Cross-link integrity: `grep -rln EMERGENT-OBSERVATION-DESIGN dist/ docs/ CHANGELOG.md` returns all 20 expected files (3 new + 17 cross-linkers, including STRAYMARK.md and CHANGELOG.md).
  • i18n header-count parity: EN/ES/zh-CN of the new doc all have 14 headers (`grep -c '^##\|^# '`).
  • Footer fw-4.17.0 present in all three language variants of the new doc and in all bumped governance footers.
  • No leftover `v4.16.2` / `v4.15.0` references in governance docs (the lone `fw-4.16.2 / cli-3.14.1` mention in `STRAYMARK.md` line 470 is historical/provenance text and intentional).
  • `dist/dist-manifest.yml` reads `version: "4.17.0"` — required by `release-framework.yml` tag-version gate.
  • Manual reading pass of EN canonical doc as if onboarding fresh — confirms doc explains why the emergent behaviour arises and what to preserve.
  • Post-merge: tag `fw-4.17.0` on `main` HEAD and push (CI does the rest).
  • Post-merge: open follow-up RFC issue tracking the four open application axes (MCARD/SBOM/ADR/Constitution) with N=1-domain caveat per Principle feat: add devtrail repair command to restore broken structure #12.

🤖 Generated with Claude Code

Names the design property of StrayMark that produced Sentinel's spec-drift
observation (#150#156): formal cross-referencing composed with cultural
permission to surface. Adds canonical doc EMERGENT-OBSERVATION-DESIGN.md
(EN/ES/zh-CN), new Principle #8 in PRINCIPLES.md, and an expanded §6
"Be Proactive" in AGENT-RULES.md with the meta wired into adjacent docs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@montfort montfort merged commit 68cd86c into main May 16, 2026
1 check passed
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