Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity
develop
yoi/.yoi/tickets/00001KTJ42528/item.md

6.3 KiB
Raw Permalink Blame History

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

背景

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

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 を削ること。