Add verbatim Durable Knowledge and Self-Improvement section - #427
Merged
Conversation
The rule that durable guidance belongs in the committed docs, not agent memory, lived only in the preamble - a non-verbatim zone that never carries - so downstream repos lacked it and an agent wrote a fleet rule to its local memory instead of AGENTS.md. Promote it to a verbatim section so it carries to every repo, and broaden it to the full self- improvement duty: record durable lessons in the governance docs as part of the change, propose upstream where the doc is carried, fold good patterns in and design bad ones out. Remove the superseded preamble line and declare the section in files.json and section-model.md in the same change, per the add-a-section rule. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Promotes the durable-knowledge guidance from AGENTS.md preamble text into a new verbatim section so it can be carried and audited fleet-wide, and updates the spec to declare and model the new section.
Changes:
- Adds a new verbatim
## Durable Knowledge and Self-Improvementsection toAGENTS.mdand removes the superseded preamble line. - Updates
spec/files.jsonto declare the new section asverbatimunder theAGENTS.mdbaseline entry. - Updates
spec/section-model.mdto include the new section in the section-fidelity table.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| AGENTS.md | Introduces the new verbatim section and removes the prior preamble guidance line. |
| spec/files.json | Declares the new section in the baseline so audit/validate can enforce it. |
| spec/section-model.md | Records the new section's fidelity classification and rationale. |
"The repo's tracked backlog" read as ambiguous against the section's own committed-not-memory thrust - GitHub Issues are tracked but not committed. Name a committed backlog (a README.md TODO section) so the example cannot be read as an uncommitted tracker. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
ptr727
added a commit
that referenced
this pull request
Jul 25, 2026
## Promote develop to main Three governance/doc-only changes, all squashed to develop and Copilot-clean: - **#425** - Add Copilot review guidance for byte-locked carried fleet content (new `## Reviewing Carried Fleet Content` in `.github/copilot-instructions.md` + interim decline-pointer + `files.json` manifest entry). Root-cause fix for the recurring Copilot false positives PlexCleaner#880 flagged. - **#426** - Drop incidental catalog paths from verbatim AGENTS sections (restate the codegen bullet behaviorally; drop the two redundant `catalog/...` pointers). Finishes #422's genericization. - **#427** - Add verbatim `## Durable Knowledge and Self-Improvement` section (promoted from the non-carrying preamble; broadened to the self-improvement duty). Declared in `files.json` + `section-model.md`. No code or workflow changes - documentation and spec only, so no release fires on merge. ## Verification - `python3 spec/validate.py` - OK. - `python3 spec/audit.py --selftest` - PASS. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
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
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.
What
Adds a new verbatim
## Durable Knowledge and Self-Improvementsection to AGENTS.md (declared inspec/files.jsonandspec/section-model.mdin the same change), and removes the superseded preamble line.Why
The rule "durable guidance belongs in the committed docs, not agent memory" lived only in the AGENTS.md preamble - a non-verbatim zone that never carries to downstream repos. The gap showed up concretely: a fleet agent wrote a rule to its local
memory.mdinstead of proposing it into AGENTS.md, and had to be re-reminded. Promoting the rule to a verbatim section makes it carry to every repo, and broadens it to the full self-improvement duty.Changes
files.jsondeclares the sectionverbatim;section-model.mdtable gains its row - per section-model.md's "adding a section" rule, all three change together.Design: the self-improvement duty says "propose the change upstream" (behavior, not destination) so it complies with the carried-files rule; DSC-clean wording. Now 17 verbatim / 2 intent sections.
Verification
python3 spec/validate.py- OK (the new verbatim section resolves in the hub AGENTS.md).python3 spec/audit.py --selftest- PASS.Downstream copies add the section on next re-vendor, riding the wave already in flight.
🤖 Generated with Claude Code