insights-to-claude-md
Skill0 starsChanged 5 months agoMITView on GitHub
/insights レポートの摩擦分析から CLAUDE.md を系統的に改善するとき。発火は (1) ユーザーが /insights を実行してレポートが出た直後 (2) 同種の失敗・修正指示が2回以上繰り返されたと気づいた時 (3) 月次の CLAUDE.md 見直し時。前提として /insights レポート（またはそれに準ずる摩擦一覧）が手元にあること。
In this repository99 other files it gives its agents.
- agents-tools-quoted-jsonSkill
- asc-api-app-store-submitSkill
- asd-ste100Skill
- automation-bool-selector-pitfallsSkill
- automation-stale-cooldown-flagSkill
- autonomous-build-verifySkill
- book-to-skillSkill
- ccusage-cli-cost-trackingSkill
- chrome-ext-mv3-programmatic-injectSkill
- chrome-ext-store-assetsSkill
- claude-headless-p-invocationSkill
- claude-plugin-context-auditSkill
- claude-session-log-to-kbSkill
- cloudflare-workers-do-deploySkill
- codebase-to-courseSkill
- codesign-keychain-prompt-fixSkill
- codex-cli-setupSkill
- codex-delegation-handoffSkill
- content-factory-grounding-dedupSkill
- conversation-log-append-patternSkill
- cron-to-launchd-macosSkill
- cross-automation-shared-resource-killSkill
- design-token-migration-rnSkill
- discord-bot-image-to-claudeSkill
- discord-gateway-resume-dedupSkill
- excel-filtered-url-http-auditSkill
- execution-budget-vs-capsSkill
- expo-free-local-ios-testflightSkill
- ga4-connect-projectsSkill
- gcal-oauth-desktop-setupSkill
- git-commit-helperSkill
- git-prepush-secret-remote-checkSkill
- gsc-cli-automationSkill
- hatena-blogsync-autopostSkill
- hook-latency-wrapSkill
- hook-log-append-patternSkill
- html-to-pdf-slide-deckSkill
- humanizerSkill
- human-review-gate-shellSkill
- implementation-model-routingSkill
- ios-permission-key-security-matrixSkill
- ios-sim-store-screenshotsSkill
- launchd-exit78-exconfig-debugSkill
- llm-content-pipeline-quality-gateSkill
- local-ai-video-pipelineSkill
- local-flux-mflux-image-genSkill
- local-llm-slow-diagnosisSkill
- local-music-generationSkill
- lottie-skottie-authoring-pitfallsSkill
- machine-wide-api-ratelimit-latchSkill
- macos-hook-path-timeoutSkill
- md-to-docx-reportSkill
- memory-md-inject-bloat-auditSkill
- message-display-secrets-maskSkill
- metric-source-attributionSkill
- migrate-icloud-desktop-assetsSkill
- nextauth-local-e2e-sessionSkill
- nextjs-rsc-payload-slimSkill
- nothing-designSkill
- openclaw-ollama-setupSkill
- The first 60 shown.
The file
Files
Procedure
/insightsを実行してレポートを取得するfriction_analysis.categoriesを列挙し、各摩擦カテゴリを特定するsuggestions.claude_md_additionsの各additionを確認する- 追加先のセクションが CLAUDE.md に存在するか確認する
- 存在しない → 新規セクション
## <Section Name>を追加 - 存在する → 既存セクションに追記
- 存在しない → 新規セクション
- 各 addition を対応するセクションに箇条書きで挿入する
- よく使われる追加パターン（過去事例から）:
## API & Cost Constraints— 無料 API のみ使用、有料 API は明示承認が必要## Self-Verification— 自律ビルド後の出力確認をレポート前に必須化## Following Specs— 渡されたファイル・リストを正確に従う（全件処理禁止）## Security & Publishing— push 前の PII/APIキー スキャンとリモート確認## Deployment— push してからデプロイ確認を完了報告の条件にする
Pitfalls
- 既存ルールと矛盾する追加は禁止。追加前に既存 CLAUDE.md を全文確認する
- セクションを細かく分けすぎない。関連ルールは同セクションにまとめる
suggestions.features_to_tryは CLAUDE.md に書かず、別途 hooks や settings.json で実装する- 個人情報・財務情報など会話内の個人データはルール化しない
Verification
grep "## " ~/.claude/CLAUDE.mdで追加したセクションが存在するか確認- 摩擦カテゴリの数と追加セクション数が概ね対応していることを確認
- 追加後に Claude Code を再起動して新ルールが読み込まれるか確認（
/configで確認）
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.