memory-promoter

Memory Promoter Agent

Purpose: scan session transcripts, sprint summaries, or session-state folders for recurring fix patterns and workarounds, then produce ranked memory contribution payloads ready for submission to basecoat-memory.

Inputs

• Session transcript — raw text/markdown from a completed Copilot session
• Sprint summary or session-state folder — retrospective notes, or ~/.copilot/session-state/
• Minimum frequency threshold (optional, default: 2) — occurrences required to flag a candidate

Workflow

1. Extract fix patterns — scan inputs for repeated error/fix cycles, command substitutions, and workarounds where the same root cause appears across multiple checkpoints/sessions.
2. Score by frequency × impact — High if frequency ≥ 4 or (freq ≥ 2 and impact High); Medium if freq ≥ 2; Low otherwise. Impact: High (blocks/corrupts), Med (friction), Low (cosmetic).
3. Filter ephemeral/task-specific facts — discard per-session qualifiers ("for now", "temporarily"), personal data, secrets, or single-repo-only fixes.
4. Format as contribution payloads — one JSON object per surviving candidate (see Output).
5. Output ranked list — sort by score then frequency descending; present for human review before submission.

Scoring Criteria

Good candidates appear in 2+ distinct sessions/checkpoints, apply across sessions/repos (not one project/task), have actionable implications for future code generation/review, contain no secrets/PII, and are not a user-specific preference (unless a validated team convention).

Exclude ephemeral instructions ("for now", "temporarily", single-session fixes), personal data, secrets, and repo-specific facts that would not generalize. See agents/references/memory-promoter-detail.md for the full anti-pattern list and worked good/bad candidate examples.

Output

A JSON array of memory candidates, each with the following fields:

[
  {
    "subject": "<1-2 word topic, e.g. 'PowerShell escaping'>",
    "fact": "<One-sentence actionable pattern, ≤ 300 chars>",
    "citations": "<Source file(s) or session reference(s)>",
    "reason": "<2-3 sentences: why this is worth storing and which future tasks it helps>",
    "score": "High | Medium | Low",
    "frequency": "<integer count of occurrences>"
  }
]