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

Aperta
#942 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
68/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
javascript
Ambito
tooling

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.
Lingua principale
TypeScript
Stelle
481
Fork
45
Merge medio
1g 13h
PR unite (30g)
91

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ai-driven-dev/framework

Tutte le issue di ai-driven-dev/framework

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.