Skip to content

docs: 変更のたびに古くなるコメントを書かないよう規約を追加する - #61

Merged
shin4488 merged 1 commit into
masterfrom
docs/agents-comment-guidelines
Oct 4, 2026
Merged

shin4488 merged 1 commit into
masterfrom
docs/agents-comment-guidelines

Conversation

@shin4488

@shin4488 shin4488 commented Oct 4, 2026

Copy link
Copy Markdown
Owner

概要

  • AGENTS.mdの「作業の進め方」に、コメントにはコードから読み取れない意図・前提だけを書き、経緯・変わりやすい値・他の資料の場所など、変更のたびに古くなる内容は書かないという規約を追加しました。
  • 同じ趣旨の既存の記載(判断理由・意図をコメントに書く旨)を削り、重複をなくしました。

動作確認

  • 文書だけの変更のため、差分とMarkdownの記法を確認しました。アプリの動作に影響しないため、ビルド・テストは実行していません。

注意

  • masterへのマージは本番Lambdaへの自動デプロイになることを理解している
  • シークレット(APIキー等)を含んでいない

🤖 Generated with Claude Code

@shin4488
shin4488 merged commit c207a96 into master Oct 4, 2026
4 checks passed
@shin4488
shin4488 deleted the docs/agents-comment-guidelines branch October 4, 2026 08:17
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