Skip to content

memory/general/

Long-term, topical knowledge about Justin's systems that needs to live alongside the codebase. Not a log. Not a journal. Not append-only.

What goes here

Stable, factual notes that an agent or script needs to know about the live setup and that aren't better expressed as code:

  • Integration configurations (e.g., home-assistant.md)
  • System contracts that aren't captured in the code itself
  • Topic-per-file, edited freely as reality changes

What does NOT go here

  • Logs / append-only streamsdata/ (e.g. data/inbox-notes.md)
  • Vision / narrative / personal thinking → Notion (LifeOS). Use /save-to-drive as interim if needed. See Forge vs Notion routing rule in MEMORY.md.
  • Research dumps / one-time referencesdocs/research/
  • Daily observationsmemory/daily/YYYY-MM-DD.md first; graduate here only when stable
  • Tool registrations~/.claude/projects/-home-justinwieb-forge/memory/reference_*.md + MEMORY.md index entry

Rules

  • No timestamps. No dated entries. No append-only patterns.
  • Edit freely. If something changes, update the file, don't append a correction.
  • One topic per file. Filename should match the topic (e.g. home-assistant.md).
  • Only put things here once they are definitively known and decided.

Current files

File Purpose
home-assistant.md HA integration paths: REST API + Context API HA poller.