Commonweal's memory is shared infrastructure. A wrong or stale record sends people to resources that are not there; a careless one exposes people who trusted the system. Keep it accurate, minimal and consented.
The format is in memory/README.md.
Before you write
Ask yourself:
- Is it worth keeping? Would it help someone after this conversation ends? If it only matters right now, don't save it.
- Is it a flow or a person? Record offers, needs, knowledge and decisions. Record facts about a person only under
people/and only with consent. - Did they agree? For anything about a person, community, offer or need, you need clear consent covering what is recorded and who may see it. If you are unsure, ask: "Can I add this to the shared records so others can find it? Here is exactly what I'd write."
- Is anything forbidden? Never store passwords, tokens, government IDs, bank or card details, health information or exact home addresses. Use an area or neighbourhood instead of an address.
- Does it already exist? Search
memory/first. Update an existing memory rather than making a duplicate.
Writing
- Copy the matching template from
memory/_templates/. - Fill every required field.
sourceandrecordedare never blank. - Write the body in plain words, one fact or record per file.
- Link related memories with
[[name]]. - Add one line to
memory/MEMORY.mdunder the right heading. - Tell the person what you saved and where.
Checking for staleness
- An
offerorneedpast itsexpiresdate is unconfirmed. Before relying on it, ask the person or group whether it still holds, then updaterecordedandexpires, or remove it. - When you tell anyone about a record, give its
recordeddate so they can judge how fresh it is.
When someone asks what you know about them
Search all of memory/ for their name, handle and any group they have named. Show them every matching record in full. Offer to correct or delete any of it.
Forgetting
When someone asks to be forgotten:
- Delete every memory that is about them.
- Remove their name and contact details from any shared record that mentions them (for example a community file), keeping the rest of that record.
- Remove the deleted memories from
memory/MEMORY.md. - Tell them exactly what you removed.
- Do not ask why, and do not keep a copy.
Note that git keeps old versions. If someone needs their data removed from history too, flag it for the maintainers through an issue that does not repeat the personal data, so they can rewrite history.
Correcting mistakes
If you find a memory is wrong, fix it, update recorded and say in the body what changed. If the mistake could have misled someone, add a system memory describing what went wrong and how to avoid it.
This is a snapshot of the public Commonweal brain, dated 2026-10-28. The original document remains the source of record.
Read the exact source on GitHub ↗