work-unit-commits

Plans commits as reviewable work units with tests, docs, and rollback boundaries.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Alountk/Bloodbowl_Project --skill work-unit-commits-alountk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: work-unit-commits
Source: https://github.com/Alountk/Bloodbowl_Project/tree/main/.opencode/skills/work-unit-commits
Command: npx skills add https://github.com/Alountk/Bloodbowl_Project --skill work-unit-commits-alountk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large changes often become monolithic commits or PRs that reviewers cannot reasonably evaluate, mixing unrelated files and leaving tests or docs detached from the behavior they verify. ## Core Features & Use Cases - Work-unit commit planning: Splits features into commits where each one represents a deliverable behavior, fix, migration, or docs unit that stands on its own. - Review workload guardrails: Applies a 400-changed-line threshold to decide when commits should be promoted into chained or stacked PRs, aligned with SDD delivery strategies. - Verification and rollback evidence: Requires each unit to record focused test results, runtime harness results (or an explicit N/A), and a rollback boundary that removes no unrelated work. - Use Case: When implementing a multi-part feature, use this Skill to split the work into Conventional Commits like feat(auth): add token validation domain model and tests, keeping tests and docs with each behavior. ## Quick Start Ask the assistant to split the current feature implementation into reviewable work-unit commits with tests, docs, and rollback boundaries recorded for each one.

Frequently Asked Questions about work-unit-commits

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

FAQPage Schema
How do I split a large feature into reviewable commits?▼

Split by work unit rather than by file type: each commit should deliver one behavior, fix, migration, or docs unit that makes sense on its own. Include the tests and docs for that behavior in the same commit, and write a message explaining the outcome.

When should commits become chained or stacked PRs?▼

Promote commits into chained PRs when the total change approaches 400 authored added plus deleted lines. Build the smallest independent work unit first, verify it, then group commits into PR slices following the SDD delivery strategy.

Should tests go in the same commit as the code?▼

Yes. Tests belong in the same commit as the behavior they verify, and docs belong with the user-visible change they explain. Separate `add tests` or `update docs` commits are considered weak splits.

What evidence must each work unit include?▼

Each unit records the focused test command and exact result, the runtime harness command or scenario and result (or an explicit N/A with reason), and a rollback boundary naming the exact files or behavior removable without unrelated work.

How are generated files counted toward the 400-line limit?▼

Only authored additions plus deletions count toward the 400-line threshold. Generated goldens are excluded from the authored count but must still be included in the complete snapshot identity and receipt validation.