Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

sanctum

Git and workspace operations for active development workflows.

Overview

Sanctum handles the practical side of development: commits, PRs, documentation updates, and version management. It’s the plugin you’ll use most during active coding.

Installation

/plugin install sanctum@claude-night-market

Skills

SkillDescriptionWhen to Use
git-workspace-reviewPreflight repo state analysisBefore any git operation
file-analysisCodebase structure mappingUnderstanding project layout
commit-messagesConventional commit generationAfter staging changes
pr-prepPR preparation with quality gatesBefore creating PRs
pr-reviewPR analysis and feedbackReviewing others’ PRs
doc-consolidationMerge ephemeral docsConsolidating LLM-generated docs
doc-updatesDocumentation maintenanceSyncing docs with code
test-updatesTest generation and enhancementMaintaining test suites
update-readmeREADME modernizationRefreshing project entry points
version-updatesVersion bumpingManaging semantic versions
workflow-improvementWorkflow retrospectivesImproving development processes
tutorial-updatesTutorial maintenanceKeeping tutorials current

Commands

CommandDescription
/git-catchupGit repository catchup
/commit-msgDraft conventional commit message
/prPrepare PR with quality gates
/pr-reviewEnhanced PR review
/fix-prAddress PR review comments
/do-issueFix GitHub issues systematically
/fix-workflowImprove recent workflow
/merge-docsConsolidate ephemeral docs
/update-docsUpdate documentation
/update-pluginsAudit and sync plugin.json registrations
/update-readmeModernize README
/update-testsMaintain tests
/update-tutorialUpdate tutorial content
/update-versionBump versions
/update-dependenciesUpdate project dependencies
/create-tagCreate git tags for releases
/resolve-threadsResolve PR review threads

Agents

AgentDescription
git-workspace-agentRepository state analysis
commit-agentCommit message generation
pr-agentPR preparation specialist
workflow-recreate-agentWorkflow slice reconstruction
workflow-improvement-*Workflow improvement pipeline
dependency-updaterDependency version management

Hooks

HookTypeDescription
post_implementation_policy.pySessionStartRequires docs/tests/readme updates
verify_workflow_complete.pyStopVerifies workflow completion
session_complete_notify.pyStopToast notification when awaiting input

Usage Examples

Pre-Commit Workflow

# Stage changes
git add -p

# Review workspace
Skill(sanctum:git-workspace-review)

# Generate commit message
Skill(sanctum:commit-messages)

# Apply
git commit -m "<generated message>"

PR Preparation

# Run quality checks first
make fmt && make lint && make test

# Prepare PR
/pr

# Creates:
# - Summary
# - Change list
# - Testing checklist
# - Quality gate results

Fix PR Review Comments

/fix-pr

# Claude will:
# 1. Read PR comments
# 2. Triage by priority
# 3. Implement fixes
# 4. Resolve threads on GitHub

Fix GitHub Issue

/do-issue 42

# Uses subagent-driven-development:
# 1. Analyze issue
# 2. Create plan
# 3. Implement fix
# 4. Test
# 5. Prepare PR

Skill Dependencies

Most sanctum skills depend on git-workspace-review:

git-workspace-review (foundation)
├── commit-messages
├── pr-prep
├── doc-updates
├── update-readme
└── version-updates

file-analysis (standalone)

Always run git-workspace-review first to establish context.

TodoWrite Integration

git-review:repo-confirmed
git-review:status-overview
git-review:diff-stat
git-review:diff-details
pr-prep:workspace-reviewed
pr-prep:quality-gates
pr-prep:changes-summarized
pr-prep:testing-documented
pr-prep:pr-drafted

Workflow Patterns

Pre-Commit

git add -p
Skill(sanctum:git-workspace-review)
Skill(sanctum:commit-messages)

Pre-PR

make fmt && make lint && make test
Skill(sanctum:git-workspace-review)
Skill(sanctum:pr-prep)

Post-Review

/fix-pr
# Implements fixes, resolves threads

Release

Skill(sanctum:git-workspace-review)
Skill(sanctum:version-updates)
Skill(sanctum:doc-updates)
git commit && git tag

Superpowers Integration

CommandEnhancement
/prUses receiving-code-review for validation
/pr-reviewUses receiving-code-review for analysis
/fix-prUses receiving-code-review for resolution
/do-issueUses multiple superpowers for full workflow
  • imbue: Provides review scaffolding sanctum uses
  • pensive: Code review complements sanctum’s git operations