mirror of
https://github.com/azaion/detections.git
synced 2026-04-23 07:46:31 +00:00
Oleksandr Bezdieniezhnykh
d28b9584f2
- Replace all Jira-specific references with generic tracker/work-item terminology (TRACKER-ID, work item epics); delete project-management.mdc and mcp.json.example - Restructure refactor skill: extract 8 phases (00–07) and templates into separate files; add guided mode for pre-built change lists - Add Step 3 "Code Testability Revision" to existing-code workflow (renumber steps 3–12 → 3–13) - Simplify autopilot state file to minimal current-step pointer - Strengthen coding rules: AAA test comments per language, test failures as blocking gates, dependency install policy - Add Docker Suitability Assessment to test-spec and test-run skills (local vs Docker execution) - Narrow human-attention sound rule to human-input-needed only - Add AskQuestion fallback to plain text across skills - Rename FINAL_implementation_report to implementation_report_* - Simplify cursor-meta (remove _docs numbering table, quality thresholds) - Make techstackrule alwaysApply, add alwaysApply:false to openapi
115 lines
2.9 KiB
Markdown
115 lines
2.9 KiB
Markdown
# Task Specification Template
|
|
|
|
Create a focused behavioral specification that describes **what** the system should do, not **how** it should be built.
|
|
Save as `TASKS_DIR/[##]_[short_name].md` initially, then rename to `TASKS_DIR/[TRACKER-ID]_[short_name].md` after work item ticket creation.
|
|
|
|
---
|
|
|
|
```markdown
|
|
# [Feature Name]
|
|
|
|
**Task**: [TRACKER-ID]_[short_name]
|
|
**Name**: [short human name]
|
|
**Description**: [one-line description of what this task delivers]
|
|
**Complexity**: [1|2|3|5|8] points
|
|
**Dependencies**: [AZ-43_shared_models, AZ-44_db_migrations] or "None"
|
|
**Component**: [component name for context]
|
|
**Tracker**: [TASK-ID]
|
|
**Epic**: [EPIC-ID]
|
|
|
|
## Problem
|
|
|
|
Clear, concise statement of the problem users are facing.
|
|
|
|
## Outcome
|
|
|
|
- Measurable or observable goal 1
|
|
- Measurable or observable goal 2
|
|
- ...
|
|
|
|
## Scope
|
|
|
|
### Included
|
|
- What's in scope for this task
|
|
|
|
### Excluded
|
|
- Explicitly what's NOT in scope
|
|
|
|
## Acceptance Criteria
|
|
|
|
**AC-1: [Title]**
|
|
Given [precondition]
|
|
When [action]
|
|
Then [expected result]
|
|
|
|
**AC-2: [Title]**
|
|
Given [precondition]
|
|
When [action]
|
|
Then [expected result]
|
|
|
|
## Non-Functional Requirements
|
|
|
|
**Performance**
|
|
- [requirement if relevant]
|
|
|
|
**Compatibility**
|
|
- [requirement if relevant]
|
|
|
|
**Reliability**
|
|
- [requirement if relevant]
|
|
|
|
## Unit Tests
|
|
|
|
| AC Ref | What to Test | Required Outcome |
|
|
|--------|-------------|-----------------|
|
|
| AC-1 | [test subject] | [expected result] |
|
|
|
|
## Blackbox Tests
|
|
|
|
| AC Ref | Initial Data/Conditions | What to Test | Expected Behavior | NFR References |
|
|
|--------|------------------------|-------------|-------------------|----------------|
|
|
| AC-1 | [setup] | [test subject] | [expected behavior] | [NFR if any] |
|
|
|
|
## Constraints
|
|
|
|
- [Architectural pattern constraint if critical]
|
|
- [Technical limitation]
|
|
- [Integration requirement]
|
|
|
|
## Risks & Mitigation
|
|
|
|
**Risk 1: [Title]**
|
|
- *Risk*: [Description]
|
|
- *Mitigation*: [Approach]
|
|
```
|
|
|
|
---
|
|
|
|
## Complexity Points Guide
|
|
|
|
- 1 point: Trivial, self-contained, no dependencies
|
|
- 2 points: Non-trivial, low complexity, minimal coordination
|
|
- 3 points: Multi-step, moderate complexity, potential alignment needed
|
|
- 5 points: Difficult, interconnected logic, medium-high risk
|
|
- 8 points: High difficulty, high ambiguity or coordination, multiple components
|
|
- 13 points: Too complex — split into smaller tasks
|
|
|
|
## Output Guidelines
|
|
|
|
**DO:**
|
|
- Focus on behavior and user experience
|
|
- Use clear, simple language
|
|
- Keep acceptance criteria testable (Gherkin format)
|
|
- Include realistic scope boundaries
|
|
- Write from the user's perspective
|
|
- Include complexity estimation
|
|
- Reference dependencies by tracker ID (e.g., AZ-43_shared_models)
|
|
|
|
**DON'T:**
|
|
- Include implementation details (file paths, classes, methods)
|
|
- Prescribe technical solutions or libraries
|
|
- Add architectural diagrams or code examples
|
|
- Specify exact API endpoints or data structures
|
|
- Include step-by-step implementation instructions
|
|
- Add "how to build" guidance
|