name: "🤖 Agent Task"
description: "Auto-generated from BlackRoad OS Metrics"
title: "[AGENT] Improve documentation coverage"
labels: ["agent-task", "automated", "metrics-generated"]
body:
  - type: markdown
    attributes:
      value: |
        ## Agent-Executable Task
        This task was automatically generated by the BlackRoad OS Metrics system.

        **Generated:** 2025-12-26 19:08:10
        **Source:** Metrics threshold detection

  - type: dropdown
    id: priority
    attributes:
      label: Priority
      options:
        - "P2 - This week"
    validations:
      required: true

  - type: textarea
    id: instruction
    attributes:
      label: Instruction
      description: What should the agent do?
      value: |
Documentation ratio is 0.0%. Add comprehensive docs.

Steps:
1. Create README.md for each major component
2. Add API documentation with examples
3. Write architecture overview
4. Create setup/deployment guides
5. Add inline code comments for complex logic
    validations:
      required: true

  - type: textarea
    id: files
    attributes:
      label: Files to touch
      description: Which files should be created or modified?
      value: |
- Create: README.md in each directory
- Create: docs/API.md
- Create: docs/ARCHITECTURE.md
- Create: docs/SETUP.md
- Add: JSDoc/docstrings in code

  - type: textarea
    id: done
    attributes:
      label: Definition of done
      description: How does the agent know it's complete?
      value: |
- Each component has README
- API fully documented with examples
- Architecture documented
- New developers can setup from docs alone

  - type: textarea
    id: constraints
    attributes:
      label: Constraints / Don'ts
      value: |
- Don't duplicate existing docs
- Keep docs concise and practical
- Include code examples

  - type: dropdown
    id: agent
    attributes:
      label: Assigned agent
      options:
        - "Codex"