feat(aidd-context): a stale memory fact has neither a marker nor a trigger

Offen
#942 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Anfängerfreundlichkeit
68/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
javascript
Bereich
tooling

Rechercherichtung

Start with memory-rules.md, the 03-check flow, and scripts/check-context-reference-form.js; inspect how the memory files are selected and how existing format checks report failures. Add the volatility rule and the numeric/date-claim check, then verify that claims without derivation markers are flagged while valid memory content and existing checks remain green.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Problem to solve

The rule already exists, in two places:

Flag each of these, with a reason and a location:

  • A claim the code contradicts, or that has gone stale.
    — plugins/aidd-context/skills/02-project-memory/references/review-protocol.md

Reflects the current state only: no unused section, no placeholder.
— memory-rules.md

So this is not a missing rule. What is missing is that nothing marks which facts are the
kind that go stale, and nothing runs the review often enough to catch one before it is cited.

Two specifics, both in the current tree:

  • memory-rules.md has exactly one volatility rule — "Names a tech without its version
    (React, not React 19)"
    — and it covers versions only. A count, a file total, a date, a
    "currently N branches" line is the same class of fact and has no rule.
  • 03-check step 1 matches the bank against memory-destinations.md and structure.md; the
    review in step 2 is what catches a stale claim, and it runs when a human asks for it. Between
    two runs, any agent may cite the stale line, and the citation will be faithful.

Observed on a project I run AIDD on. aidd_docs/memory/vcs.md recorded, on 2026-09-29:

The project has no branch convention yet. All 41 commits sit directly on main, unpushed.
This is a fact, not a rule.

The repository held 134 commits with 0 unpushed at the moment the line was written, and 137
with 1 unpushed when I looked. Both numbers were wrong when written. The session report that
produced the file repeats it and labels it "Vrai fact, consigné comme tel dans memory/vcs.md".
Its own section "Méthode — ce qui a failli mentir" lists six measurement near-misses that were
caught and re-derived; this one was not among them.

An agent then read the file, cited it verbatim, and was right about what the file said and wrong
about the repository. Nothing in the chain can tell the difference: update_memory.js emits
references and never reads content, check-context-reference-form.js reads TARGET_FILES from
the writer itself, and both are green.

Proposed solution

Two changes, both small, neither a verification pipeline.

  1. A volatility rule in memory-rules.md, in the spirit of the existing version rule: a
    memory line that states a count, a total, a date or a size carries the date it was derived on,
    or is written so it stays true without one. "One local branch, main" holds; "41 commits,
    unpushed" does not.
  2. A check, in the shape of scripts/check-context-reference-form.js, that reads the memory
    files and flags a numeric or dated claim with no derivation marker. It judges format only — it
    does not try to decide whether the number is true, because a script that guessed truth would be
    worse than no check.

I am deliberately not proposing that memory be re-derived on read. memory-rules.md wants
"the macro and the non-derivable", and a memory file that is cheap to re-derive was the wrong file.

Content type

  • Rule
  • Other — the accompanying script check

Target tool(s)

  • Other — no tool involved; aidd-context writes and checks the bank.

Additional context

  • Adjacent, not the same, and I checked the bodies rather than the titles. #864 audits code
    conformance against project Rules and states in its own scope that it must not depend on
    aidd-context, because "aidd-dev evaluates code conformance; aidd-context owns Rule content
    and context health"
    . This is a aidd-context question about the bank's own content. #793
    audits context architecture and ownership; #887 is about when the check loop should stop.
  • The precedent for the shape of the answer is #751. There, the rule existed and a machine
    drifted back into the wrong form; the fix restored it and added the check that notices when it
    drifts back
    . That is the standard I am aiming at, and why I am proposing a marker plus a check
    rather than another paragraph of doctrine.
  • Disclosure, because it cuts against me. The false fact is mine, in my own repository, written
    while following the framework's rules and missed by the report section whose whole purpose is
    catching exactly this. I have corrected the file and the report. I file this because the
    discipline failed, not because the author did.
  • I am not asking for a PR to be opened pre-emptively. Per CONTRIBUTING.md an issue is validated
    first — a Certified Member or Maintainer moves it to Todo — and after that anyone may pick it up,
    including me.
Vorherrschende Sprache
TypeScript
Sterne
481
Forks
45
Ø Merge
1 T. 13 Std.
Gemergte PRs (30 T.)
91

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus ai-driven-dev/framework

Alle Issues in ai-driven-dev/framework

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.