Complete example

This Template brings together the parts described in the other Template guides. Preview it with a Mock Story before you adapt it, and check each field in the Schema Reference, such as filter, tasks, and estimation.

formatVersion: "1.0"
name: "Backend API Development"
description: "Standard workflow for developing RESTful API endpoints"
author: "Platform Team"
tags: ["backend", "api", "rest"]

filter:
  workItemTypes: ["User Story"]
  states: ["New", "Active"]
  tags:
    include: ["backend", "api"]
    exclude: ["deprecated"]
  priority:
    min: 1
    max: 3
  excludeIfHasTasks: true

tasks:
  - id: "design"
    title: "Design API: ${story.title}"
    description: "Design REST endpoints, request/response schemas, and error handling"
    estimationPercent: 15
    activity: "Design"
    tags: ["design", "api"]
    assignTo: "@ParentAssignee"

  - id: "db-schema"
    title: "Database Schema"
    description: "Create or update database schema and migrations"
    estimationPercent: 15
    estimationPercentCondition:
      - condition:
          field: "tags"
          operator: "contains"
          value: "complex-db"
        percent: 25
    activity: "Development"
    dependsOn: ["design"]

  - id: "implement"
    title: "Implement Core Logic: ${story.title}"
    description: "Implement business logic, validation, and API endpoints"
    estimationPercent: 35
    activity: "Development"
    assignTo: "@ParentAssignee"
    dependsOn: ["design", "db-schema"]

  - id: "unit-tests"
    title: "Unit Tests"
    estimationPercent: 15
    activity: "Testing"
    dependsOn: ["implement"]

  - id: "integration-tests"
    title: "Integration Tests"
    estimationPercent: 10
    activity: "Testing"
    dependsOn: ["implement"]

  - id: "security-review"
    title: "Security Review"
    estimationPercent: 10
    activity: "Testing"
    condition:
      any:
        - field: "tags"
          operator: "contains"
          value: "security"
        - field: "tags"
          operator: "contains"
          value: "auth"
    dependsOn: ["implement"]

  - id: "review"
    title: "Code Review & Documentation"
    estimationPercent: 10
    activity: "Documentation"
    assignTo: "@Me"
    dependsOn: ["unit-tests", "integration-tests"]

estimation:
  strategy: "percentage"
  rounding: "nearest"
  minimumTaskEstimate: 0.5
  ifParentHasNoEstimation: "skip"

validation:
  mode: "strict"
  totalEstimationMustBe: 100
  minTasks: 3
  maxTasks: 10

metadata:
  category: "Backend"
  estimationGuidelines: "Works best with stories between 5-13 story points."

Explained in the guides

Filters, tasks and dependencies, conditions, estimation, and validation and metadata.