Skip to content

README rewrite, artifact-choice rule, DRIFT.md, release 0.8.0 - #12

Merged
emafriedrich merged 5 commits into
mainfrom
readme-rewrite
Sep 30, 2026
Merged

emafriedrich merged 5 commits into
mainfrom
readme-rewrite

Conversation

@emafriedrich

@emafriedrich emafriedrich commented Sep 30, 2026 •

Copy link
Copy Markdown
Owner
  • AGENTS.md (and the installer's framework-owned section) gains "Choosing the artifact": Decision Record when the request is clear, RFC with open questions when anything is ambiguous (stop, never assume), Spec anchored to the promoted decision for rich behavior. KDE-RFC-014 and DR-019 accepted; installer test asserts the rule reaches adopters verbatim; KDE-PROMPT-001 carries it.
  • DRIFT.md names the problem the drift gate exists for, both directions and both speeds (between tasks, and inside one saturated session), plus what the gate does not catch. README gains "Why knowledge drifts"; ADOPTING, HANDBOOK and AGENTS.md link it.
  • KDE-RFC-015 drafted: re-anchor agents in-session by returning the domain manifest on code edits. Pending review.
  • LICENSE (MIT); "Honest limits" no longer claims per-author reporting of no-behavior-change.
  • examples/marketplace declares its two current specs; CONTEXT.md regenerated; README notes the in-place edit of MP-DR-034.
  • "In the field" moved from the old README to ADOPTING.md; HANDBOOK#artifacts anchor; README "Minimal adoption"; the KDE acronym replaced in user-facing prose.
  • 0.8.0: install.sh downloads its own release tag (DEFAULT_REF), overridable with KDE_VERSION; curl one-liners point at v0.8.0. The tag is local and must be pushed after merge.
  • npm test 66/66, knowledge:check and knowledge:context --check pass.

…elease 0.8.0

- AGENTS.md and the installer's framework-owned section gain "Choosing the
  artifact": decision when the request is clear, RFC with open questions when
  anything is ambiguous (stop, never assume), spec anchored to the promoted
  decision when behavior has many rules. KDE-RFC-014 and DR-019 drafted by the
  agent, pending promotion; KDE-PROMPT-001 carries the rule; install test
  asserts the section reaches adopters.
- LICENSE (MIT). README "Honest limits" no longer claims per-author reporting
  of no-behavior-change.
- examples/marketplace: catalog declares its two current specs, CONTEXT.md
  regenerated; README notes the in-place edit of MP-DR-034.
- "In the field" moved from the old README to ADOPTING.md; HANDBOOK
  "Artifact Responsibilities" renamed "Artifacts" for the README anchor.
- README "Minimal adoption" subsection; the KDE acronym replaced in
  user-facing prose of README, ADOPTING and HANDBOOK.
- 0.8.0: install.sh downloads the release it belongs to (DEFAULT_REF),
  overridable with KDE_VERSION (KDE_REF still honoured); curl one-liners
  point at v0.8.0.
…ons and both speeds

README gains a "Why knowledge drifts" section and links the CI bullet to it;
ADOPTING, HANDBOOK and the AGENTS.md method map point at DRIFT.md, which
states what the gate catches and what it does not (reflex declarations,
unmapped code, spec-only domains, wrong-direction edits, drift inside a
session before the PR exists).
@emafriedrich
emafriedrich merged commit 6ec4954 into main Sep 30, 2026
1 check passed
emafriedrich added a commit that referenced this pull request Sep 30, 2026
README rewrite, artifact-choice rule, DRIFT.md, release 0.8.0
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