Skip to content

CLAUDE.md / AGENTS.md に issue の読み書き先 (bannzai/PilllBackend) を明記#1824

Merged
bannzai merged 2 commits into
mainfrom
docs/issue-to-pilllbackend
Jul 17, 2026
Merged

CLAUDE.md / AGENTS.md に issue の読み書き先 (bannzai/PilllBackend) を明記#1824
bannzai merged 2 commits into
mainfrom
docs/issue-to-pilllbackend

Conversation

@bannzai

@bannzai bannzai commented Jul 17, 2026

Copy link
Copy Markdown
Owner

Abstract

CLAUDE.md と AGENTS.md に「issue の読み書き先は bannzai/PilllBackend」という指示を追記しました。

  • 対象: AI エージェント向け指示ファイル 2 つ(CLAUDE.md / AGENTS.md)
  • 追記内容:
    • このリポジトリ (bannzai/Pilll) は public で issue 機能が無効 (has_issues: false)。issue は private の bannzai/PilllBackend で管理している
    • 指示・skill に登場する issue のやりとり(作成・閲覧・コメント・ラベル操作など)は、すべて bannzai/PilllBackend の issue を読み書きする
    • gh issue 系コマンドは必ず --repo bannzai/PilllBackend を指定する

コミット構成:

  1. CLAUDE.md への追記
  2. AGENTS.md への追記(Codex 等 AGENTS.md を読むエージェント向けに同内容)

Why

  • bannzai/Pilll は public リポジトリのため issue 機能を無効にしており、issue は private の bannzai/PilllBackend 側で管理している
  • 作成先の明記がないと、AI エージェントが gh issue create--repo なしで実行して origin (bannzai/Pilll) に作成しようとして失敗する・誤った先に作ろうとするため、指示ファイルに作成先を明記した
  • 当初 CLAUDE.local.md(非コミットのローカル指示)として作成したが、リポジトリの正式な運用ルールとしてコミット対象の CLAUDE.md / AGENTS.md に記載する方針に変更した(CLAUDE.local.md は削除済み)

Links

Checked

  • Analyticsのログを入れたか
  • 境界値に対してのUnitTestを書いた
  • パターン分岐が発生するWidgetに対してWidgetTestを書いた

※ ドキュメント(エージェント指示ファイル)のみの変更のため、上記チェック項目および動作確認スクリーンショットは対象外です。

セッション再開

cd /Users/bannzai/ghq/github.com/bannzai/pilll
claude --resume 3e04dad5-2603-4296-8770-6f881e85a41d

Summary by CodeRabbit

  • ドキュメント
    • Issue の作成・閲覧・コメント・ラベル操作などの手順を整理しました。
    • Issue 機能を利用する際の対象リポジトリと、CLI コマンドで必要な指定を明記しました。

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Issue機能が無効なリポジトリであること、Issue操作をbannzai/PilllBackendで行うこと、gh issueコマンドにリポジトリ指定が必要であることを、AGENTS.mdCLAUDE.mdに追加しました。

Changes

Issue運用案内

Layer / File(s) Summary
Issue操作先の運用ルール
AGENTS.md, CLAUDE.md
Issueの作成・閲覧・コメント・ラベル操作などの対象をbannzai/PilllBackendとし、gh issue系コマンドで--repo bannzai/PilllBackendを指定するルールを追加しました。

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed PR の主変更である issue の読み書き先を CLAUDE.md と AGENTS.md に追記する内容を正しく要約しています。
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/issue-to-pilllbackend

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@AGENTS.md`:
- Around line 15-16: Update .claude/settings.json to allow issue comments and
label operations against bannzai/PilllBackend, including the relevant gh issue
comment and label commands, while preserving the existing gh issue view/create
permissions. Apply this consistently with the issue-operation guidance in
AGENTS.md (lines 15-16) and CLAUDE.md (lines 97-98); no direct changes are
required in those documentation sites.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 454cc7bc-0c76-4f16-ab5c-0250bed8b9dc

📥 Commits

Reviewing files that changed from the base of the PR and between 3973847 and c0af98c.

📒 Files selected for processing (2)
  • AGENTS.md
  • CLAUDE.md

Comment thread AGENTS.md
Comment on lines +15 to +16
- 指示・skill に登場する issue のやりとり(作成・閲覧・コメント・ラベル操作など)は、すべて bannzai/PilllBackend の issue を読み書きする
- `gh issue` 系コマンドは必ず `--repo bannzai/PilllBackend` を指定する

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🩺 Stability & Availability | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf '\n== files ==\n'
git ls-files AGENTS.md CLAUDE.md .claude/settings.json

printf '\n== AGENTS.md ==\n'
cat -n AGENTS.md | sed -n '1,80p'

printf '\n== CLAUDE.md ==\n'
cat -n CLAUDE.md | sed -n '80,130p'

printf '\n== .claude/settings.json ==\n'
cat -n .claude/settings.json | sed -n '1,220p'

Repository: bannzai/Pilll

Length of output: 5465


.claude/settings.json に issue コメント/ラベル操作の許可を追加してください。
AGENTS.mdCLAUDE.md は issue の作成・閲覧・コメント・ラベル操作を bannzai/PilllBackend で行うよう指示していますが、.claude/settings.jsongh issue view / gh issue create しか許可していません。gh issue comment とラベル更新に必要なコマンドも allow に追加するか、文書側を許可範囲に合わせてください。

📍 Affects 2 files
  • AGENTS.md#L15-L16 (this comment)
  • CLAUDE.md#L97-L98
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@AGENTS.md` around lines 15 - 16, Update .claude/settings.json to allow issue
comments and label operations against bannzai/PilllBackend, including the
relevant gh issue comment and label commands, while preserving the existing gh
issue view/create permissions. Apply this consistently with the issue-operation
guidance in AGENTS.md (lines 15-16) and CLAUDE.md (lines 97-98); no direct
changes are required in those documentation sites.

@bannzai
bannzai merged commit 0c642f9 into main Jul 17, 2026
6 checks passed
@bannzai
bannzai deleted the docs/issue-to-pilllbackend branch July 17, 2026 20:00
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