@fromsvenwithlove/devops-issues-cli/templates/api-project.json

AI-powered CLI tool and library for Azure DevOps work item management with Claude agents

{
  "metadata": {
    "parentId": "PARENT_WORK_ITEM_ID",
    "defaults": {
      "assignedTo": "backend.team@company.com",
      "tags": "api;microservice"
    }
  },
  "workItems": [
    {
      "type": "Epic",
      "title": "Epic: REST API Development",
      "description": "Complete REST API development with authentication, data management, and comprehensive documentation.",
      "children": [
        {
          "type": "Feature",
          "title": "Feature: API Foundation and Architecture",
          "description": "Core API structure, middleware, error handling, and development setup.",
          "children": [
            {
              "type": "User Story",
              "title": "As a developer, I want a well-structured API foundation so that I can build endpoints efficiently",
              "description": "Set up the core API structure with proper middleware, error handling, and development tools.",
              "acceptanceCriteria": "Given the API project is set up\nWhen a developer adds new endpoints\nThen they follow consistent patterns\nAnd error handling works uniformly",
              "children": [
                {
                  "type": "Task",
                  "title": "Setup: Initialize Node.js project",
                  "description": "Create package.json, install dependencies, configure TypeScript."
                },
                {
                  "type": "Task",
                  "title": "Architecture: Design API structure",
                  "description": "Create folder structure, routing pattern, and middleware setup."
                },
                {
                  "type": "Task",
                  "title": "Middleware: Implement error handling",
                  "description": "Create global error handling and logging middleware."
                }
              ]
            }
          ]
        },
        {
          "type": "Feature",
          "title": "Feature: Authentication and Authorization",
          "description": "JWT-based authentication system with role-based access control.",
          "children": [
            {
              "type": "User Story",
              "title": "As an API consumer, I want secure authentication so that my data is protected",
              "description": "Implement JWT authentication with user registration, login, and token management.",
              "acceptanceCriteria": "Given a user wants to access protected endpoints\nWhen they authenticate with valid credentials\nThen they receive a JWT token\nAnd can access authorized resources",
              "children": [
                {
                  "type": "Task",
                  "title": "Auth: Implement user registration",
                  "description": "Create user registration endpoint with validation."
                },
                {
                  "type": "Task",
                  "title": "Auth: Implement login/logout",
                  "description": "Create login/logout endpoints with JWT generation."
                },
                {
                  "type": "Task",
                  "title": "Auth: Add authorization middleware",
                  "description": "Create middleware for protecting routes and checking permissions."
                }
              ]
            }
          ]
        },
        {
          "type": "Feature",
          "title": "Feature: Data Management and CRUD Operations",
          "description": "Database integration with full CRUD operations for core entities.",
          "children": [
            {
              "type": "User Story",
              "title": "As an API consumer, I want to manage data through standard REST operations",
              "description": "Implement full CRUD operations for main entities with proper validation.",
              "acceptanceCriteria": "Given an authenticated user\nWhen they perform CRUD operations\nThen the API responds with proper HTTP status codes\nAnd data is validated and persisted correctly",
              "children": [
                {
                  "type": "Task",
                  "title": "Database: Design schema and models",
                  "description": "Create database schema and ORM models for core entities."
                },
                {
                  "type": "Task",
                  "title": "API: Implement CRUD endpoints",
                  "description": "Create REST endpoints for Create, Read, Update, Delete operations."
                },
                {
                  "type": "Task",
                  "title": "Validation: Add input validation",
                  "description": "Implement request validation and sanitization."
                }
              ]
            }
          ]
        },
        {
          "type": "Feature",
          "title": "Feature: API Documentation and Testing",
          "description": "Comprehensive API documentation and automated testing suite.",
          "children": [
            {
              "type": "User Story",
              "title": "As an API consumer, I want clear documentation so that I can integrate easily",
              "description": "Provide comprehensive API documentation with examples and testing tools.",
              "acceptanceCriteria": "Given the API is developed\nWhen a developer needs to integrate\nThen they have access to clear documentation\nAnd can test endpoints interactively",
              "children": [
                {
                  "type": "Task",
                  "title": "Docs: Set up Swagger/OpenAPI",
                  "description": "Configure Swagger for API documentation generation."
                },
                {
                  "type": "Task",
                  "title": "Testing: Write integration tests",
                  "description": "Create comprehensive integration tests for all endpoints."
                },
                {
                  "type": "Task",
                  "title": "Testing: Add performance tests",
                  "description": "Implement load testing and performance benchmarks."
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}