required_canon_version: >=3.0.0

Skill: commit-ceremony

Version: 0.1.0

Status: Active

Purpose

Orchestrates the pre-commit ceremony workflow by running failsafe checks (critic.py and contract runner) and returning a checklist with staged files. This ensures all governance requirements are met before committing changes.

Trigger

Use when:

• •Preparing to commit changes
• •Validating that the repository is ready for a commit
• •Running the "Chunked Commit Ceremony" workflow

Inputs

JSON object with optional fields:

• •dry_run (boolean, optional): If true, returns mock data for deterministic testing

For deterministic testing (dry_run mode), additional fields:

• •_mock_critic_passed (boolean): Mock critic result
• •_mock_runner_passed (boolean): Mock runner result
• •_mock_staged_files (array of strings): Mock staged files list
• •_mock_git_status (string): Mock git status output

Outputs

JSON object with ceremony checklist:

• •checklist (object):
  • •1_failsafe_critic (object): Critic check result with passed, tool, output
  • •2_failsafe_runner (object): Contract runner result with passed, tool, output
  • •3_files_staged (boolean): Whether any files are staged
  • •4_ready_for_commit (boolean): All checks passed and files staged
• •staged_files (array): List of staged file paths
• •staged_count (integer): Number of staged files
• •git_status (string): Short git status output
• •ceremony_prompt (string): Human-readable prompt for next steps

Constraints

• •Read-only for governance checks
• •Requires git to be installed
• •Runs TOOLS/governance/critic.py
• •Runs LAW/CONTRACTS/runner.py

Implementation

1. •Runs critic.py to check governance compliance
2. •Runs contract runner to verify fixtures
3. •Gets staged files via git diff --cached
4. •Gets git status
5. •Compiles checklist and ceremony prompt

Fixtures

• •fixtures/basic/ - Deterministic test with mocked values

required_canon_version: >=3.0.0