Back to Skills

validation-task-artifacts

verified

This skill should be used when the user asks to "review task mapping", "review tasks", "validate cycles", or mentions "task quality", "cycle review", or "TDD structure". Provides phase-specific review criteria for task artifacts with issue classification.

View on GitHub

Marketplace

humaninloop-plugins

deepeshBodh/human-in-loop

Plugin

humaninloop

Repository

deepeshBodh/human-in-loop
9stars

plugins/humaninloop/skills/validation-task-artifacts/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/deepeshBodh/human-in-loop/blob/main/plugins/humaninloop/skills/validation-task-artifacts/SKILL.md -a claude-code --skill validation-task-artifacts

Installation paths:

Claude
.claude/skills/validation-task-artifacts/
Powered by add-skill CLI

Instructions

# Reviewing Task Artifacts

## Purpose

Find gaps in task artifacts and generate issues that need resolution before proceeding to the next phase. Focus on vertical slice completeness, TDD structure, and traceability. This skill provides phase-specific review criteria for the Devil's Advocate.

## Review Focus by Phase

Each phase has specific checks to execute. The checks identify Critical, Important, and Minor issues.

| Phase | Focus Area | Key Checks |
|-------|------------|------------|
| Mapping | Story coverage | All P1/P2 stories mapped to cycles |
| Mapping | Slice quality | Cycles are true vertical slices |
| Mapping | Dependencies | Foundation vs feature correctly identified |
| Tasks | TDD structure | Test-first task ordering in each cycle |
| Tasks | Coverage | All cycles have implementation tasks |
| Tasks | Format | Task IDs, file paths, markers correct |
| Cross | Traceability | Stories -> Cycles -> Tasks chain complete |

See [PHASE-CHECKLISTS.md](PHASE-CHECKLISTS.md) for detailed phase-specific checklists and key questions.

## Issue Classification

Issues are classified by severity to determine appropriate action:

| Severity | Definition | Action |
|----------|------------|--------|
| **Critical** | Blocks progress; must resolve | Return to Task Architect |
| **Important** | Significant gap; should resolve | Flag for this iteration |
| **Minor** | Polish item; can defer | Note for later |

See [ISSUE-TEMPLATES.md](ISSUE-TEMPLATES.md) for severity classification rules, issue documentation formats, and report templates.

## Review Process

### Step 1: Gather Context

Read and understand:
- The artifact being reviewed (task-mapping.md or tasks.md)
- The spec requirements (user stories, acceptance criteria)
- Plan artifacts (for consistency checks)
- Previous task artifacts (for cross-phase checks)

### Step 2: Execute Checks

For each check in the phase-specific checklist:
1. Ask the question
2. Look for evidence in the artifact
3. If issue found, cl

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3532 chars