feat: Refactor work item management and documentation for clarity and structure

This commit is contained in:
2026-04-10 09:23:11 -06:00
parent 010639b592
commit 9f4a08f2e9
28 changed files with 274 additions and 21 deletions

25
ai/work-items/README.md Normal file
View File

@@ -0,0 +1,25 @@
# Work Items
## Goal
Keep active Jira-linked work in one canonical place so standups, manager updates, and memory syncs can reference each ticket precisely.
---
## Structure
- `index.md`
Active index and quick status view.
- `<jira-id>.md`
Canonical file for a specific ticket.
---
## Update Rules
- Use one file per active or recently relevant Jira item.
- Keep titles exact when approved or explicitly confirmed.
- If the title is not confirmed, store the Jira ID and current framing without inventing a final title.
- Update the ticket file when scope, sequencing, points, status, rollout implications, or reproducibility meaningfully change.
- Keep `ai/state/work-items.md` as a short bridge summary, not the primary source of detailed ticket context.