docs: 設計記録を docs/ へ移し、CLAUDE.md を git 管理外にする - #14
Merged
Conversation
このリポジトリは公開されている。エージェント向けのメモは、置き場所の性質上 「アカウントの使い分け」「認証」「手元の作業手順」のような、そのマシンでしか 成り立たない事情を吸い寄せる——公開物に混ざってはいけないものだ。 そこで置き場所を分けた。誰の環境でも同じこと（設計判断とその理由、772行）は docs/ARCHITECTURE.md としてリポジトリに残し、CLAUDE.md と AGENTS.md は .gitignore に入れて手元固有のメモ専用にする。参照は6ファイルから張り替え、 README と docs/README.md に索引を足した。 あわせて、手元の PSD を測って出た具体的な数値（透明帯 785px/954px など）を 一般的な事実のように書いていたのを直した。PSD はライセンス上リポジトリに 入らず各自が持ち込むものなので、その値は環境によって変わる。だから PsdStage.contentInsets() は定数を持たずに毎回測っている——コメントのほうが 実装の前提と食い違っていた。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GodXX9Etns9H9rLEebQYbM
CLAUDE.md を git 管理外にしたことで、新しいクローンでは自動で読まれるファイルが 無くなった。README は必ず見られるので、そこに一筆置く——ファイルが無いのは事故 ではないこと、設計は docs/ARCHITECTURE.md にあること、手元のメモは CLAUDE.md に 書けばコミットに混ざらないこと。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GodXX9Etns9H9rLEebQYbM
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
このリポジトリは公開されている。一方でエージェント向けのメモは、置き場所の性質上「アカウントの使い分け」「認証」「手元の作業手順」といった、そのマシンでしか成り立たない事情を吸い寄せる。公開物に混ざってはいけないものだ。
そこで置き場所を分けた。
docs/ARCHITECTURE.md（追跡）CLAUDE.md/AGENTS.md（git 管理外）CLAUDE.md→docs/ARCHITECTURE.mdへリネームとして移動（履歴は繋がる）。冒頭に「ここには誰の環境でも同じことだけを書く」という但し書きを足したCLAUDE.mdとAGENTS.mdを.gitignoreに追加CONTRIBUTING.md/docs/{README,DEVELOPMENT,PERSONA,STYLE}.md）、README.mdの索引にも一行足したPSD 固有の数値を一般化した
あわせて、手元の PSD を測って出た具体的な数値（透明帯 785px/954px、実測の insets など）を、全員に当てはまる事実のように書いていたのを直した。
PSD はライセンス上リポジトリに入らず各自が持ち込むものなので、その値は環境によって変わる。だから
PsdStage.contentInsets()は定数を持たずに毎回測っている——コメントのほうが実装の前提と食い違っていた。🤖 Generated with Claude Code
https://claude.ai/code/session_01GodXX9Etns9H9rLEebQYbM