diff --git a/.yoi/tickets/00001KTJ1YA5G/item.md b/.yoi/tickets/00001KTJ1YA5G/item.md index a4e89074..a042b666 100644 --- a/.yoi/tickets/00001KTJ1YA5G/item.md +++ b/.yoi/tickets/00001KTJ1YA5G/item.md @@ -1,8 +1,8 @@ --- title: "Define commit policy for Ticket state changes from Intake and Panel" -state: "planning" +state: 'closed' created_at: "2026-06-07T22:06:06Z" -updated_at: "2026-06-07T22:06:06Z" +updated_at: '2026-06-11T08:08:44Z' --- ## Background diff --git a/.yoi/tickets/00001KTJ1YA5G/resolution.md b/.yoi/tickets/00001KTJ1YA5G/resolution.md new file mode 100644 index 00000000..1aaf2d3f --- /dev/null +++ b/.yoi/tickets/00001KTJ1YA5G/resolution.md @@ -0,0 +1 @@ +Panel/Intake の Ticket state change commit policy は、独立チケットとして扱わず、00001KTJ42528 Reduce Ticket lifecycle commit noise に吸収する。Orchestrator 専用 worktree / publication policy 方針により、Panel/Intake の auto-commit 可否だけを単独で決める前提が古くなったため、今後は Ticket lifecycle 全体の低ノイズ commit / dirty-state / main workspace への publication policy として一本化して扱う。 diff --git a/.yoi/tickets/00001KTJ1YA5G/thread.md b/.yoi/tickets/00001KTJ1YA5G/thread.md index 52e672b3..a668fe1c 100644 --- a/.yoi/tickets/00001KTJ1YA5G/thread.md +++ b/.yoi/tickets/00001KTJ1YA5G/thread.md @@ -4,4 +4,22 @@ Created by LocalTicketBackend create. +--- + + + +## State changed + +Ticket を closed にしました。 + + +--- + + + +## 完了 + +Panel/Intake の Ticket state change commit policy は、独立チケットとして扱わず、00001KTJ42528 Reduce Ticket lifecycle commit noise に吸収する。Orchestrator 専用 worktree / publication policy 方針により、Panel/Intake の auto-commit 可否だけを単独で決める前提が古くなったため、今後は Ticket lifecycle 全体の低ノイズ commit / dirty-state / main workspace への publication policy として一本化して扱う。 + + --- diff --git a/.yoi/tickets/00001KTJ42528/item.md b/.yoi/tickets/00001KTJ42528/item.md index 0c79436c..ebe9e323 100644 --- a/.yoi/tickets/00001KTJ42528/item.md +++ b/.yoi/tickets/00001KTJ42528/item.md @@ -1,13 +1,13 @@ --- -title: "Reduce Ticket lifecycle commit noise" +title: "Ticket lifecycle commit noise を減らし commit / publication policy を一本化する" state: "planning" created_at: "2026-06-07T22:43:09Z" -updated_at: "2026-06-07T22:43:09Z" +updated_at: "2026-06-11T05:45:00Z" --- -## Background +## 背景 -Recent Ticket-driven / multi-agent work has produced many small commits where most commits are Ticket record lifecycle events rather than implementation changes. A typical implemented Ticket currently creates commits such as: +Ticket-driven / multi-agent 運用では、Ticket record の lifecycle event ごとに小さな commit が増えやすい。典型的には、1つの実装 Ticket だけでも以下のような commit 列になる。 ```text ticket: planning ... @@ -19,34 +19,67 @@ merge: ... ticket: close ... ``` -This keeps a detailed audit trail, but it makes project history look noisy and overly fine-grained. Recent examples also include many one-off follow-up Ticket creation commits and automated Panel/Orchestrator record commits. +この運用は監査 trail を細かく残せる一方で、project の Git history が Ticket lifecycle event で過度に細分化される。さらに Panel / Intake / Orchestrator が Ticket record を更新するたびに `.yoi/tickets` が dirty になり、main workspace での人間の draft、Orchestrator の queue / progress、project record として残すべき履歴が混ざりやすい。 -The desired direction is to keep the Ticket audit trail, but reduce commit count by batching compatible Ticket record updates into fewer, more meaningful commits. +もともと `00001KTJ1YA5G` は Panel / Intake の Ticket state change を auto-commit するか dirty として見せるかを扱う narrow ticket だった。しかし Orchestrator 専用 worktree / filesystem backend 分離の方針により、Panel / Intake の auto-commit 可否だけを単独で決める前提は古くなった。 -## Goal +この Ticket は `00001KTJ1YA5G` を吸収し、Ticket lifecycle 全体の低ノイズ commit policy と、orchestration worktree から main project history へ何を publish するかの policy を一本化して定義する。 -Define and implement a lower-noise commit policy for Ticket lifecycle records produced by manual orchestration, Panel actions, Intake, and multi-agent workflows. +## ゴール -## Requirements +Ticket audit trail を失わずに、Git commit 数と main workspace の dirty noise を減らす。Panel / Intake / Orchestrator / manual orchestration が生成する Ticket record について、どの状態変更を即時 commit するか、どの状態変更を batch するか、どの記録を main workspace に publish するかを明確にする。 -- Preserve git history as the authoritative timeline for Ticket records. -- Reduce commit count caused by one-event-per-commit Ticket record updates. -- Define which Ticket lifecycle events should be batched together. -- Candidate batching policy: - - Combine planning + delegation into one `ticket: delegate ...` commit when done in one orchestration step. - - Combine implementation report + reviewer approval into one `ticket: approve ...` commit when approval is known before committing the record. - - Batch multiple newly discovered follow-up Tickets into one `ticket: add ... tasks` commit when created in the same conversation/decision burst. - - Keep close commits separate when they move open -> closed and write `resolution.md`, unless a better policy is explicitly chosen. -- Decide how automated Panel/Intake/Orchestrator Ticket updates should be committed or surfaced so they do not create excessive micro-commits. -- Update relevant workflow docs/prompts so agents stop committing every single Ticket event mechanically. -- Avoid losing important review/approval evidence; batching should change commit grouping, not remove Ticket thread events. -- Avoid broad history rewriting as part of implementation unless explicitly requested. +## 方針 -## Acceptance criteria +- 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 は、混ぜる必要がある場合を除き分ける。 -- Workflows document the preferred lower-noise commit grouping for Ticket lifecycle events. -- Agents following `/multi-agent-workflow`, `/worktree-workflow`, and Ticket role flows have clear guidance on when to batch Ticket records. -- Ticket close / merge / approval evidence remains auditable in files. -- Automated Panel/Intake/Orchestrator Ticket updates have a documented commit/dirty-state policy aligned with `define-ticket-action-commit-policy` or reference that ticket if it remains separate. -- No implementation code changes are mixed with this policy update unless required for automation support. -- `target/debug/yoi ticket doctor`, `cargo fmt --check`, and `git diff --check` pass. +## 要件 + +- 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 を削ること。