tasks-authoring

Generates hierarchical tasks.md checklists for spec-driven development work units.

Updated Jan 28, 2024
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/KrockSide --skill tasks-authoring-thiago-cruz-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tasks-authoring
Source: https://github.com/Thiago-Cruz-eng/KrockSide/tree/main/.agents/skills/tasks-authoring
Command: npx skills add https://github.com/Thiago-Cruz-eng/KrockSide --skill tasks-authoring-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a tasks.md for a spec-driven work unit often produces wrong granularity: bloated tasks mixing multiple flows, purely structural setup tasks, or catch-all validation tasks at the end. This Skill defines the standard for decomposing a spec and plan into an ordered, dependency-driven task checklist. ## Core Features & Use Cases - Granularity rules: Defines when to group artifacts by direct dependency and when to split tasks (multiple user flows, more than 3 distinct actions, mixed technical layers). - Ordering by dependency graph: Ensures artifacts are born in the task that first uses them, forbidding upfront "technical base" tasks and final "integrated validation" tasks. - Forward-dependency tracking: Specifies the forward-deps.md record format for temporary stubs that a later task must replace. - Boundary rules: Distinguishes executable tasks from preconditions, open questions, and cross-domain dependencies recorded in spec.md and plan.md. - Use Case: After producing spec.md and plan.md for a new feature unit, generate a tasks.md where each task delivers one testable behavior with its tests included, ordered by real dependencies. ## Quick Start Use the tasks-authoring skill to generate the tasks.md for the work unit in .agents/specs/012-reporting from its spec.md and plan.md.

Frequently Asked Questions about tasks-authoring

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

FAQPage Schema
How do I write a tasks.md for spec-driven development?

Derive tasks from the real dependency graph of the spec, with each task delivering one cohesive, testable behavior including its own tests. Order tasks so each artifact is created in the task that first uses it, and avoid structural setup tasks or final validation tasks.

How granular should tasks be in a tasks.md checklist?

Each task should be implementable in a single agent session, typically touching 2-8 files and covering one user flow or one cohesive technical capability. Split when a task contains multiple independent flows, more than three distinct user actions, or mixed technical layers.

Should tests go in a separate task from implementation?

No. Unit, integration, and e2e tests belong inside the same task that creates the code they cover. A standalone catch-all testing or validation task at the end of the checklist is explicitly forbidden.

What is a forward-dependency between tasks?

A forward-dependency occurs when a consumer task must precede the task delivering its definitive infrastructure, so the source task creates a temporary stub and a later task replaces it. It requires an entry in forward-deps.md linking source, destination, and expected resolution.

How are cross-domain dependencies handled in tasks.md?

Behaviors belonging to other domains never become tasks in the current unit. Blocking dependencies are recorded as preconditions in the task description, while dependencies blocking the entire unit are escalated as open questions in the spec phase.