task-structure

name	task-structure
description	Use this skill when working with Sahaidachny task artifacts. Activated when: - Working with task planning documents - Reading/updating user stories, design decisions, implementation plans - Any task folder (task-XX/) operations
version	0.1.0

Sahaidachny Task Structure

Sahaidachny uses a hierarchical task structure for planning complex features before implementation.

Task Folder Structure

task-XX-short-name/
├── README.md                    # Task status dashboard
├── task-description.md          # Architecture + technical overview
├── user-stories/
│   ├── US-001-feature-name.md   # Detailed requirements
│   └── ...
├── design-decisions/
│   ├── README.md                # Index of decisions
│   ├── DD-001-decision-name.md  # Architecture decisions
│   └── ...
├── code-changes/
│   └── ...
├── implementation-plan/
│   ├── README.md                # Phase status tracking
│   ├── phase-01-name.md         # Execution phases with steps
│   └── ...
├── test-specs/
│   ├── e2e/                     # End-to-end test specs
│   ├── integration/             # Integration test specs
│   └── unit/                    # Unit test specs
└── research/
    └── ...

Key Artifact Formats

User Story (US-XXX-name.md)

# US-XXX: [Title]

**Status:** Draft | Review | Approved | Done
**Priority:** Critical | High | Medium | Low

## User Story
As a [role], I want [feature] so that [benefit].

## Acceptance Criteria
- [ ] AC1: [Criterion]
- [ ] AC2: [Criterion]

## Edge Cases
- Edge case 1

Implementation Phase (phase-XX-name.md)

# Phase XX: [Name]

**Status:** Pending | In Progress | Completed

## Steps
### Step 1: [Name]
- [ ] Action item 1
- [ ] Action item 2

## Success Criteria
- [ ] Criterion 1

Status Markers

Marker	Meaning
[ ]	Pending / Not started
[~]	In progress
[x]	Completed

Naming Conventions

Artifact	Pattern	Example
Task folder	task-XX-short-name/	task-05-user-auth/
User Story	US-XXX-short-name.md	US-001-login-form.md
Design Decision	DD-XXX-short-name.md	DD-001-jwt-vs-session.md
Phase	phase-XX-short-name.md	phase-01-setup.md