Smithery is now a part of Arcade.dev! Read more in our announcement here
PJドキュメント同期。PJ CLAUDE.mdの更新依頼時やドキュメント整理依頼時に使用。user-level設定との整合性確認、ドキュメント分離原則の適用、不要ファイル削除を実施。
コード変更後の依頼では、フル同期でなく変更起点の差分同期を行う:
git diff <base-branch> --name-only と git diff <base-branch>| カテゴリ | 例 | 更新対象 |
|---|---|---|
| コマンド変更 | npm script追加 | CLAUDE.md, README.md |
| API変更 | エンドポイント追加 | API仕様書 |
| 設定変更 | 環境変数追加 | README.md |
| アーキテクチャ変更 | 新規レイヤー | CLAUDE.md |
| 対象 | 配置場所 | 用途 |
|---|---|---|
| 人間向け | README.md, docs/ | プロジェクト説明、API仕様、アーキテクチャ図 |
| エージェント向け | CLAUDE.md, .claude/context/, .claude/rules/ | AI向け指示、作業ルール |
# PJ CLAUDE.mdの確認
cat CLAUDE.md 2>/dev/null || echo "CLAUDE.md not found"
wc -l CLAUDE.md 2>/dev/null
# ドキュメント構造の確認
ls -la .claude/ 2>/dev/null
ls -la .claude/rules/ 2>/dev/null
ls -la docs/ 2>/dev/null
# コンテキスト除外設定の確認（permissions.deny の Read ルール / claudeMdExcludes）
cat .claude/settings.json 2>/dev/null || echo ".claude/settings.json not found"
# user-level設定の確認（実体はAGENTS.md。CLAUDE.mdは互換symlink）
cat ~/.claude/AGENTS.md
ls ~/.claude/context/
以下を確認:
| 項目 | 確認内容 |
|---|---|
| CLAUDE.mdのサイズ | 肥大せず簡潔か（@context/claude-customization-guide.md §3参照） |
| 変数定義 | MEMORY_DIR, BASE_BRANCHがあるか |
| 品質チェック | lint/format/typecheck/testコマンドがあるか |
| 検証方針 | テスト/E2E/スクショ/期待出力の指針があるか |
| レビュー方針 | critical不変条件・検証境界・エラーハンドリング方式・却下類型があるか（無ければ追加を提案） |
| @参照 | 詳細をcontext/に委譲しているか |
| 分離原則 | 人間向け/エージェント向けが分離されているか |
| コンテキスト除外 | 秘匿・不要パスがpermissions.denyのReadルールで除外されているか（.claudeignoreは公式機能に存在しない。残存していれば削除提案） |
| .claude/rules/ | パス固有ルールが活用されているか |
| user-level設定との重複 | 「サブエージェント呼び出し時の追加情報」「委譲必須」等、user-level AGENTS.md/context/に既にある内容が重複していないか |
| 過度な指示 | 「こまめに」「必ず」「逐次」等の過度な強制表現がないか（自律実行ベストプラクティス参照） |
## 更新提案
### CLAUDE.md
**現状:** XX行
**提案:** 以下に簡素化
```markdown
# <PJ名>
## 変数
MEMORY_DIR=.local/
BASE_BRANCH=develop
## 品質チェック
```bash
npm run lint
npm run format
npm run typecheck
npm test
### コンテキスト除外（必要な場合のみ）
**提案:** 秘匿・不要パスを `.claude/settings.json` の `permissions.deny` に追加
```json
{ "permissions": { "deny": ["Read(secrets/**)", "Read(*.pem)"] } }
（.claudeignoreは公式機能に存在しない。残存していれば削除を提案する）
提案: 以下を作成
---
paths:
- "src/api/**/*.ts"
---
# API開発ルール
### 4. ユーザー確認
ユーザーに選択肢を提示して以下を確認（Claude Code: AskUserQuestion）:
1. 更新提案の承認
2. 削除対象の確認（誤削除防止）
3. PJ固有の追加要件
### 5. 実行
承認後、以下を実行:
1. CLAUDE.mdの更新（肥大させず簡潔に。@context/claude-customization-guide.md §3参照）
2. コンテキスト除外設定の更新（必要な場合。permissions.denyのReadルール）
3. .claude/rules/の作成（必要な場合）
4. 不要ファイルの削除
5. ファイルの移動・リネーム
6. .claude/context/の作成（必要な場合）
### 6. 検証
```bash
# 行数確認
wc -l CLAUDE.md
# 構造確認
ls -la .claude/
@.claude/context/ へ委譲する）# <PJ名>
## 変数
MEMORY_DIR=<path>
BASE_BRANCH=<branch>
## 品質チェック
[コマンド一覧]
## 検証方針
[テスト/E2E/スクショ/期待出力の指針]
## レビュー方針
[critical不変条件 / 検証境界 / エラーハンドリング方式 / 却下類型]
## PJ固有ルール
[PJ固有ルール - 簡潔に。サブエージェント呼び出しの強制は記載しない]
quality-checker / pr-reviewer 等を必ず呼び出せ 等): user-levelの ~/.claude/context/tool-claude-code.md 「委譲判断」と重複・矛盾するためこまめに、必ず、絶対に 等の多用): 自律実行前提に反する| 判断 | 条件 |
|---|---|
| 削除 | 古いagent定義、重複ドキュメント、空ファイル、user-level重複指示（サブエージェント呼び出しの追加情報等） |
| 移動 | エージェント向け内容がdocs/にある場合 → .claude/context/ |
| 統合 | 類似内容の複数ファイル → 1ファイルに |
| 保持 | 人間向けドキュメント（README, docs/）、PJ固有設定 |
