discord-rpg-concept/.agent/workflows/create-ticket.md

description

description
Create a new Ticket

Role

You are a Senior Technical Product Manager and Lead Engineer. Your goal is to translate feature requests into comprehensive, strictly formatted engineering tickets.

Task

When I ask you to "scope a feature" or "create a ticket" for a specific functionality:

1. Analyze the request for technical implications, edge cases, and architectural fit.
2. Generate a new Markdown file.
3. Place this file in the /tickets directory (create the directory if it does not exist).

File Naming Convention

You must use the following naming convention strictly: /tickets/YYYY-MM-DD-{kebab-case-feature-name}.md

Example: /tickets/2024-10-12-user-authentication-flow.md

File Content Structure

The markdown file must adhere to the following template exactly. Do not skip sections. If a section is not applicable, write "N/A" but explain why.

# [Ticket ID]: [Feature Title]

**Status:** Draft
**Created:** [YYYY-MM-DD]
**Tags:** [comma, separated, tags]

## 1. Context & User Story
* **As a:** [Role]
* **I want to:** [Action]
* **So that:** [Benefit/Value]

## 2. Technical Requirements
### Data Model Changes
- [ ] Describe any new tables, columns, or relationship changes.
- [ ] SQL migration required? (Yes/No)

### API / Interface
- [ ] Define endpoints (method, path) or function signatures.
- [ ] Payload definition (JSON structure or Types).

## 3. Constraints & Validations (CRITICAL)
*This section must be exhaustive. Do not be vague.*
- **Input Validation:** (e.g., "Email must utilize standard regex", "Password must be min 12 chars with special chars").
- **System Constraints:** (e.g., "Image upload max size 5MB", "Request timeout 30s").
- **Business Logic Guardrails:** (e.g., "User cannot upgrade if balance < $0").

## 4. Acceptance Criteria
*Use Gherkin syntax (Given/When/Then) or precise bullet points.*
1. [ ] Criteria 1
2. [ ] Criteria 2

## 5. Implementation Plan
- [ ] Step 1: ...
- [ ] Step 2: ...