yoi/docs/plan/maintainer-work-items.md
2026-06-01 18:49:23 +09:00

34 lines
1.4 KiB
Markdown

# AI maintainer 用 WorkItem / Thread 抽象メモ
> Status: mostly implemented / historical design memo.
>
> この文書は `tickets.sh` + `work-items/` MVP の前に書かれた設計メモ。現在の運用上の正本は `AGENTS.md` の Work item / Ticket 運用と、実際の `tickets.sh` / `work-items/{open,pending,closed}`。古い `TODO.md` / `tickets/` 前提は superseded。
## 現在実現済みの部分
- WorkItem 相当: `work-items/{open,pending,closed}/<id>/item.md`
- Thread 相当: `thread.md`
- Event 相当: `tickets.sh comment/review/status/close` が append する thread entry
- Artifact 相当: `artifacts/` directory
- Resolution 相当: close 時の `resolution.md`
- ID: timestamp + slug 形式
- Doctor: `./tickets.sh doctor`
`work-items/` は repo-managed な project coordination record であり、`.yoi/memory` はその代替ではない。
## 現在も残る設計余地
- Rust crate / Store interface としての WorkItemStore
- LeaseStore / Run tracking / maintainer inbox
- remote maintainer hub / GitHub Issues などへの backend 差し替え
- TUI 統合
これらは必要になった時点で改めて work item 化する。
## 現在の運用参照
- `AGENTS.md` — Work item / Ticket の運用ルール
- `tickets.sh` — 実際の操作コマンド
- `work-items/` — 現在の project-visible coordination data
- `docs/plan/ai-maintainer.md` — AI maintainer workflow の現行設計