revise-belief

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

1. Identify the topic phrase (short, memorable; becomes the slug)
2. Identify the new position in 1-3 sentences
3. Identify the cause — what changed their mind. Cause is required; the audit log refuses entries without one.
4. 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.