x-commit-planning

Batch commit planning artifacts under whitelisted paths without the code pre-commit chain.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/edercnj/ia-dev-environment --skill x-commit-planning
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: x-commit-planning
Source: https://github.com/edercnj/ia-dev-environment/tree/main/src/main/resources/claude/skills/x-commit-planning
Command: npx skills add https://github.com/edercnj/ia-dev-environment --skill x-commit-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Batch-committing planning artifacts without triggering the heavy code pre-commit chain, preserving a clean working tree and providing an auditable Git history for planning work.

Core Features & Use Cases

  • Atomic batch commits of planning outputs under ai/epics/epic-XXXX/** and plans/**, ensuring all changes are captured in a single commit.
  • Skip the code pre-commit chain (format/lint/compile) for planning artifacts while still producing a traceable record.
  • Enforce safe usage with explicit whitelists and argument validation to prevent accidental commits of source code or binaries.
  • Use in orchestration workflows where planning artifacts (epics, stories, templates) need to be committed as a unit after planning phases.

Quick Start

Invoke the command with your epic-id, target paths, and subject to create an atomic planning commit.

Frequently Asked Questions about x-commit-planning

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

FAQPage Schema
How do I commit planning artifacts without triggering the code pre-commit chain?▼

You can batch commit planning artifacts under whitelisted paths like ai/epics/epic-XXXX/** and plans/** to bypass heavy code formatting, preserving a clean working tree while maintaining an auditable Git history.

Why does my pre-commit hook fail when committing planning documents?▼

Standard pre-commit hooks often fail on planning documents because they enforce code compilation or formatting rules. This Skill skips the code pre-commit chain entirely, applying only argument validation and conventional commit standards.

Can I commit source code files using this planning workflow?▼

No, you cannot commit source code files. The Skill enforces safe usage with explicit path whitelists, restricting commits to planning artifacts under ai/epics/epic-XXXX/** and plans/** to prevent accidental commits of binaries or source code.

What is the best way to ensure an atomic Git history for epic planning outputs?▼

The best way to ensure an atomic Git history is to batch all planning outputs into a single conventional commit. This Skill validates your epic-id format, checks whitelisted paths, enforces subject length, and runs git add for a unified commit.

Do I need to validate epic-id format before committing planning files?▼

Yes, epic-id format validation is automatically enforced by the workflow before executing git add. This ensures your planning artifacts are correctly identified and traceable within the coordinated planning workflows.

When should I use a pre-commit bypass for Git planning artifacts?▼

You should use a pre-commit bypass when you need to commit planning artifacts like epics, stories, and templates as a single unit. This skips code linting and compilation chains while still producing a traceable and auditable record.