task-execution-authoring

Governs execution of spec tasks with boundary, checks, and escalation rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an AI agent implements tasks from a spec, it can drift: inventing scope, silently fixing other domains, closing tasks with failing checks, or leaving untracked temporary hacks. This Skill defines the rules of conduct for executing spec tasks so deliveries stay coherent, auditable, and within the declared domain boundary. ## Core Features & Use Cases - Spec-driven task execution: Locates tasks by stable identifiers in tasks.md, reads spec artifacts and authoritative domain documentation, and delivers only the delta between current code and the target state. - Quality-checks policy: Runs only the checks the project declares, allows justified skipped results, limits fix attempts to three, and separates pre-existing failures from introduced ones. - Forward-dependency tracking: Records deliberate temporary constructs in forward-deps.md with code markers, and requires destination tasks to resolve them before closing. - Escalation discipline: Defines exactly when to stop and ask the human — drift between documentation and code, dead code, scope gaps, ungrounded dependencies — instead of guessing. - Use Case: An agent receives tasks T3 and T5 from .agents/specs/012-reporting/. It reads the spec, implements only in-scope changes, runs the project's lint and tests, reports impacted test cases from test-cases.md, and marks the checkboxes only when work is genuinely complete. ## Quick Start Ask the agent to implement tasks T3 and T5 from the spec in .agents/specs/ following the task-execution rules.

Frequently Asked Questions about task-execution-authoring

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

FAQPage Schema
How do I execute tasks from a spec folder with an AI agent?

Send the task identifiers from tasks.md in one session. The agent reads the spec artifacts and authoritative domain documentation, implements only the delta between existing code and the target state, runs the project's declared checks, and marks each checkbox only when work is complete.

What is a forward-dependency in spec task execution?

A forward-dependency is a deliberate temporary construct one task creates that a later task replaces, such as a stub or hardcoded value. It is recorded in forward-deps.md with origin, destination, and status, plus a marker comment in the code, so the debt is never lost between sessions.

When should the agent escalate a question instead of deciding?

Escalate on technical ambiguity, drift between authoritative documentation and code, dead code in the task target, missing preconditions, ungrounded dependency installs, and scope gaps. Do not escalate choices that are purely internal to the module or already answered by the artifacts.

Can the agent update authoritative documentation when it finds drift?

No. Drift discovered during implementation is escalated to the human as a question, never fixed silently. Documentation is updated only when the task explicitly asks for it or the human authorizes it while answering a question.

What happens when a quality check fails during task execution?

The agent makes up to three targeted fix attempts, then escalates if the failure persists. Pre-existing failures are reported separately and stay outside the task scope, and a task is never closed with a red check the agent caused.