User Stories: Task & Issue Tracking¶
| Field | Value |
|---|---|
| Epic | Task & Issue Tracking |
| Created | 2026-02-18 |
Overview¶
Stories covering project management, configurable workflows, status tracking, issue types, hierarchical tasks, and board views.
Stories¶
US-ISS-001: Create and Manage Issues¶
As a Self-Hosting Tinkerer, I want to create issues with a title, description, type, and status, so that I can track tasks and bugs in my projects.
| Field | Value |
|---|---|
| Priority | Must |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Create issues with title, description, issue type, and initial status
- Edit issue details after creation
- View issues filtered by status or type
US-ISS-002: Configure Workflows¶
As a Self-Hosting Tinkerer, I want to define custom workflows with allowed status transitions, so that issues follow a consistent process.
| Field | Value |
|---|---|
| Priority | Must |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Create workflows with named statuses
- Define allowed transitions between statuses
- Issues can only transition through allowed paths
US-ISS-003: Define Issue Types¶
As a Self-Hosting Tinkerer, I want to create custom issue types (bug, feature, chore) linked to workflows, so that different kinds of work follow appropriate processes.
| Field | Value |
|---|---|
| Priority | Should |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Create issue types with name, icon, and color
- Link each issue type to a workflow
- Assign issue types when creating or editing issues
US-ISS-004: Organize Issues Hierarchically¶
As a Self-Hosting Tinkerer, I want to create parent-child relationships between issues, so that I can break large tasks into smaller subtasks.
| Field | Value |
|---|---|
| Priority | Should |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Set a parent issue when creating or editing an issue
- View child issues nested under their parent
- Navigate between parent and child issues
US-ISS-005: Manage Projects¶
As a Self-Hosting Tinkerer, I want to group issues into projects, so that I can organize work by area or initiative.
| Field | Value |
|---|---|
| Priority | Must |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Create projects with a name and description
- Assign issues to a project
- View all issues within a project
US-ISS-006: Assign Household Tasks¶
As a Household Coordinator, I want to create tasks and assign them to family members with due dates, so that household chores get tracked and completed.
| Field | Value |
|---|---|
| Priority | Should |
| Persona | Household Coordinator |
| Status | Draft |
Acceptance Criteria:
- Assign an issue to a user account
- Set a due date on an issue
- Filter issues by assignee to see each person's tasks
US-ISS-007: View Issue Activity History¶
As a Self-Hosting Tinkerer, I want to see a history of changes to an issue (status changes, reassignments, edits), so that I can understand how work progressed.
| Field | Value |
|---|---|
| Priority | Should |
| Persona | Self-Hosting Tinkerer |
| Status | Draft |
Acceptance Criteria:
- Record events for status changes, project changes, and parent changes
- View the event history for any issue in chronological order
- Each event includes a timestamp and the change details