Skip to content

[instructions] Split experimental ledger docs out of memory.md - #67685

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
instructions-janitor-memory-ledger-sync-04d1a520dd119e85
Open

github-actions[bot] wants to merge 1 commit into
mainfrom
instructions-janitor-memory-ledger-sync-04d1a520dd119e85

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Instructions Janitor: sync memory/ledger docs

Scope: reviewed every commit touching .github/aw/ and docs/ since the last
instructions-janitor sync (eca67cf, #67162) through the current .github/aw-touching
tip (9ded002, #67488). The latest published release is v0.89.21 (2026-09-23); this repo
has had several incremental instruction syncs since then, so this pass picks up from the
last one rather than re-reviewing the full release window.

Files reviewed:

Size audit

.github/aw/memory.md had grown to 407 lines (over the 400-line cap) after #67439 added
JSON-schema validation docs. Fix: extracted the self-contained "standalone ledger
(experimental)" section into a new .github/aw/ledger.md (68 lines), leaving a short
pointer in memory.md (now 359 lines) and updating the memory-stateful-patterns.md
cross-reference to link ledger.md directly instead of an in-file anchor.

.github/aw/debug-agentic-workflow.md is also over the cap (432 lines) after #67488
added the "Model and engine misconfiguration" checklist. I initially extracted that
section too, but reverted it: .github/skills/agentic-workflows/tests/test_guidance.py
is a regression test (added by the same PR) that requires the full checklist text to
stay inline in debug-agentic-workflow.md and mirrored in root debug.md. Splitting it
would break that contract, so this file is left as a documented exception to the
400-line target.

Before/after line counts for edited files:

File Before After
.github/aw/memory.md 407 359
.github/aw/ledger.md — 68 (new)
.github/aw/memory-stateful-patterns.md 141 141
.github/aw/debug-agentic-workflow.md 432 432 (unchanged, documented exception)

Duplication audit

No new duplication found; the ledger split removes the only duplicated ledger content
(previously inline in memory.md and cross-referenced from memory-stateful-patterns.md).

Verification

  • Confirmed debug-agentic-workflow.md has a zero diff against main (git diff empty),
    so the test_guidance.py regression contract is unaffected.
  • Re-ran the full .github/aw/*.md size audit (wc -l); only the documented exception
    above remains over 400 lines.

Generated by 🧹 Instructions Janitor · claude · sonnet50 · 328.4 AIC · ⌖ 21 AIC · ⊞ 6.3K · ◷

  • expires on Oct 13, 2026, 12:52 AM UTC-08:00

memory.md had grown to 407 lines, over the 400-line instruction-file
cap, after recent repo-memory JSON-schema-validation changes (#67439).
Extract the self-contained "standalone ledger (experimental)" section
into a new ledger.md, replacing it with a short pointer. Update the
cross-reference in memory-stateful-patterns.md to link directly to
ledger.md instead of an anchor inside memory.md.

debug-agentic-workflow.md is also over the cap (432 lines) after
recent model/engine-misconfiguration diagnostics (#67488), but its
checklist content is pinned inline by a regression test
(.github/skills/agentic-workflows/tests/test_guidance.py) that also
requires it mirrored in root debug.md, so it is left as a documented
exception rather than split.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation instructions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants