Generate commit messages following conventional commits with scope detection
Generate consistent, informative commit messages for the @dotcontext/cli project.
plan({ action: 'commitPhase' }) MCP tool to auto-commit phase outputsThis project follows Conventional Commits with scope detection:
<type>(<scope>): <description>
[optional body]
[optional footer]
| Type | Use When |
|---|---|
feat | Adding new functionality (new MCP tool, new generator, new CLI command) |
fix | Fixing a bug (broken scaffold generation, incorrect path resolution) |
refactor | Restructuring code without changing behavior (service extraction, gateway consolidation) |
docs | Documentation only (README, CHANGELOG, .context/ content) |
test | Adding or updating tests |
chore | Build, tooling, dependency updates |
ci | CI/CD configuration |
Derive scope from the primary area of change:
| Scope | Directory/Area |
|---|---|
mcp | src/services/mcp/ -- MCP server, gateway tools |
cli | src/index.ts -- CLI commands, commander setup |
context | src/services/ai/tools/, src/services/init/ -- MCP scaffold and semantic-context flows |
init | src/services/init/ -- Scaffold initialization |
sync | src/services/sync/, src/services/export/, src/services/import/ |
semantic | src/services/semantic/ -- Tree-sitter, LSP, codebase analysis |
workflow | src/workflow/, src/services/workflow/ -- PREVC phases, gates |
generators | src/generators/ -- Doc, agent, plan, skill generators |
skills | src/workflow/skills/, .context/skills/ |
agents | src/generators/agents/, .context/agents/ |
plans | src/generators/plans/, src/services/mcp/gateway/plan.ts, .context/plans/ |
i18n | src/utils/i18n.ts -- Translations |
utils | src/utils/ -- Frontmatter, git, CLI UI |
ai | src/services/ai/ -- AI SDK, providers, tools |
types | src/types/, src/types.ts -- Type definitions |
deps | package.json -- Dependency changes |
When changes span multiple scopes, use the most significant one or omit the scope.
Look at what changed:
# New MCP gateway action
feat(mcp): add buildSemantic action to context gateway
# Bug fix in scaffold generation
fix(generators): handle missing frontmatter in skill scaffold files
# Refactoring workflow internals
refactor(workflow): extract gate checking into separate GateChecker class
# Updating translations
feat(i18n): add pt-BR translations for workflow status messages
For multi-file changes, include context:
feat(mcp): add skill management gateway with 6 actions
Add the `skill` gateway tool to the MCP server with actions:
list, getContent, getForPhase, scaffold, export, fill.
Includes Zod schema validation, action logging via wrap(),
and barrel re-exports through gatewayTools.ts.
# Breaking change
feat(mcp)!: consolidate project tools into context gateway
BREAKING CHANGE: Removed standalone project-setup and project-report
tools. Use context({ action: "init" }) and workflow-init instead.
# Issue reference
fix(semantic): handle missing tree-sitter gracefully
Closes #31
# Co-authored commits (used by plan commitPhase)
feat(workflow): implement PREVC phase auto-advance
Co-Authored-By: feature-developer <agent@ai-coders>
# Small fix
git commit -m "fix(frontmatter): detect v2 scaffold format before v1 fallback"
# New feature
git commit -m "feat(mcp): add plan commitPhase action for git integration"
# Dependency update
git commit -m "chore(deps): upgrade @modelcontextprotocol/sdk to 1.25.2"
# Documentation
git commit -m "docs(skills): fill bug-investigation skill with project-specific content"
# Test addition
git commit -m "test(context): cover fillSingle guidance for generated scaffolds"
# Multi-scope refactor
git commit -m "refactor: extract gateway handlers into individual modules"
When using the plan tool's commitPhase action, commits are auto-generated with:
[".context/**"]<type>(<scope>): complete <phase> phase for <plan>For manual phase commits, follow the same pattern:
feat(workflow): complete Planning phase for add-caching-layer
- Created PRD and tech spec in .context/plans/
- Defined acceptance criteria and test plan
- Linked plan to active workflow
Co-Authored-By: planner <agent@ai-coders>