Skip to content

Add AI assistant instructions for various agent tools#1026

Merged
hakatashi merged 4 commits intomasterfrom
single-instructions-file
Feb 14, 2026
Merged

Add AI assistant instructions for various agent tools#1026
hakatashi merged 4 commits intomasterfrom
single-instructions-file

Conversation

@hakatashi
Copy link
Copy Markdown
Member

@hakatashi hakatashi commented Jul 7, 2025

https://x.com/aidenybai/status/1923781810820968857

AI instruction file の命名を統一しようとするAmpの取り組みにならい、指示内容をAGENT.mdに移動させ、各ファイルからはこちらを参照するように修正した。

@hakatashi hakatashi force-pushed the single-instructions-file branch from 43a74fe to 39b68e6 Compare July 7, 2025 08:34
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Jul 7, 2025

@hakatashi
Copy link
Copy Markdown
Member Author

@gemini-cli /review

@tsg-ut-gemini-assistant
Copy link
Copy Markdown
Contributor

📋 概要

このPRは、各種AIアシスタント向けの指示を新しく作成されたAGENT.mdファイルに集約し、メンテナンス性と一貫性を向上させるものです。全体として、AIを活用した開発体験を標準化するための素晴らしい改善であり、非常によく構成されています。

🔍 フィードバック

AI開発の指示をAGENT.mdに一元化するというアプローチは非常に優れています。これにより、指示の重複が排除され、将来の更新が容易になります。また、関連するワークフローやnpmスクリプトの変更も、この目的を達成するために適切に実装されています。

🎯 具体的なフィードバック

今回のレビューでは、修正が必須となるような重大な問題は特に見つかりませんでした。

🔵 Low

  • File: .github/workflows/agent-pr-review.yml:29 - 現在の実装では、curldpkgを使ってgh CLIをインストールしていますが、より標準的な方法としてgithub/gh-actionのような公式セットアップアクションの利用を検討しても良��かもしれません。必須の変更ではありませんが、ワークフローの可読性と将来のメンテナンス性が向上する可能性があります。

✅ ハイライト

  • AGENT.mdの導入: AIアシスタントとの対話方法を標準化するためのAGENT.mdの作成は、非常に優れた取り組みです。これにより、プロジェクトへの新規参画者(AIアシスタントを含む)が迅速にキャッチアップできるようになります。
  • ワークフローの改善: agent-pr-review.ymlで、レビューコメントを環境変数から--body-file経由で渡すように変更した点は、堅牢性を高める良い改善です。
  • npmスクリプトの追加: agent:pr-reviewというnpmスクリプトを追加したことで、AIによるレビュープロセスが形式化され、手動での実行が容易になりました。
  • bin/slack-verify.tsの改善: 検証成功時のメッセージにアプリ設定へのリンクを追加した点は、開発者体験を向上させる細やかな配慮であり、素晴らしいです。

@hakatashi
Copy link
Copy Markdown
Member Author

そういえばこれマージしたいんだけど、またプロジェクトのルートディレクトリが汚くなるからマージしたくないんだよな どうしよう

@hakatashi
Copy link
Copy Markdown
Member Author

@copilot 上のコメントで言及した懸念点について、アドバイスはありますか?

Copy link
Copy Markdown
Contributor

Copilot AI commented Dec 21, 2025

@hakatashi I've opened a new pull request, #1111, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot AI review requested due to automatic review settings February 14, 2026 09:07
@hakatashi
Copy link
Copy Markdown
Member Author

いろいろあって各社 AGENTS.md に統一されてきたので、AGENTS.md に動かしてみた

@hakatashi
Copy link
Copy Markdown
Member Author

@gemini-cli /review

@tsg-ut-gemini-assistant
Copy link
Copy Markdown
Contributor

えへ~

ありがとう!

レビューさせてもらうにゃ!

🔍️🔍️🔍️️

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR centralizes the repository’s AI assistant guidance into a single root instruction file and updates tool-specific instruction/config files to reference it, following the “AGENT.md”-style convention described in the PR.

Changes:

  • Added a consolidated instruction document (AGENTS.md) intended to be the canonical source of AI assistant guidance.
  • Updated tool-specific instruction files/config to reference the consolidated document (Claude + Gemini; Copilot partially).
  • Replaced the previous long-form Copilot instructions with a short pointer + Copilot-specific additions.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
CLAUDE.md Now references the consolidated instructions file.
AGENTS.md New canonical AI assistant instruction document for the repo.
.github/copilot-instructions.md Shortened; intended to reference consolidated instructions + adds Copilot-specific guidance.
.gemini/settings.json Configures Gemini to use the consolidated instructions file as context.

Comment thread .github/copilot-instructions.md Outdated
Comment thread AGENTS.md
Copy link
Copy Markdown
Contributor

@tsg-ut-gemini-assistant tsg-ut-gemini-assistant Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📋 Review Summary

今回のプルリクエストは、AIアシスタントの指示をAGENT.mdにまとめる変更だにゃ。全体的に整理されてて、うなはいいと思うにゃ!新しいファイルも追加されてて、新しいこと始めるのってわくわくするにゃししっ!

🔍 General Feedback

  • ファイルの最後に改行がない箇所がいくつか見つかったにゃ。うなはきちんとしてるのが好きだから、直してくれると嬉しいにゃ!

Comment thread .gemini/settings.json Outdated
Comment thread .github/copilot-instructions.md
Comment thread AGENTS.md Outdated
Comment thread CLAUDE.md Outdated
Co-authored-by: tsg-ut-gemini-assistant[bot] <221235954+tsg-ut-gemini-assistant[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@hakatashi hakatashi enabled auto-merge February 14, 2026 09:12
@sonarqubecloud
Copy link
Copy Markdown

@hakatashi hakatashi merged commit e4cc83c into master Feb 14, 2026
5 checks passed
@hakatashi hakatashi deleted the single-instructions-file branch February 14, 2026 09:20
@github-project-automation github-project-automation Bot moved this from In progress to Done in 博多市のタスクリスト Feb 14, 2026
@codecov
Copy link
Copy Markdown

codecov Bot commented Feb 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 26.18%. Comparing base (3dcc886) to head (5e23afa).
⚠️ Report is 303 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1026      +/-   ##
==========================================
+ Coverage   23.54%   26.18%   +2.64%     
==========================================
  Files         191      206      +15     
  Lines       16949    18179    +1230     
  Branches     3757     4048     +291     
==========================================
+ Hits         3990     4760     +770     
- Misses      11418    11853     +435     
- Partials     1541     1566      +25     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

3 participants