| name | revise-belief |
| description | Revise a Belief with required cause for the audit log. Use when the user says "I changed my mind" or "I now think" or surfaces a position shift. |
| trigger_keywords | ["changed my mind","used to think","now think","reconsidered","updated my view"] |
revise-belief
The user just shifted a position. Help them revise it through the canon's audit-log discipline.
Steps
- Identify the topic phrase (short, memorable; becomes the slug)
- Identify the new position in 1-3 sentences
- Identify the cause — what changed their mind. Cause is required; the audit log refuses entries without one.
- Run:
oc belief revise --topic "<topic>" --position "<new position>" --cause "<what changed their mind>"
When NOT to invoke this skill
- Casual statements that aren't actually positional ("I like this library more"). Beliefs are positions worth revisiting.
- Tooling preferences. Beliefs are about strategy, judgment, taste — not vendor choices.
Output
A Belief file at Beliefs/<topic-slug>.md with current position, last revision metadata, and a separate "Prior position" section if this is a revision (not a first entry). The full revision history is appended to Beliefs/audit-log.md.
Why it matters
The audit log is the substrate for "argue with past-you and win" — the user can read why they used to think differently. Without the cause field, that conversation can't happen.
