bicameral-sync

Run bicameral.link_commit and evaluate pending compliance checks to write reflected or drifted verdicts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/BicameralAI/bicameral-mcp --skill bicameral-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bicameral-sync
Source: https://github.com/BicameralAI/bicameral-mcp/tree/main/skills/bicameral-sync
Command: npx skills add https://github.com/BicameralAI/bicameral-mcp --skill bicameral-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Full ledger sync after a git COMMIT — runs bicameral.link_commit then evaluates pending compliance checks to write reflected/drifted verdicts. ONLY for post-commit ledger sync. DO NOT trigger for "update", "upgrade", or "new version" requests — those belong to /bicameral:update (binary upgrade). Trigger on: PostToolUse hook "bicameral: new commit detected", _sync_guidance in any tool response, or explicit "sync", "check compliance", or reflect this commit".

Core Features & Use Cases

  • Sync HEAD by running bicameral.link_commit to compute hash-level drift for the new commit.
  • Resolve pending compliance checks by reading the code region, comparing the decision description against the code, and batching all verdicts into a single bicameral.resolve_compliance call.
  • After resolution, report a summary such as Synced <short_hash>: N reflected · N drifted · N pending.

Quick Start

After a commit, run the bicameral-sync operation to complete the ledger by evaluating changed regions and writing verdicts.

Frequently Asked Questions about bicameral-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a decision ledger after a git commit?

Sync a decision ledger after a git commit by running bicameral.link_commit to compute hash-level drift, then evaluating pending compliance checks against changed code regions to batch reflected or drifted verdicts into a final summary.

What is decision ledger drift detection in post-commit workflows?

Decision ledger drift detection in post-commit workflows is the process of comparing changed code regions against stored decisions to determine if a commit reflects or drifts from the original compliance requirements, producing a verdict with content_hash guards.

When should I run a compliance check sync versus a binary upgrade?

Run a compliance check sync after new commits, merges, or rebases to evaluate pending checks against changed regions. Do not run it for update, upgrade, or new version requests, as those binary upgrade scenarios require a different process.

How do I evaluate pending compliance checks after merging or rebasing?

Evaluate pending compliance checks after merging or rebasing by reading the changed code regions, comparing the decision descriptions against the code, and batching all verdicts into a single resolve_compliance call to report a final summary.

Does bicameral-sync support rebases and merges for ledger compliance checks?

Yes, bicameral-sync supports ledger compliance checks for rebases and merges. It applies to post-commit workflows by computing hash-level drift and resolving pending checks, while explicitly excluding binary upgrade scenarios.