Skip to content

chore: packages/ui(1272e81d 以降に足された分)の無駄なコメントを消す - #4405

Merged
takecchi merged 1 commit into
mainfrom
chore/ui-comments-3710
Oct 10, 2026
Merged

takecchi merged 1 commit into
mainfrom
chore/ui-comments-3710

Conversation

@takecchi

Copy link
Copy Markdown
Owner

Refs #3710

packages/ui で、2026-10-09 の到達点の報告の時点(1272e81d)より後に足されたコメントを整理した。コメントだけの変更で、コードは変えていない。

基準と、その根拠

#4401(core)・#4402(web)・#4403(cli)・#4404(daemon)と同じ。AGENTS.md の「情報の置き場所」に従い、コードのコメントには Why not(単純にすると壊れる理由)だけを残す。How はコードで、What は試験の名前で、Why はコミットログで表す。Issue 番号・経緯は消す。

オーナーの承認(クローンの手元の記録から):

  • 2026-10-07T00:46Z、承認 f6e6bad8「この基準で全体に広げてよい」
  • 2026-10-07T01:17Z、オーナーの逐語「AGENTS.mdに則って整理してくれませんか?とても大きな削除になると思いますが想定通りです。」

範囲

  • 対象: git diff 1272e81d origin/main -- packages/ui で足された、行頭がコメントの行(19行)
  • 外したファイル: なし(open の PR は packages/ui に触れていない)

消したもの・残したもの

  • 消した:
    • Issue 番号(#4340・#4381)
    • DaemonImages・match・ImageFallback の doc のうち、名前と型を言い直していた行
  • 残した:
    • DaemonImages を context で渡す理由(packages/ui は packages/swr に依存しない)と、渡さない画面での振る舞い
    • match が資格の判定の唯一の場所であること
    • markdown.tsx の blob の後始末の理由
    • chat-header.tsx の狭い画面の作りの理由

確かめたこと

  • コメントを除いた構文木が main と一致する: 5 files, mismatches 0(TypeScript の printer を removeComments: true で回し、origin/main の版と比べた)
  • npx prettier --check(変えた5ファイル)通過
  • 触ったファイルを readFileSync / ?raw で読む箇所は無かった

確かめていないこと

  • 手元では ui の typecheck も試験も回していない。コードが変わっていないことの根拠は、上の構文木の一致だけである。試験は CI に任せた
  • どのコメントが What で、どれが守らないと壊れる理由かは私の判定であって、確認ではない

Alteroid-Issue-Done: none

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant