yak-shaving-handbook

What problem does it solve?

The Yak Shaving Handbook provides a comprehensive operating guide for shavers in the yakthang environment, clarifying how tasks are created, progressed, blocked, and completed using yx, context.md, comments.md, and shaver-message.

Core Features & Use Cases

• Task lifecycle and deepest-first execution model, showing how parents are blocked by children.
• Guidance on message channels and fields (context.md, comments.md, shaver-message, yakob-message) to communicate progress and decisions.
• Heartbeat and session discipline overview using /loop to schedule status checks and ensure bounded work sessions.

Quick Start

Read this handbook to learn the Yakob–Yak task lifecycle, messaging channels, and heartbeat workflow so you can start shaving tasks correctly.