---

name: task-writing description: Use when creating task files in runs/tasks/. Provides exact format required for task frontmatter and body sections.

Task Writing

Template

Task files go in runs/tasks/task-{NNN}.md. Use exactly this format:

Copy---
task_id: task-001
title: Short descriptive title
role: alto-backend
post: [alto-qa, code-simplifier, alto-gitops]
allowed_paths:
  - src/api/**
  - src/models/**
handoff: runs/handoffs/task-001.md
---

## Goal
What this task accomplishes (1-2 sentences).

## Definition of Done
- [ ] Concrete, verifiable criterion
- [ ] Another verifiable criterion
- [ ] Tests pass: `npm test`

## How to Verify
- Run `npm test` to verify tests pass
- Check API endpoint responds correctly

## Context
Reference to relevant handoffs or decisions if needed.

Required Frontmatter Fields

Optional Frontmatter Fields

Required Body Sections

1. ## Goal - What this task accomplishes
2. ## Definition of Done - Checkboxes with verifiable criteria
3. ## How to Verify - Commands to run

Rules

1. task_id matches filename - task-001 must be in task-001.md
2. role must be valid - Only known role agents
3. allowed_paths scoped - Don't give **/* access
4. DoD is verifiable - Each item must be checkable
5. Minimum body length - Validation rejects tasks under 50 characters