basicmachines-co/basic-memory

memory-ci-capture

Synthesize GitHub delivery context into a concise Basic Memory project update.

View source
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Memory CI Capture

Turn a meaningful GitHub delivery moment into project memory. GitHub records the mechanics. Basic Memory remembers what changed and why.

Inputs

Read the ProjectUpdateContext JSON produced by bm ci collect at .github/basic-memory/project-update-context.json. Treat it as the immutable source of truth for repository, event type, PR number, workflow run, SHA, source URL, timestamps, and deployment environment.

Do not invent tests, deploy checks, linked issues, product impact, or decisions. If evidence is absent, say so briefly in verification or leave the field empty.

Output

Return only JSON matching the AgentSynthesis shape:

json
{
  "summary": "What changed.",
  "why_it_matters": "Why this update matters for future humans and agents.",
  "user_facing_changes": [],
  "internal_changes": [],
  "verification": [],
  "follow_ups": [],
  "decision_candidates": [],
  "task_candidates": []
}

Synthesis Rules

  • Prefer a short explanation over a commit-by-commit changelog.
  • Preserve intent, changed behavior, source links, verification evidence present

in the context, and concrete follow-ups.

  • Put explicit product or architecture decisions in decision_candidates only

when the source context clearly contains them.

  • Put future work in task_candidates only when it is concrete enough to act on.
  • Keep the tone factual and useful. This is project memory, not marketing copy.

Event Guidance

For merged pull requests, focus on why the PR existed, what area changed, what issues it advanced or closed, and what verification evidence appears in the context.

For production deploys, focus on what reached production, the deployed SHA, environment, workflow run, and verification evidence. Do not overclaim success beyond the workflow and source facts.

from this repository

More skills

All skills
basicmachines-co
Community

memory-capture

Capture the current state of a working thread or conversation into a single coherent Basic Memory note — synthesize where it landed, don't append a log. On re-capture, rewrite the same note in place instead of duplicating. Use mid-thread or end-of-thread when decisions, insights, or context are worth preserving.

installs
1
GitHub stars
4K
Updated
Sep 16
basicmachines-co
Community

memory-curate

Curate the Basic Memory knowledge graph: find orphan notes and suggest links, propose typed relations, merge duplicates, audit tags and folders, and build hub notes. Use to organize, connect, and improve a knowledge base as notes accumulate.

installs
1
GitHub stars
4K
Updated
Sep 16
basicmachines-co
Community

memory-defrag

Defragment and reorganize agent memory files: split bloated files, merge duplicates, remove stale information, and restructure the memory hierarchy. Use when memory files have grown unwieldy, contain redundancies, or need reorganization. Run periodically (weekly) or on demand.

installs
1
GitHub stars
4K
Updated
Sep 16
basicmachines-co
Community

memory-ingest

Process unstructured external input (meeting transcripts, conversation logs, pasted documents) into structured Basic Memory entities. Extracts entities, searches for existing matches, proposes new entities with approval, creates notes with observations and relations, and captures action items.

installs
1
GitHub stars
4K
Updated
Sep 16