---
title: "Ticket lifecycle commit noise を減らし commit / publication policy を一本化する"
state: "planning"
created_at: "2026-06-07T22:43:09Z"
updated_at: "2026-06-11T05:45:00Z"
---

## 背景

Ticket-driven / multi-agent 運用では、Ticket record の lifecycle event ごとに小さな commit が増えやすい。典型的には、1つの実装 Ticket だけでも以下のような commit 列になる。

```text
ticket: planning ...
ticket: delegate ...
feat/fix: ...
ticket: report implementation ...
ticket: approve ...
merge: ...
ticket: close ...
```

この運用は監査 trail を細かく残せる一方で、project の Git history が Ticket lifecycle event で過度に細分化される。さらに Panel / Intake / Orchestrator が Ticket record を更新するたびに `.yoi/tickets` が dirty になり、main workspace での人間の draft、Orchestrator の queue / progress、project record として残すべき履歴が混ざりやすい。

もともと `00001KTJ1YA5G` は Panel / Intake の Ticket state change を auto-commit するか dirty として見せるかを扱う narrow ticket だった。しかし Orchestrator 専用 worktree / filesystem backend 分離の方針により、Panel / Intake の auto-commit 可否だけを単独で決める前提は古くなった。

この Ticket は `00001KTJ1YA5G` を吸収し、Ticket lifecycle 全体の低ノイズ commit policy と、orchestration worktree から main project history へ何を publish するかの policy を一本化して定義する。

## ゴール

Ticket audit trail を失わずに、Git commit 数と main workspace の dirty noise を減らす。Panel / Intake / Orchestrator / manual orchestration が生成する Ticket record について、どの状態変更を即時 commit するか、どの状態変更を batch するか、どの記録を main workspace に publish するかを明確にする。

## 方針

- Ticket thread / item / resolution に残る event や evidence は削らない。
- Git commit grouping を粗くし、1 event = 1 commit の機械的運用を避ける。
- Panel / Intake の state transition policy はこの Ticket に統合する。
- Orchestrator 専用 worktree 方針を前提に、active queue / in-progress coordination と main project history を分けて考える。
- main workspace に publish するのは、project record として価値がある節目に寄せる。
- 実装 code change と Ticket policy / lifecycle record の commit は、混ぜる必要がある場合を除き分ける。

## 要件

- Git history を Ticket record の重要な audit / publication layer として維持する。
- ただし、active orchestration coordination のすべてを main workspace の Git history に即時反映する前提にはしない。
- Ticket lifecycle event の batch 方針を決める。
  - planning + delegation は、同じ orchestration step なら `ticket: delegate ...` などの1 commit にまとめてよい。
  - implementation report + reviewer approval は、commit 前に approval まで揃っているなら `ticket: approve ...` などにまとめてよい。
  - follow-up Ticket 作成は、同じ会話・判断 burst で複数作成された場合、1つの `ticket: add ... followups` 系 commit にまとめてよい。
  - close / resolution は原則として節目 commit とするが、publication policy と矛盾しない範囲で明示的に batch 可否を決める。
- Panel / Intake / Orchestrator による Ticket-only update の扱いを決める。
  - `planning -> ready`
  - `ready -> queued`
  - `queued -> inprogress`
  - comments / intake summaries / handoff reports
  - review / approval / implementation report
  - close / done transition / resolution
- Panel / Intake が main workspace で Ticket draft や state change を作った場合、それを即時 auto-commit するのか、dirty state として明示するのか、orchestration worktree へ promote するのかを定義する。
- Orchestrator 専用 worktree 上の Ticket record を、main workspace にいつ・どの粒度で publish するかを定義する。
  - active queue / transient progress は main に即時 publish しない選択肢を検討する。
  - accepted requirements、重要 decision、implementation report、review approval、resolution など、project record として残すべき節目を分類する。
- workflow / prompt / docs を更新し、agent が Ticket event ごとに機械的に commit しないようにする。
- auto-commit を導入・維持する場合は、対象 Ticket path だけを stage し、 unrelated user changes を含めない。
- auto-commit しない場合は、Panel / actionbar / diagnostics などで dirty Ticket state と必要な次 action を明確に示す。
- review / approval / merge / close の evidence は files 上に残し、commit grouping の変更で監査性を失わない。
- 過去 Git history の rewrite は行わない。

## 受け入れ条件

- `00001KTJ1YA5G` の scope がこの Ticket に吸収されていることが記録されている。
- Panel / Intake の Ticket state change について、auto-commit / dirty-state / promote-to-orchestration-worktree の policy が明文化されている。
- Orchestrator / multi-agent workflow で生成される Ticket lifecycle record の batch commit 方針が文書化されている。
- Orchestrator 専用 worktree から main workspace へ publish する record の種類と粒度が定義されている。
- `/multi-agent-workflow`、`/worktree-workflow`、Ticket role prompt / workflow guidance が、低ノイズ commit / publication policy と矛盾しない。
- Ticket close / merge / approval evidence が引き続き auditable な file record として残る。
- unrelated user changes を巻き込む broad auto-commit を避ける方針が明記されている。
- 必要な実装変更がある場合、targeted tests が追加・更新されている。
- `target/debug/yoi ticket doctor`、`cargo fmt --check`、`git diff --check` が通る。

## 非目標

- Ticket backend を Git 外 DB に移行すること。
- 過去の Git history を rewrite して既存 commit noise を整理すること。
- implementation code changes を Ticket lifecycle policy update に混ぜること。
- Orchestrator が push すること。
- project record として残すべき evidence を削ること。
