logic

name	logic
description	Use when the user wants to start or stop recording a branch decision trail, record a decision and its rationale, or show and audit the rationale behind a branch or PR. Invoke as /logic toggle, /logic track, or /logic show. Captures decisions across concurrent worktrees, validates evidence, and can add a reviewable trail to a PR.

Logic

Keep one reviewable, append-only decision trail for a branch worked by people and agents. The trail records what was decided, why, perceived confidence, evidence, and outcome. It uses bd when available and falls back to TSV.

Use one command namespace:

/logic <command> [arguments]

Command	Use for	Read
`toggle [on	off] [branch]`	Start or stop tracking for a branch
`track " because " [--confidence high	medium	low]`
show [branch] [--pr]	Render, validate, and optionally publish a trail to its PR	references/show.md

Route the first argument to its reference. With no argument, show this command table and ask which operation is wanted. Treat an unrecognized argument as a request to show the current branch's trail.

Shared runtime

All helpers live in .agents/skills/logic/. Read references/config-schema.md only when changing tracking configuration, and references/row-format.md only when changing row semantics. Run the relevant helper rather than manually editing .logic/ state.

toggle on materializes a committed .logic/ runtime and configures Git's relative core.hooksPath. Tell the user to commit .logic/ after enabling it. The optional Claude Code Stop hook enriches meaningful commit stubs; the Git post-commit hook captures the stubs regardless.

Validation

Run bash tests/selftest.sh after changing the bundled runtime.