work-unit-craft

Craft work-unit tracker records with observable outcomes and acceptance criteria.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/tesserine/groundwork --skill work-unit-craft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: work-unit-craft
Source: https://github.com/tesserine/groundwork/tree/main/skills/work-unit-craft
Command: npx skills add https://github.com/tesserine/groundwork --skill work-unit-craft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A work-unit's tracker record transfers problem understanding across a context boundary — from the author who sees the problem to the agent who will solve it. The implementing agent has no access to the author's context, codebase familiarity, or unstated assumptions. Everything it needs must be in the record. Forges name the record differently — GitHub says issue, SourceHut says ticket — the craft is the same on every forge.

Core Features & Use Cases

  • The body of the record states observable outcomes, the recipient documentation contract, and governance decisions; it preserves the problem statement across delegation.
  • It anchors the record with reckoned constraints and author contract inputs so future implementers can act without hidden context.
  • It guides decompose, pivot, and review phases, ensuring the work-unit lifecycle remains aligned with the original problem.

Quick Start

Create a new work-unit record capturing the problem, acceptance criteria, and the contract inputs for downstream implementers.

Frequently Asked Questions about work-unit-craft

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

FAQPage Schema
What is a work-unit tracker record and why do I need one for context boundaries?

A work-unit tracker record transfers problem understanding across context boundaries from author to agent. It captures observable outcomes, constraints, and governance decisions so downstream implementers can act without hidden context or unstated assumptions.

How do I write a work-unit record that preserves the problem statement across delegation?

To write a work-unit record, state observable outcomes, recipient documentation contracts, and governance decisions. Anchor the record with reckoned constraints and author contract inputs to preserve the problem statement throughout the decompose and pivot phases.

Does this work-unit documentation approach work with GitHub issues and SourceHut tickets?

Yes, the work-unit documentation craft works across forge environments. GitHub names the record an issue, SourceHut calls it a ticket, but the craft of transferring problem context and anchoring constraints remains the same on every forge platform.

What should I include in work-unit acceptance criteria for downstream implementers?

Work-unit acceptance criteria should include observable outcomes, reckoned constraints, and author contract inputs. Including governance decisions and aligning with the contract lifecycle ensures downstream implementers have everything needed without accessing the author's original context.

When do I need to update work-unit records during the decompose and pivot phases?

Update work-unit records during decompose, pivot, and record review phases across planning, execution, and verification. This ensures the work-unit lifecycle remains aligned with the original problem and the contract lifecycle throughout context delegation.

Can I use work-unit records without defining contract inputs and governance decisions?

No, contract inputs and governance decisions are essential. Without anchoring the record with these elements, future implementers lose the recipient documentation contract and cannot act accurately without hidden context from the original problem author.