sanctum

Stage changes, generate conventional commit message, commit, and push to current branch. One-shot git add-commit-push.

Draft a Conventional Commit message for staged changes. Analyzes diffs, classifies change type, and formats scope/body.

Create git tags for releases from merged PRs or explicit version arguments. Triggers post-tag submission workflows.

Implement issues (GitHub/GitLab/Bitbucket) using progressive analyze-specify-plan-implement workflow

Command options, configuration, and best practices.

> **Navigation**: [← Main Workflow](../workflow-steps.md) | [Step 2: Triage →](2-triage.md)

> **Navigation**: [← Step 1: Analyze](1-analyze.md) | [Main Workflow](../workflow-steps.md) | [Step 3: Plan →](3-plan.md)

> **Navigation**: [← Step 2: Triage](2-triage.md) | [Main Workflow](../workflow-steps.md) | [Step 4: Fix →](4-fix.md)

> **Navigation**: [← Step 3: Plan](3-plan.md) | [Main Workflow](../workflow-steps.md) | [Step 5: Validate →](5-validate.md)

> **Navigation**: [← Step 4: Fix](4-fix.md) | [Main Workflow](../workflow-steps.md) | [Step 6: Complete →](6-complete.md)

> **Navigation**: [<- Step 5: Validate](5-validate.md) | [Main Workflow](../workflow-steps.md)

> **Navigation**: [<- Reconciliation](reconciliation.md) | [Step 6 Hub](../6-complete.md) | [Next: Thread Resolution ->](thread-resolution.md)

> **Navigation**: [<- Thread Resolution](thread-resolution.md) | [Step 6 Hub](../6-complete.md) | [Next: Summary ->](summary.md)

> **Navigation**: [Step 6 Hub](../6-complete.md) | [Next: Reconciliation ->](reconciliation.md)

> **Navigation**: [<- Step 6 Hub](../6-complete.md) | [Next: Issue Creation ->](issue-creation.md)

> **Navigation**: [<- Issue Linkage](issue-linkage.md) | [Step 6 Hub](../6-complete.md) | [Next: Verification ->](verification.md)

> **Navigation**: [<- Issue Creation](issue-creation.md) | [Step 6 Hub](../6-complete.md) | [Next: Issue Linkage ->](issue-linkage.md)

> **Navigation**: [<- Summary](summary.md) | [Step 6 Hub](../6-complete.md) | [Main Workflow](../../workflow-steps.md)

Error handling, troubleshooting guide, and known issues.

Detailed step-by-step guide for fix-pr command execution.

Address PR/MR review feedback by reading comments, implementing fixes, and resolving threads. GitHub and GitLab support.

Retrospective analysis and improvement of workflow components with self-evolving patterns

Summarize recent git history since a baseline with structured analysis of what changed, why, and what to watch for.

Consolidate ephemeral LLM-generated markdown into permanent documentation.

Review pull requests with scope validation, code analysis, and line comments. Supports GitHub PRs and GitLab MRs.

Command options, configuration, best practices, and integration details.

Review classification system and scope mode details.

Enforcement checks to verify all required outputs were produced, and

Phases 1 through 4 of the review workflow: scope establishment,

Phase 5 (test plan generation) and Phase 6 (PR description update)

Detailed workflow phases, examples, and advanced features.

Prepare a PR end-to-end by updating documentation, running tests, dogfooding checks, and validating with code review.

Batch-resolve unresolved PR/MR review threads via GraphQL API (GitHub/GitLab)

Shared detection, generation, and injection logic for

Detect and fix drift between plugin.json registrations and capabilities reference documentation

Update pre-commit hooks and CI/CD workflows based on recent project changes

Scan and update dependencies across all ecosystems with conflict detection

Update project documentation with consolidation, debloating, AI slop detection, capabilities sync, and accuracy verification.

Audit and sync plugin.json registrations with actual disk contents. Detects missing or stale skills, commands, agents, hooks.

Detect outdated hook patterns after registration sync.

After registration audit completes, automatically analyze

Run meta-evaluation on evaluation-related skills to validate

Check the memory-palace research queue for items needing

Review and update test coverage using TDD/BDD methodology with quality validation. Generates tests for changed code.

Generate or update tutorials with VHS and Playwright recordings

Bump project versions using git-workspace-review and version-updates skills.

Conventional commit message generation agent specializing in change classification, semantic versioning awareness, and consistent commit formatting. Use when drafting commit messages for staged changes, classifying change types, formatting breaking change footers, linking issues in commits. Do not use when analyzing repository state - use git-workspace-agent first. preparing full PR - use pr-agent. ⚠️ PRE-INVOCATION CHECK (parent must verify BEFORE calling this agent): - Single file with <20 lines? → Parent commits directly - Obvious type (typo, version bump, deps)? → Parent uses `fix(scope): message` - Can write message in <30 seconds? → Parent commits directly ONLY invoke this agent for: multi-file changes, ambiguous classification, breaking changes, or complex scope decisions. Generates complete conventional commit messages ready for use.

Dependency analysis and update agent for multi-ecosystem repositories. Scans pyproject.toml, Cargo.toml, package.json, and go.mod files. Use when checking for outdated dependencies, updating package versions, resolving version conflicts, preparing dependency update PRs. Do not use when installing new dependencies - use ecosystem-specific tools. debugging dependency issues - analyze manually first. Provides conflict detection, compatible version resolution, and code migration assistance for breaking changes.

Git workspace analysis agent specializing in repository state assessment, file structure mapping, and change tracking. Use when preflight checks before commits/PRs/reviews, understanding repository state, mapping codebase structure, analyzing staged and unstaged changes. Do not use when generating commit messages - use commit-agent. preparing PR descriptions - use pr-agent. ⚠️ PRE-INVOCATION CHECK (parent must verify BEFORE calling this agent): - "What branch?" → Parent runs `git branch --show-current` - "Show status" → Parent runs `git status` - "What changed?" → Parent runs `git diff --stat` - Any single git command → Parent runs it directly ONLY invoke this agent for: full workspace analysis, theme extraction, structure mapping, or multi-aspect preflight validation. Provides read-only analysis and state assessment for downstream workflows.

Pull request preparation agent specializing in quality gate execution, change summarization, and PR template completion. Use when preparing detailed PR descriptions, running pre-PR quality gates, documenting testing evidence, completing PR checklists. Do not use when just writing commit messages - use commit-agent. only analyzing workspace state - use git-workspace-agent. ⚠️ PRE-INVOCATION CHECK (parent must verify BEFORE calling this agent): - Single commit, <50 lines? → Parent runs `gh pr create --fill` - Obvious fix (typo, bump)? → Parent creates PR directly - No quality gates needed? → Parent uses `gh pr create --title "..." --body "..."` ONLY invoke this agent for: multi-commit PRs, breaking changes, quality gate execution, or complex change narratives. Executes quality gates and produces complete PR descriptions ready for submission.

Analyzes a recreated workflow slice and produces multiple improvement approaches with explicit trade-offs and confidence scores. Use when generating improvement options after workflow recreation, comparing trade-offs between approaches, scoring improvement confidence. Do not use when recreating workflow first - use workflow-recreate-agent. already have chosen approach - use workflow-improvement-planner-agent. Second step in /fix-workflow: generates 3-5 improvement approaches with trade-offs.

Implements agreed workflow improvements across skills, agents, commands, and hooks while keeping diffs focused, consistent, and test-backed. Use when executing improvement plan from planner agent, applying focused plugin asset edits, adding tests for behavior changes. Do not use when still planning - use workflow-improvement-planner-agent. validating changes - use workflow-improvement-validator-agent. Fourth step in /fix-workflow: applies focused changes following sanctum conventions.

Converges on the best workflow improvement approach, defines acceptance criteria, and produces an execution plan coordinating implementer and validator subagents. Use when selecting best approach from analysis, defining acceptance criteria, creating bounded execution plan, coordinating implementer/validator agents. Do not use when still analyzing approaches - use workflow-improvement-analysis-agent. ready to implement - use workflow-improvement-implementer-agent. Third step in /fix-workflow: produces bounded plan with acceptance criteria.

Validates that workflow improvements make a substantive difference by running targeted tests/validators and replaying a minimal workflow reproduction. Use when confirming improvements after implementation, running targeted validation, comparing before/after metrics, documenting evidence. Do not use when still implementing - use workflow-improvement-implementer-agent. issues found - route back to implementer agent. Final step in /fix-workflow: confirms substantive improvement with evidence.

Recreates the most recent command/session slice workflow from context, identifies involved skills/agents/commands/hooks, and surfaces inefficiencies. Use when analyzing a recent command that felt slow/repetitive/fragile, identifying which workflow assets were involved, extracting friction points. Do not use when directly improving workflows - use workflow-improvement-analysis-agent next. implementing changes - use workflow-improvement-implementer-agent. First step in /fix-workflow: reconstructs what happened before analysis.

Generate conventional commit messages from staged changes with correct type/scope. Use when generating commit messages in conventional commits format. DO NOT use when: full PR preparation - use pr-prep instead.

Parallel subagent execution with code review gates between task batches for issue resolution

Merge report and analysis artifacts into permanent docs, then delete source files

Update documentation after code changes with quality gates, slop detection, consolidation, and accuracy verification.

Map file structure and organization for downstream review and refactoring workflows

Verify workspace state, staged changes, and preflight checks before commits or PRs

Prepare pull requests by running quality gates, drafting descriptions, and validating tests before submission.

Scope-focused PR review with requirements validation and backlog triage

Manage Claude Code sessions with naming, checkpointing, and resume strategies.

Update, generate, and validate tests using git-workspace-review for change context

Generate tutorials from VHS tapes and Playwright specs with dual-tone markdown and GIF recording

Refresh README structure and content using repo context from git-workspace-review

Bump versions, update changelogs, and coordinate version changes across files for releases

Retrospective evaluation and improvement of skills, agents, commands, and hooks

8 hooks across 6 events