docs: add research domains and resource registry

- add local external resources registry
- add research domain contract and per-repository research domains
- add raw fact snapshot governance and validation scripts

Validation:
- make test
- git diff --check HEAD~1..HEAD

Note:
- welcome workflow failed because its action input names are stale; core content CI passed.

docs/research/shanraisshan-claude-code-best-practice/AGENTS.md

@@ -0,0 +1,26 @@
+# shanraisshan/claude-code-best-practice 研究域 Agent 指南
+
+本目录维护 `shanraisshan/claude-code-best-practice` 的独立研究域。
+
+## 目录职责
+
+```text
+shanraisshan-claude-code-best-practice/
+├── README.md  # 研究域入口和判断层
+├── AGENTS.md  # 本目录维护规则
+├── domain.yml # 事实摘要层：仓库元数据、研究角色、来源证据
+├── analysis.md # L1 结构化研究结论、可借鉴点、风险和下一轮任务
+├── deep-dive.md # L2 源码/结构深度研究、关键机制和可迁移模式
+└── raw/       # 原始事实层：拉取到本地的一手材料快照
+```
+
+## 维护规则
+
+- 本目录只研究 `shanraisshan/claude-code-best-practice`，不要混入其他仓库的横向比较正文。
+- 动态事实必须写入 `domain.yml.github_observed`，并更新 `observed_at`。
+- `raw/` 保存原始事实层，必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
+- 不手工改写 `raw/*.raw.*` 文件；稳定事实摘要再同步到 `domain.yml`。
+- README 只写判断、定位、使用方式和后续观察点，不堆外部 README 全文。
+- `analysis.md` 写 L1 结构化理解；`deep-dive.md` 写 L2 源码证据、关键机制和可迁移模式。
+- 如果需要横向比较，在 `docs/research/README.md` 或新的对比文档中处理，不把本目录重新变成聚合域。
+- 修改后运行 `make sync-doc-toc` 和 `make test`。

docs/research/shanraisshan-claude-code-best-practice/README.md

@@ -0,0 +1,58 @@
+# shanraisshan/claude-code-best-practice 研究域
+
+## 字多不看
+
+- 本目录研究 `shanraisshan/claude-code-best-practice` 这个外部仓库。
+- 当前优先级：P1；研究角色：Claude Code / Agentic Engineering 最强对标。
+- GitHub 动态事实放在 `domain.yml`，观测日期为 2026-07-03。
+
+## 快速导航
+
+| 文档 | 定位 |
+|:---|:---|
+| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
+| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
+| [deep-dive.md](deep-dive.md) | L2 源码/结构深度研究、关键机制和可迁移模式。 |
+| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
+
+<details>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
+
+### 细粒度目录
+
+- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
+- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
+- [deep-dive.md](deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
+- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
+
+</details>
+
+## 使用方式
+
+- 先读本 README 的判断，再读 `analysis.md` 和 `deep-dive.md` 的研究结论，最后读 `domain.yml`。
+- 需要引用 stars、forks、release、归档状态时，先重新核验 GitHub。
+- 如果形成稳定方法论，再迁入 concepts、references、workflow 或 skills。
+
+## 正文
+
+### 研究定位
+
+`shanraisshan/claude-code-best-practice` 的当前研究定位是：Claude Code / Agentic Engineering 最强对标。
+
+### 当前判断
+
+适合研究从 Vibe Coding 到 Agentic Engineering 的方法论、commands、skills、hooks、MCP 与 workflow。
+
+### 观察字段
+
+- GitHub URL：https://github.com/shanraisshan/claude-code-best-practice
+- 当前研究方向：`agentic-engineering-methodology`
+- 当前优先级：P1
+- 当前归档状态：`false`
+- 主要语言：`HTML`
+
+### 后续观察
+
+- 是否有稳定文档结构、命令入口和可复用工作流。
+- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
+- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。

docs/research/shanraisshan-claude-code-best-practice/analysis.md

@@ -0,0 +1,44 @@
+# shanraisshan/claude-code-best-practice 研究分析
+
+## 本轮结论
+
+- 这是 Agentic Engineering 方法论和 Claude Code 资产集合，属于 P1 对标对象。
+- 它覆盖 concepts、development workflows、cross-model workflows、skill collections、agent collections、tips、orchestration 等层。
+- 本仓应重点吸收其 agent/team/workflow/skill 的组织方式，同时保持本仓自己的中文主线和质量门禁。
+
+## 本地证据
+
+- 研究对象：`shanraisshan/claude-code-best-practice`
+- 当前研究角色：Claude Code / Agentic Engineering 最强对标
+- 本轮成熟度：L1 初步理解
+- 原始仓库：`raw/repository/`
+- 原始来源清单：`raw/sources.yml`
+- 事实摘要：`domain.yml`
+
+## 结构观察
+
+- 根目录包含 `best-practice/`、`development-workflows/`、`orchestration-workflow/`、`agent-teams/`、`implementation/`、`tips/`、`tutorial/`、`reports/`。
+- 存在 `.claude/`、`.codex/`、`.mcp.json`、`CLAUDE.md`，说明它同时面向多个 AI 工具运行环境。
+- README 是大型导航页，入口多、概念密度高。
+
+## 可借鉴点
+
+- Agentic Engineering 需要把 workflow、agent team、skills、commands、MCP、tips 分层管理。
+- 跨模型/跨工具工作流应该作为研究对象，而不是只绑定某一个产品。
+- 大型方法论仓库需要强导航，否则会变成资料迷宫。
+
+## 风险和边界
+
+- 内容高度个人化，不能直接变成本仓标准。
+- 覆盖面很宽，容易冲淡本仓“Vibe Coding 中文教程 + 工程治理”的定位。
+- 需要区分 Claude Code 专属实践和通用 agent engineering 原则。
+
+## 下一轮研究任务
+
+- 重点拆读 `orchestration-workflow/`、`agent-teams/`、`development-workflows/`。
+- 输出与本仓 `skills/`、`workflow/`、`research-domain-contract.md` 的差距清单。
+
+## 沉淀判断
+
+- 本轮只完成 L1 理解，不直接迁入 concepts、references、workflow 或 skills。
+- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论，才进入稳定层。

docs/research/shanraisshan-claude-code-best-practice/deep-dive.md

@@ -0,0 +1,90 @@
+# shanraisshan/claude-code-best-practice 深度研究
+
+## 研究级别
+
+- 当前级别：L2 源码/结构深度研究。
+- 研究对象：`shanraisshan/claude-code-best-practice`。
+- 证据来源：本目录 `raw/` 下的 GitHub 元数据、README 快照和本地仓库工作树。
+- 观察日期：2026-07-03。
+
+## L2 结论
+
+`shanraisshan/claude-code-best-practice` 更像一个 Claude Code / Agentic Engineering 方法操作系统，
+不是单篇教程。它把最佳实践、实现文档、编排工作流、agent teams、reports、tips、videos、
+Claude 配置、Codex 配置和 MCP 配置放在同一个研究对象内，重点展示“如何把 AI 工程经验变成
+可复用操作资产”。
+
+对本仓最重要的启发是：方法论必须落到文件、配置、工作流、示例输出和报告中，否则就只是口号。
+
+## 源码证据
+
+- `raw/repository/CLAUDE.md`：Claude 项目级上下文入口。
+- `raw/repository/.mcp.json`：MCP 配置入口。
+- `raw/repository/.claude/settings.json`：Claude 配置。
+- `raw/repository/.codex/config.toml`：Codex 配置。
+- `raw/repository/.codex/hooks.json`：Codex hooks 配置。
+- `raw/repository/best-practice/claude-subagents.md`：subagents 最佳实践。
+- `raw/repository/best-practice/claude-skills.md`：skills 最佳实践。
+- `raw/repository/best-practice/claude-commands.md`：commands 最佳实践。
+- `raw/repository/best-practice/claude-mcp.md`：MCP 最佳实践。
+- `raw/repository/implementation/claude-subagents-implementation.md`：subagents 实现文档。
+- `raw/repository/implementation/claude-goal-implementation.md`：goal 实现文档。
+- `raw/repository/implementation/claude-skills-implementation.md`：skills 实现文档。
+- `raw/repository/orchestration-workflow/orchestration-workflow.md`：编排工作流说明。
+- `raw/repository/agent-teams/agent-teams-prompt.md`：agent teams prompt。
+- `raw/repository/reports/why-harness-is-important.md`：Harness 重要性报告。
+
+## 关键机制
+
+### 方法论被文件系统化
+
+这个仓库把 best practice、implementation、workflow、reports 和 tips 分开。它说明成熟经验不应该
+只放在 README，而应按用途进入不同层：原则、实现、编排、案例、报告和配置。
+
+### 配置是研究对象的一部分
+
+`.claude/`、`.codex/` 和 `.mcp.json` 说明 AI 工程不是纯文档工作。模型入口、工具入口、hooks、
+settings 和项目级上下文共同构成真实工作系统。
+
+### Agentic Engineering 强调编排
+
+`orchestration-workflow/` 和 `agent-teams/` 体现了从单 Agent 交互走向多角色、多步骤、可复用流程
+的趋势。这里的关键不是“多 Agent 数量”，而是任务边界、上下文分发、验收标准和输出归档。
+
+### 报告层提供反思和二次沉淀
+
+`reports/` 把经验、问题和工具比较沉淀成独立材料。这对于本仓很重要：研究域的最终价值不是
+收集资料，而是形成可复用判断。
+
+## 可迁移模式
+
+- 将经验分成 best-practice、implementation、workflow、reports 和 config 五层。
+- 对每条方法论要求至少能落到一个文件、一个流程、一个示例或一个检查项。
+- 将 hooks、settings、MCP 和项目上下文作为 AI 工程系统的一部分纳入治理。
+- 对复杂任务使用 agent teams 或任务树时，必须先定义职责、边界、输入输出和验收标准。
+- 重要结论需要有报告层，避免只在临时对话里消失。
+
+## 对本仓的影响
+
+本仓已经有 concepts、references、workflow、skills、research 和 governance 风格的资产雏形。
+下一步应让这些层级更明确：
+
+- principles 和 concepts 放底层认知。
+- references 放可复用模板、清单和结构。
+- workflow 放执行过程和门禁。
+- skills 放 Agent 可执行能力。
+- research 放未稳定的研究对象。
+- reports 或 analysis 放研究判断和阶段复盘。
+
+## 风险和待验证项
+
+- 该仓库强烈绑定 Claude Code 生态，本仓不能直接照搬为通用事实。
+- 个人方法论仓库容易混入偏好和风格判断，迁移时必须转成可验证契约。
+- 本轮没有验证其中 hooks、MCP、agent teams 的真实运行效果。
+
+## 下一步 L3 验证任务
+
+- 在本仓补一份“方法论如何下沉到 concepts/references/workflow/skills”的分流规则。
+- 对已有经验短句建立对应的可执行示例、检查项或技能入口。
+- 把复杂研究任务的 agent teams 模式整理成本仓自己的任务编排契约。
+- 将 Harness 相关结论与 `docs/research/harness/` 做交叉审计。

docs/research/shanraisshan-claude-code-best-practice/domain.yml

@@ -0,0 +1,52 @@
+version: 1
+repo:
+  name: shanraisshan/claude-code-best-practice
+  source_name: shanraisshan/claude-code-best-practice
+  url: https://github.com/shanraisshan/claude-code-best-practice
+research:
+  domain_id: shanraisshan-claude-code-best-practice
+  domain_name: shanraisshan/claude-code-best-practice 研究域
+  primary_direction: agentic-engineering-methodology
+  role: Claude Code / Agentic Engineering 最强对标
+  priority: 1
+  why_study: 适合研究从 Vibe Coding 到 Agentic Engineering 的方法论、commands、skills、hooks、MCP 与 workflow。
+github_observed:
+  observed_at: '2026-07-03'
+  source: gh repo view
+  stars: 61857
+  forks: 6189
+  archived: false
+  language: HTML
+  license: mit
+  default_branch: main
+  pushed_at: '2026-07-02T06:38:21Z'
+  updated_at: '2026-07-02T21:13:21Z'
+  latest_release: null
+  homepage: https://linkedin.com/in/shanraisshan
+  topics:
+  - claude-ai
+  - claude-code
+  - best-practices
+  - claude
+  - claude-code-best-practices
+  - agentic-engineering
+  - anthropic
+  - claude-code-agents
+  - claude-code-commands
+  - claude-code-skills
+  - vibe-coding
+  - boris
+  - agentic-ai
+  - agentic-coding
+  - agentic-workflow
+  - ai
+  - context-engineering
+  - pakistan
+  - pakistani-developer
+  - ai-agents
+source_evidence:
+  file: ChatGPT-中文Vibe Coding仓库 (2).md
+  line: 101
+maintenance:
+  fact_policy: GitHub 动态字段只代表 observed_at 当日快照，更新结论前必须重新核验。
+  split_policy: 本目录已经是一等研究域；更深分析放入本目录新增文档。

docs/research/shanraisshan-claude-code-best-practice/raw/AGENTS.md

@@ -0,0 +1,12 @@
+# raw/ Agent 指南
+
+本目录是 `shanraisshan/claude-code-best-practice` 的原始事实层。
+
+## 维护规则
+
+- 只保存从研究对象拉取的一手材料，不写分析判断。
+- `repository/` 是本地 Git 工作树，刷新时由脚本 clone 或 fast-forward pull。
+- 不手工改写 `*.raw.*` 文件内容；需要刷新时运行 `python3 scripts/fetch-research-raw.py`。
+- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
+- 外部 README 原文必须保存为 `.txt`，避免本仓库 Markdown 链接检查误判。
+- 分析、判断、采用建议和沉淀路径写回上一级 `README.md`、`analysis.md` 或 `decisions.md`。

docs/research/shanraisshan-claude-code-best-practice/raw/README.md

@@ -0,0 +1,16 @@
+# raw 事实层
+
+本目录保存 `shanraisshan/claude-code-best-practice` 的本地原始材料快照。
+
+这里不写分析结论，只保存可复查的一手资料：
+
+- `sources.yml`：来源清单、拉取时间、命令和文件状态。
+- `repository/`：Git 仓库工作树；本目录由 `.gitignore` 忽略，只作为本地研究材料。
+- `github-repo.raw.json`：GitHub 仓库元数据。
+- `github-readme.raw.md.txt`：GitHub README 原文快照。
+- `github-license.raw.txt`：GitHub license 原文快照；仓库无 license 时可能不存在。
+- `github-root-contents.raw.json`：默认分支根目录内容快照。
+- `github-languages.raw.json`：GitHub language 统计快照。
+- `github-latest-release.raw.json`：最新 release 快照；无 release 时可能不存在。
+
+`repository/` 是外部源码快照，不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存，避免其中的外部相对链接被本仓库 Markdown 链接检查误判。

docs/research/shanraisshan-claude-code-best-practice/raw/github-languages.raw.json

@@ -0,0 +1,4 @@
+{
+  "HTML": 593729,
+  "Python": 28999
+}

docs/research/shanraisshan-claude-code-best-practice/raw/github-license.raw.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Shayan Rais
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs/research/shanraisshan-claude-code-best-practice/raw/github-readme.raw.md.txt

@@ -0,0 +1,596 @@
+# claude-code-best-practice
+from vibe coding to agentic engineering - practice makes claude perfect
+
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-Jul%2002%2C%202026%209%3A22%20AM%20PKT-white?style=flat&labelColor=555) <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a><br>
+
+[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)<br>
+<img src="!/tags/a.svg" height="14"> = Agents · <img src="!/tags/c.svg" height="14"> = Commands · <img src="!/tags/s.svg" height="14"> = Skills
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="Claude Code mascot jumping" width="120" height="100"><br>
+  <a href="https://github.com/trending"><img src="!/root/github-trending-day.svg" alt="GitHub Trending #1 Repository Of The Day"></a>
+</p>
+
+<p align="center">
+  <img src="!/root/supported-label.svg" alt="Supported by:" height="34">&nbsp;&nbsp;<a href="https://disrupt.com/?utm_source=github&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-disrupt.svg" alt="Disrupt.com — Ventures Reimagined" height="34"></a>&nbsp;&nbsp;<a href="https://claudekit.cc/?utm_source=github&utm_medium=sponsorship&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-claudekit.svg" alt="ClaudeKit — Production-ready skills and workflows" height="34"></a>
+</p>
+
+<p align="center">
+  <img src="!/root/boris-slider.gif" alt="Boris Cherny on Claude Code" width="600"><br>
+  Boris Cherny on X (<a href="https://x.com/bcherny/status/2007179832300581177">tweet 1</a> · <a href="https://x.com/bcherny/status/2017742741636321619">tweet 2</a> · <a href="https://x.com/bcherny/status/2021699851499798911">tweet 3</a>)
+</p>
+
+> [!TIP]
+> Visit the [**How to Use**](#how-to-use) section to take full advantage of this repo.
+
+## 🧠 CONCEPTS
+
+| Feature | Location | Description |
+|---------|----------|-------------|
+| <img src="!/tags/a.svg" height="14"> [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/<name>.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-subagents.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-subagents-implementation.md) |
+| <img src="!/tags/c.svg" height="14"> [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/<name>.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-commands.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-commands-implementation.md) |
+| <img src="!/tags/s.svg" height="14"> [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills/<name>/SKILL.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-skills.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-skills-implementation.md) [Official Skills](https://github.com/anthropics/skills/tree/main/skills) · [Skills for Mono-repos](reports/claude-skills-for-larger-mono-repos.md) |
+| [**Workflows**](https://code.claude.com/docs/en/common-workflows) | [`.claude/commands/weather-orchestrator.md`](.claude/commands/weather-orchestrator.md) | [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) |
+| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-hooks) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/claude-code-hooks) [Guide](https://code.claude.com/docs/en/hooks-guide) |
+| [**MCP Servers**](https://code.claude.com/docs/en/mcp) | `.claude/settings.json`, `.mcp.json` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-mcp.md) [![Implemented](!/tags/implemented.svg)](.mcp.json) |
+| [**Plugins**](https://code.claude.com/docs/en/plugins) | distributable packages | [Marketplaces](https://code.claude.com/docs/en/discover-plugins) · [Create Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) |
+| [**Settings**](https://code.claude.com/docs/en/settings) | `.claude/settings.json` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-settings.md) [![Implemented](!/tags/implemented.svg)](.claude/settings.json) [Permissions](https://code.claude.com/docs/en/permissions) · [Model Config](https://code.claude.com/docs/en/model-config) · [Output Styles](https://code.claude.com/docs/en/output-styles) · [Sandboxing](https://code.claude.com/docs/en/sandboxing) · [Keybindings](https://code.claude.com/docs/en/keybindings) · [Auto Mode Config](https://code.claude.com/docs/en/auto-mode-config) |
+| [**Status Line**](https://code.claude.com/docs/en/statusline) | `.claude/settings.json` | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-status-line) [![Implemented](!/tags/implemented.svg)](.claude/settings.json) |
+| [**Memory**](https://code.claude.com/docs/en/memory) | `CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects/<project>/memory/` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-memory.md) [![Implemented](!/tags/implemented.svg)](CLAUDE.md) [Auto Memory](https://code.claude.com/docs/en/memory) · [Auto Memory Deep-dive](reports/claude-agent-memory.md) · [Rules](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
+| [**Checkpointing**](https://code.claude.com/docs/en/checkpointing) | automatic (file-edit tracking) |  |
+| [**CLI Startup Flags**](https://code.claude.com/docs/en/cli-reference) | `claude [flags]` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-cli-startup-flags.md) [Interactive Mode](https://code.claude.com/docs/en/interactive-mode) · [Env Vars](https://code.claude.com/docs/en/env-vars) |
+| **AI Terms** | | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) |
+| [**Best Practices**](https://code.claude.com/docs/en/best-practices) | | [Prompt Engineering](https://github.com/anthropics/prompt-eng-interactive-tutorial) · [Extend Claude Code](https://code.claude.com/docs/en/features-overview) |
+
+### 🔥 Hot
+
+| Feature | Location | Description |
+|---------|----------|-------------|
+| [**Ultrareview**](https://code.claude.com/docs/en/ultrareview) ![beta](!/tags/beta.svg) | `/code-review ultra`, `claude ultrareview [target]` | [Tasks tracking](https://code.claude.com/docs/en/ultrareview#track-a-running-review) |
+| [**Devcontainers**](https://code.claude.com/docs/en/devcontainer) | `.devcontainer/` |  |
+| [**Channels**](https://code.claude.com/docs/en/channels) ![beta](!/tags/beta.svg) | `--channels`, plugin-based | [Reference](https://code.claude.com/docs/en/channels-reference) |
+| [**Ultraplan**](https://code.claude.com/docs/en/ultraplan) ![beta](!/tags/beta.svg) | `/ultraplan` |  |
+| [**No Flicker Mode**](https://code.claude.com/docs/en/fullscreen) ![beta](!/tags/beta.svg) | `/tui fullscreen`, `CLAUDE_CODE_NO_FLICKER=1` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2039421575422980329) |
+| [**Auto Mode**](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) ![beta](!/tags/beta.svg) | `--permission-mode auto`, `Shift+Tab` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2036503582166393240) [Blog](https://claude.com/blog/auto-mode) |
+| [**Power-ups**](best-practice/claude-power-ups.md) | `/powerup` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-power-ups.md) |
+| [**Fast Mode**](https://code.claude.com/docs/en/fast-mode) ![beta](!/tags/beta.svg) | `/fast`, `"fastMode": true` |  |
+| [**Advisor**](https://code.claude.com/docs/en/advisor) ![beta](!/tags/beta.svg) | `/advisor`, `advisorModel`, `--advisor` | [Blog](https://claude.com/blog/the-advisor-strategy) |
+| [**Computer Use**](https://code.claude.com/docs/en/computer-use) ![beta](!/tags/beta.svg) | `computer-use` MCP server | [Desktop](https://code.claude.com/docs/en/desktop#let-claude-use-your-computer) |
+| [**Agent SDK**](https://code.claude.com/docs/en/agent-sdk/overview) | `npm` / `pip` package | [Quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart) · [Examples](https://github.com/anthropics/claude-agent-sdk-demos) |
+| [**Ralph Wiggum Loop**](https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum) | plugin | [![Best Practice](!/tags/best-practice.svg)](https://github.com/ghuntley/how-to-ralph-wiggum) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) |
+| [**Chrome**](https://code.claude.com/docs/en/chrome) ![beta](!/tags/beta.svg) | `--chrome`, extension | [![Best Practice](!/tags/best-practice.svg)](reports/claude-in-chrome-v-chrome-devtools-mcp.md) |
+| [**Claude Code Web**](https://code.claude.com/docs/en/claude-code-on-the-web) ![beta](!/tags/beta.svg) | `claude.ai/code` | [Routines](https://code.claude.com/docs/en/routines) |
+| [**Artifacts**](https://code.claude.com/docs/en/artifacts) ![beta](!/tags/beta.svg) | `/share`, `Artifact` tool |  |
+| [**Slack**](https://code.claude.com/docs/en/slack) | `@Claude` in Slack |  |
+| [**Code Review**](https://code.claude.com/docs/en/code-review) ![beta](!/tags/beta.svg) | GitHub App (managed) | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2031088171262554195) [Blog](https://claude.com/blog/code-review) [Local /code-review](https://code.claude.com/docs/en/commands) |
+| [**GitHub Actions**](https://code.claude.com/docs/en/github-actions) | `.github/workflows/` | [GitLab CI/CD](https://code.claude.com/docs/en/gitlab-ci-cd) |
+| [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/noahzweben/status/2032533699116355819) [Headless Mode](https://code.claude.com/docs/en/headless) |
+| [**Deep Links**](https://code.claude.com/docs/en/deep-links) | `claude-cli://open?repo=…&q=…` |  |
+| [**Dynamic Workflows**](https://code.claude.com/docs/en/workflows) | `/workflows`, `ultracode` keyword, `/effort ultracode`, `.claude/workflows/` | [Deep Research](https://code.claude.com/docs/en/workflows#run-a-bundled-workflow) |
+| [**Agent Teams**](https://code.claude.com/docs/en/agent-teams) ![beta](!/tags/beta.svg) | built-in (env var) | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2019472394696683904) [![Implemented](!/tags/implemented.svg)](implementation/claude-agent-teams-implementation.md) |
+| [**Agent View**](https://code.claude.com/docs/en/agent-view) ![beta](!/tags/beta.svg) | `claude agents`, `--bg`, `/bg` |  |
+| [**Scheduled Tasks**](https://code.claude.com/docs/en/scheduled-tasks) | `/loop`, `/schedule`, cron tools | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2030193932404150413) [![Implemented](!/tags/implemented.svg)](implementation/claude-scheduled-tasks-implementation.md) [Desktop scheduled tasks](https://code.claude.com/docs/en/desktop-scheduled-tasks) · [Announcement](https://x.com/noahzweben/status/2036129220959805859) |
+| [**Routines**](https://code.claude.com/docs/en/routines) ![beta](!/tags/beta.svg) | `claude.ai/code/routines`, `/schedule` | [Desktop Tasks](https://code.claude.com/docs/en/desktop-scheduled-tasks) |
+| [**Tasks**](reports/claude-global-vs-project-settings.md#tasks-system) | `/tasks`, `~/.claude/tasks/` | [![Best Practice](!/tags/best-practice.svg)](reports/claude-global-vs-project-settings.md) [Ultrareview tracking](https://code.claude.com/docs/en/ultrareview#track-a-running-review) |
+| [**Goal**](https://code.claude.com/docs/en/goal) | `/goal <condition>`, `/goal clear` | [![Implemented](!/tags/implemented.svg)](implementation/claude-goal-implementation.md) |
+| [**Voice Dictation**](https://code.claude.com/docs/en/voice-dictation) ![beta](!/tags/beta.svg) | `/voice` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/trq212/status/2028628570692890800) |
+| [**Bundled Skills**](https://code.claude.com/docs/en/skills#bundled-skills) | `/code-review`, `/batch` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2027534984534544489) |
+| [**Git Worktrees**](https://code.claude.com/docs/en/worktrees) | `--worktree`/`-w`, `.worktreeinclude`, `EnterWorktree`/`ExitWorktree`, `isolation: "worktree"`, `WorktreeCreate`/`WorktreeRemove` hooks | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2025007393290272904) |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+<a id="orchestration-workflow"></a>
+
+## <a href="orchestration-workflow/orchestration-workflow.md"><img src="!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>
+
+See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) for implementation details of <img src="!/tags/c.svg" height="14"> **Command** → <img src="!/tags/a.svg" height="14"> **Agent** → <img src="!/tags/s.svg" height="14"> **Skill** pattern.
+
+
+<p align="center">
+  <img src="orchestration-workflow/orchestration-workflow.svg" alt="Command Skill Agent Architecture Flow" width="100%">
+</p>
+
+<p align="center">
+  <img src="orchestration-workflow/orchestration-workflow.gif" alt="Orchestration Workflow Demo" width="600">
+</p>
+
+![How to Use](!/tags/how-to-use.svg)
+
+```bash
+claude
+/weather-orchestrator
+```
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## ⚙️ DEVELOPMENT WORKFLOWS
+
+All major workflows converge on the same architectural pattern: **Research → Plan → Execute → Review → Ship**
+
+| Name | ★ | Workflow | <img src="!/tags/a.svg" height="14"> | <img src="!/tags/c.svg" height="14"> | <img src="!/tags/s.svg" height="14"> |
+|------|---|----------|---|---|---|
+| [Superpowers](https://github.com/obra/superpowers) | 244k | <img src="https://img.shields.io/badge/brainstorming-ddf4ff" alt="brainstorming" align="middle"> → <img src="https://img.shields.io/badge/using--git--worktrees-ddf4ff" alt="using-git-worktrees" align="middle"> → <img src="https://img.shields.io/badge/writing--plans-ddf4ff" alt="writing-plans" align="middle"> → <img src="https://img.shields.io/badge/subagent--driven--development-ddf4ff" alt="subagent-driven-development" align="middle"> → <img src="https://img.shields.io/badge/implementer-fff3b0" alt="implementer" align="middle"> → <img src="https://img.shields.io/badge/task--reviewer-fff3b0" alt="task-reviewer" align="middle"> → <img src="https://img.shields.io/badge/fix--subagent-fff3b0" alt="fix-subagent" align="middle"> → <img src="https://img.shields.io/badge/final--code--reviewer-fff3b0" alt="final-code-reviewer" align="middle"> → <img src="https://img.shields.io/badge/test--driven--development-fff3b0" alt="test-driven-development" align="middle"> → <img src="https://img.shields.io/badge/requesting--code--review-ddf4ff" alt="requesting-code-review" align="middle"> → <img src="https://img.shields.io/badge/verification--before--completion-ddf4ff" alt="verification-before-completion" align="middle"> → <img src="https://img.shields.io/badge/finishing--a--development--branch-ddf4ff" alt="finishing-a-development-branch" align="middle"> | 0 | 0 | 14 |
+| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 225k | <img src="https://img.shields.io/badge/%2Fecc:plan-ddf4ff" alt="/ecc:plan" align="middle"> → <img src="https://img.shields.io/badge/%2Ftdd-ddf4ff" alt="/tdd" align="middle"> → <img src="https://img.shields.io/badge/%2Fcode--review-ddf4ff" alt="/code-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fsecurity--scan-ddf4ff" alt="/security-scan" align="middle"> → <img src="https://img.shields.io/badge/%2Fe2e-ddf4ff" alt="/e2e" align="middle"> → <img src="https://img.shields.io/badge/merge-ddf4ff" alt="merge" align="middle"> | 67 | 84 | 277 |
+| [Matt Pocock Skills](https://github.com/mattpocock/skills) | 153k | <img src="https://img.shields.io/badge/%2Fask--matt-ddf4ff" alt="/ask-matt" align="middle"> → <img src="https://img.shields.io/badge/%2Fgrill--with--docs-ddf4ff" alt="/grill-with-docs" align="middle"> → <img src="https://img.shields.io/badge/%2Fto--prd-ddf4ff" alt="/to-prd" align="middle"> → <img src="https://img.shields.io/badge/%2Fto--issues-ddf4ff" alt="/to-issues" align="middle"> → <img src="https://img.shields.io/badge/%2Fprototype-ddf4ff" alt="/prototype" align="middle"> → <img src="https://img.shields.io/badge/%2Ftriage-ddf4ff" alt="/triage" align="middle"> → <img src="https://img.shields.io/badge/%2Ftdd-fff3b0" alt="/tdd" align="middle"> → <img src="https://img.shields.io/badge/%2Fdiagnosing--bugs-fff3b0" alt="/diagnosing-bugs" align="middle"> → <img src="https://img.shields.io/badge/%2Fimprove--codebase--architecture-ddf4ff" alt="/improve-codebase-architecture" align="middle"> → <img src="https://img.shields.io/badge/%2Fhandoff-ddf4ff" alt="/handoff" align="middle"> | 0 | 0 | 36 |
+| [gstack](https://github.com/garrytan/gstack) | 119k | <img src="https://img.shields.io/badge/%2Foffice--hours-ddf4ff" alt="/office-hours" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--ceo--review-ddf4ff" alt="/plan-ceo-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--eng--review-fff3b0" alt="/plan-eng-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--design--review-fff3b0" alt="/plan-design-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--devex--review-fff3b0" alt="/plan-devex-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fspec-ddf4ff" alt="/spec" align="middle"> → <img src="https://img.shields.io/badge/%2Fdesign--consultation-fff3b0" alt="/design-consultation" align="middle"> → <img src="https://img.shields.io/badge/%2Freview-ddf4ff" alt="/review" align="middle"> → <img src="https://img.shields.io/badge/%2Fqa-ddf4ff" alt="/qa" align="middle"> → <img src="https://img.shields.io/badge/%2Fship-ddf4ff" alt="/ship" align="middle"> → <img src="https://img.shields.io/badge/%2Fland--and--deploy-ddf4ff" alt="/land-and-deploy" align="middle"> → <img src="https://img.shields.io/badge/%2Fcanary-ddf4ff" alt="/canary" align="middle"> → <img src="https://img.shields.io/badge/%2Fretro-ddf4ff" alt="/retro" align="middle"> | 0 | 0 | 53 |
+| [Spec Kit](https://github.com/github/spec-kit) | 117k | <img src="https://img.shields.io/badge/%2Fspeckit.constitution-ddf4ff" alt="/speckit.constitution" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.specify-ddf4ff" alt="/speckit.specify" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.plan-ddf4ff" alt="/speckit.plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.tasks-ddf4ff" alt="/speckit.tasks" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.implement-ddf4ff" alt="/speckit.implement" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.analyze-fff3b0" alt="/speckit.analyze" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.checklist-fff3b0" alt="/speckit.checklist" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.converge-ddf4ff" alt="/speckit.converge" align="middle"> | 0 | 10 | 0 |
+| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 65k | <img src="https://img.shields.io/badge/%2Fgsd--new--project-ddf4ff" alt="/gsd-new-project" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--spec--phase-ddf4ff" alt="/gsd-spec-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--plan--phase-ddf4ff" alt="/gsd-plan-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--execute--phase-ddf4ff" alt="/gsd-execute-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--code--review-fff3b0" alt="/gsd-code-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--validate--phase-fff3b0" alt="/gsd-validate-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--ship-ddf4ff" alt="/gsd-ship" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--extract--learnings-ddf4ff" alt="/gsd-extract-learnings" align="middle"> | 33 | 67 | 0 |
+| [agent-skills](https://github.com/addyosmani/agent-skills) | 61k | <img src="https://img.shields.io/badge/%2Fspec-ddf4ff" alt="/spec" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan-ddf4ff" alt="/plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fbuild-ddf4ff" alt="/build" align="middle"> → <img src="https://img.shields.io/badge/%2Ftest-ddf4ff" alt="/test" align="middle"> → <img src="https://img.shields.io/badge/%2Freview-ddf4ff" alt="/review" align="middle"> → <img src="https://img.shields.io/badge/%2Fship-ddf4ff" alt="/ship" align="middle"> | 3 | 7 | 21 |
+| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 58k | <img src="https://img.shields.io/badge/%2Fopsx:explore-ddf4ff" alt="/opsx:explore" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:propose-ddf4ff" alt="/opsx:propose" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:new-fff3b0" alt="/opsx:new" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:continue-fff3b0" alt="/opsx:continue" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:ff-fff3b0" alt="/opsx:ff" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:apply-ddf4ff" alt="/opsx:apply" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:verify-ddf4ff" alt="/opsx:verify" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:sync-ddf4ff" alt="/opsx:sync" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:archive-ddf4ff" alt="/opsx:archive" align="middle"> | 0 | 11 | 0 |
+| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 50k | <img src="https://img.shields.io/badge/bmad--forge--idea-ddf4ff" alt="bmad-forge-idea" align="middle"> → <img src="https://img.shields.io/badge/bmad--product--brief-ddf4ff" alt="bmad-product-brief" align="middle"> → <img src="https://img.shields.io/badge/bmad--create--prd-ddf4ff" alt="bmad-create-prd" align="middle"> → <img src="https://img.shields.io/badge/bmad--validate--prd-fff3b0" alt="bmad-validate-prd" align="middle"> → <img src="https://img.shields.io/badge/bmad--edit--prd-fff3b0" alt="bmad-edit-prd" align="middle"> → <img src="https://img.shields.io/badge/bmad--create--architecture-ddf4ff" alt="bmad-create-architecture" align="middle"> → <img src="https://img.shields.io/badge/bmad--create--epics--and--stories-ddf4ff" alt="bmad-create-epics-and-stories" align="middle"> → <img src="https://img.shields.io/badge/bmad--create--story-fff3b0" alt="bmad-create-story" align="middle"> → <img src="https://img.shields.io/badge/bmad--dev--story-fff3b0" alt="bmad-dev-story" align="middle"> → <img src="https://img.shields.io/badge/bmad--dev--auto-fff3b0" alt="bmad-dev-auto" align="middle"> → <img src="https://img.shields.io/badge/bmad--code--review-ddf4ff" alt="bmad-code-review" align="middle"> → <img src="https://img.shields.io/badge/bmad--sprint--status-ddf4ff" alt="bmad-sprint-status" align="middle"> → <img src="https://img.shields.io/badge/bmad--checkpoint--preview-ddf4ff" alt="bmad-checkpoint-preview" align="middle"> → <img src="https://img.shields.io/badge/bmad--retrospective-ddf4ff" alt="bmad-retrospective" align="middle"> | 6 | 0 | 42 |
+| [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) | 37k | <img src="https://img.shields.io/badge/team--plan-ddf4ff" alt="team-plan" align="middle"> → <img src="https://img.shields.io/badge/team--prd-ddf4ff" alt="team-prd" align="middle"> → <img src="https://img.shields.io/badge/team--exec-ddf4ff" alt="team-exec" align="middle"> → <img src="https://img.shields.io/badge/team--verify-ddf4ff" alt="team-verify" align="middle"> → <img src="https://img.shields.io/badge/team--fix-fff3b0" alt="team-fix" align="middle"> → <img src="https://img.shields.io/badge/team--verify-fff3b0" alt="team-verify" align="middle"> | 19 | 0 | 40 |
+| [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | 22k | <img src="https://img.shields.io/badge/%2Fce--strategy-ddf4ff" alt="/ce-strategy" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--ideate-ddf4ff" alt="/ce-ideate" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--brainstorm-ddf4ff" alt="/ce-brainstorm" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--plan-ddf4ff" alt="/ce-plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--work-ddf4ff" alt="/ce-work" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--code--review-ddf4ff" alt="/ce-code-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--compound-ddf4ff" alt="/ce-compound" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--product--pulse-ddf4ff" alt="/ce-product-pulse" align="middle"> | 0 | 1 | 27 |
+| [HumanLayer](https://github.com/humanlayer/humanlayer) | 11k | <img src="https://img.shields.io/badge/%2Fresearch__codebase-ddf4ff" alt="/research_codebase" align="middle"> → <img src="https://img.shields.io/badge/%2Fcreate__plan-ddf4ff" alt="/create_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fvalidate__plan-fff3b0" alt="/validate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fiterate__plan-fff3b0" alt="/iterate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fimplement__plan-ddf4ff" alt="/implement_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Flocal__review-ddf4ff" alt="/local_review" align="middle"> → <img src="https://img.shields.io/badge/%2Fcreate__handoff-ddf4ff" alt="/create_handoff" align="middle"> → <img src="https://img.shields.io/badge/%2Fresume__handoff-ddf4ff" alt="/resume_handoff" align="middle"> → <img src="https://img.shields.io/badge/%2Fcommit-ddf4ff" alt="/commit" align="middle"> → <img src="https://img.shields.io/badge/%2Fdescribe__pr-ddf4ff" alt="/describe_pr" align="middle"> | 6 | 27 | 0 |
+
+> *Note: yellow tags are sub-loops — steps that repeat inside a parent step (e.g. per task, per story, or until a verify condition passes).*
+
+### Others
+- [RPI](development-workflows/rpi/rpi-workflow.md) [![Implemented](!/tags/implemented.svg)](development-workflows/rpi/rpi-workflow.md)
+- [Ralph Wiggum Loop](https://www.youtube.com/watch?v=eAtvoGlpeRU) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop)
+- [Andrej Karpathy (Founding Member, OpenAI) Workflow](https://x.com/karpathy/status/2015883857489522876)
+- [Peter Steinberger (Creator of OpenClaw) Workflow](https://youtu.be/8lF7HmQ_RgY?t=2582)
+- Boris Cherny (Creator of Claude Code) Workflow — [13 Tips](tips/claude-boris-13-tips-03-jan-26.md) · [10 Tips](tips/claude-boris-10-tips-01-feb-26.md) · [12 Tips](tips/claude-boris-12-tips-12-feb-26.md) · [2 Tips](tips/claude-boris-2-tips-25-mar-26.md) · [15 Tips](tips/claude-boris-15-tips-30-mar-26.md) · [6 Tips](tips/claude-boris-6-tips-16-apr-26.md) [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny)
+- Thariq (Anthropic) Workflow — [Skills](tips/claude-thariq-tips-17-mar-26.md) · [Session Management](tips/claude-thariq-tips-16-apr-26.md) [![Thariq](!/tags/thariq.svg)](https://x.com/trq212)
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 🔀 CROSS-MODEL WORKFLOWS
+
+Use Claude Code together with other models — Codex, Gemini, GPT, Kimi, DeepSeek, local — via three mechanisms:
+
+- **Plugin** — another model's CLI runs inside Claude Code (slash commands like `/codex:review`)
+- **MCP** — Claude Code calls another model as a tool through Model Context Protocol
+- **Router** — Claude Code's API endpoint is swapped to a different provider
+
+Methodology: [Cross-Model (Claude Code + Codex) Workflow](development-workflows/cross-model-workflow/cross-model-workflow.md) [![Implemented](!/tags/implemented.svg)](development-workflows/cross-model-workflow/cross-model-workflow.md) — manual two-terminal flow with Plan in Claude, QA-Review in Codex.
+
+| Name | ★ | Type | Bridges to | What it does |
+|------|---|------|------------|--------------|
+| [musistudio/claude-code-router](https://github.com/musistudio/claude-code-router) | 34k | Router | OpenRouter, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq, +more | Routes Claude Code's API to any compatible provider, with per-task model selection |
+| [router-for-me/CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) | 32k | Router | Gemini CLI, Codex, Claude Code, Antigravity | Wraps each CLI as an OpenAI/Gemini/Claude/Codex-compatible API service |
+| [openai/codex-plugin-cc](https://github.com/openai/codex-plugin-cc) | 18k | Plugin | Codex / GPT-5 | Official OpenAI plugin: `/codex:review`, `/codex:adversarial-review`, `/codex:rescue` inside Claude Code |
+| [BeehiveInnovations/pal-mcp-server](https://github.com/BeehiveInnovations/pal-mcp-server) | 12k | MCP | Gemini, OpenAI, Azure, Grok, Ollama, OpenRouter (50+ models) | Multi-model MCP server (formerly `zen-mcp-server`) — call other models as Claude tools |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 🧰 SKILL COLLECTIONS
+
+Repos primarily known as curated libraries of `SKILL.md` files (distinct from full workflow methodologies above). Sorted by stars descending.
+
+| Name | ★ | <img src="!/tags/s.svg" height="14"> |
+|------|---|---|
+| [anthropics/skills](https://github.com/anthropics/skills) | 157k | 12 |
+| [mattpocock/skills](https://github.com/mattpocock/skills) | 153k | 32 |
+| [Egonex-AI/Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) | 67k | 8 |
+| [wshobson/agents](https://github.com/wshobson/agents) | 37k | 158 |
+| [scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) | 30k | 148 |
+| [impeccable](https://github.com/pbakaus/impeccable) | 27k | 1 (with 7 design domain references) |
+| [agent-skills](https://github.com/addyosmani/agent-skills) | 27k | 21 |
+| [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 27k | 1,497+ (curated list) |
+| [claude-skills](https://github.com/alirezarezvani/claude-skills) | 15k | 246 (across 9 domains) |
+| [shanraisshan/draw-json-architecture-skill](https://github.com/shanraisshan/draw-json-architecture-skill) | 3 | 1 |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 🤖 AGENT COLLECTIONS
+
+Repos primarily known as curated libraries of subagent definitions (`.claude/agents/*.md`). Sorted by stars descending.
+
+| Name | ★ | <img src="!/tags/a.svg" height="14"> |
+|------|---|---|
+| [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 121k | 232 |
+| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 23k | 156 |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 💡 TIPS AND TRICKS (83)
+
+🚫👶 = do not babysit
+
+[Prompting](#tips-prompting) · [Planning](#tips-planning) · [Context](#tips-context) · [Session](#tips-session) · [CLAUDE.md + .claude/rules](#tips-claudemd) · [Agents](#tips-agents) · [Commands](#tips-commands) · [Skills](#tips-skills) · [Hooks](#tips-hooks) · [Workflows](#tips-workflows) · [Advanced](#tips-workflows-advanced) · [Git / PR](#tips-git-pr) · [Debugging](#tips-debugging) · [Utilities](#tips-utilities) · [Daily](#tips-daily)
+
+![Community](!/tags/community.svg)
+
+<a id="tips-prompting"></a>■ **Prompting (3)**
+
+| Tip | Source |
+|-----|--------|
+| challenge Claude — "grill me on these changes and don't make a PR until I pass your test." or "prove to me this works" and have Claude diff between main and your branch 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) |
+| after a mediocre fix — "knowing everything you know now, scrap this and implement the elegant solution" 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) |
+| Claude fixes most bugs by itself — paste the bug, say "fix", don't micromanage how 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742750473720121) |
+
+<a id="tips-planning"></a>■ **Planning/Specs (7)**
+
+| Tip | Source |
+|-----|--------|
+| always start with [plan mode](https://code.claude.com/docs/en/common-workflows) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179845336527000) |
+| start with a minimal spec or prompt and ask Claude to interview you using [AskUserQuestion](https://code.claude.com/docs/en/cli-reference) tool, then make a new session to execute the spec | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2005315275026260309) |
+| always make a phase-wise gated plan, with each phase having multiple tests (unit, automation, integration) | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1032) |
+| break PRDs into vertical slices (tracer bullets) that cross all layers (DB + service + UI) — AI defaults to horizontal phasing (DB phase, then API phase, then frontend phase) which delays end-to-end feedback until the last phase. From the Pragmatic Programmer 🚫👶 | [![Matt](!/tags/community-matt.svg)](videos/claude-matt-pocock-24-apr-26.md) [![Video](!/tags/video.svg)](https://youtu.be/-QFHIoCo-Ko) |
+| spin up a second Claude to review your plan as a staff engineer, or use [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) for review | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742745365057733) |
+| write detailed specs and reduce ambiguity before handing work off — the more specific you are, the better the output | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) |
+| prototype > PRD — build 20-30 versions instead of writing specs, the cost of building is low so take many shots | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3630) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3630) |
+
+<a id="tips-context"></a>■ **Context (5)**
+
+| Tip | Source |
+|-----|--------|
+| context rot kicks in around ~300-400k tokens on the 1M context model — don't let sessions drift past that for intelligence-sensitive work | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| dumb zone kicks in around ~40% context — "you hit this point where you have degrading results". Newcomers: "shoot to keep it under 40%, and if you get up to 60%, think about wrapping it up". Experienced: "aggressively keep it below 30%" — push to 60% only on simple tasks. Manual [/compact](https://code.claude.com/docs/en/interactive-mode) or [/clear](https://code.claude.com/docs/en/cli-reference) to reset when switching tasks | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1541) |
+| rewind > correct — double-Esc or [/rewind](https://code.claude.com/docs/en/checkpointing) back to before the failed attempt and re-prompt with what you learned, instead of leaving failed attempts + corrections polluting context 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| [/compact](https://code.claude.com/docs/en/interactive-mode) with a hint (/compact focus on the auth refactor, drop the test debugging) beats letting autocompact fire — the model is at its least intelligent point when auto-compacting due to context rot | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| use subagents for context management — ask yourself "will I need this tool output again, or just the conclusion?" — 20 file reads + 12 greps + 3 dead ends stay in the child's context, only the final report returns 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+
+<a id="tips-session"></a>■ **Session Management (6)**
+
+| Tip | Source |
+|-----|--------|
+| every turn is a branching point — after Claude ends a turn, pick between Continue, /rewind, /clear, /compact, or Subagent based on how much existing context you need to carry forward | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| new task = new session — related tasks (e.g. writing docs for what you just built) can reuse context for efficiency, but genuinely new tasks deserve a fresh session | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| use "summarize from here" before rewinding to have Claude write a handoff message — like a note to the previous iteration of Claude from its future self | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| /compact vs /clear — compact is lossy but momentum-friendly (mid-task, fuzzy details ok); /clear + brief is more work but you control exactly what carries forward (high-stakes next step) | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) |
+| use recaps for long-running sessions — short summaries of what Claude did and what's next, useful when returning after minutes or hours. Disable with recaps in /config | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+| [/rename](https://code.claude.com/docs/en/cli-reference) important sessions (e.g. [TODO - refactor task]) and [/resume](https://code.claude.com/docs/en/cli-reference) them later — label each instance when running multiple Claudes simultaneously | [![Cat](!/tags/cat-wu.svg)](https://every.to/podcast/how-to-use-claude-code-like-the-people-who-built-it) |
+
+<a id="tips-claudemd"></a>■ **CLAUDE.md + .claude/rules (8)**
+
+| Tip | Source |
+|-----|--------|
+| [CLAUDE.md](https://code.claude.com/docs/en/memory) should target under [200 lines](https://code.claude.com/docs/en/memory#write-effective-instructions) per file. [60 lines in humanlayer](https://www.humanlayer.dev/blog/writing-a-good-claude-md) ([still not 100% guaranteed](https://www.reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179840848597422) [![Dex](!/tags/community-dex.svg)](https://www.humanlayer.dev/blog/writing-a-good-claude-md) |
+| .claude/rules/*.md auto-load into every session like CLAUDE.md — add paths: YAML frontmatter to lazy-load them only when Claude touches files matching the glob | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
+| wrap domain-specific CLAUDE.md rules in [\<important if="..."\> tags](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) to stop Claude from ignoring them as files grow longer | [![Dex](!/tags/community-dex.svg)](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) |
+| use [multiple CLAUDE.md](best-practice/claude-memory.md) for monorepos — ancestor + descendant loading | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2016339448863355206) |
+| use [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) to split large instructions | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
+| any developer should be able to launch Claude, say "run the tests" and it works on the first try — if it doesn't, your CLAUDE.md is missing essential setup/build/test commands | [![Dex](!/tags/community-dex.svg)](https://x.com/dexhorthy/status/2034713765401551053) |
+| keep codebases clean and finish migrations — partially migrated frameworks confuse models that might pick the wrong pattern | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=1112) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=1112) |
+| use [settings.json](best-practice/claude-settings.md) for harness-enforced behavior (attribution, permissions, model) — don't put "NEVER add Co-Authored-By" in CLAUDE.md when attribution.commit: "" is deterministic | [![davila7](!/tags/community-davila7.svg)](https://x.com/dani_avila7/status/2036182734310195550) |
+
+<a id="tips-agents"></a><img src="!/tags/a.svg" height="14"> **Agents (4)**
+
+| Tip | Source |
+|-----|--------|
+| have feature specific [sub-agents](https://code.claude.com/docs/en/sub-agents) (extra context) with [skills](https://code.claude.com/docs/en/skills) (progressive disclosure) instead of general qa, backend engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179850139000872) |
+| say "use subagents" to throw more compute at a problem — offload tasks to keep your main context clean and focused 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) |
+| [agent teams with tmux](https://code.claude.com/docs/en/agent-teams) and [git worktrees](https://x.com/bcherny/status/2025007393290272904) for parallel development | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2025007393290272904) |
+| use [test time compute](https://code.claude.com/docs/en/sub-agents) — separate context windows make results better; one agent can cause bugs and another (same model) can find them | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031151689219321886) |
+
+<a id="tips-commands"></a><img src="!/tags/c.svg" height="14"> **Commands (3)**
+
+| Tip | Source |
+|-----|--------|
+| use [commands](https://code.claude.com/docs/en/slash-commands) for your workflows instead of [sub-agents](https://code.claude.com/docs/en/sub-agents) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) |
+| use [slash commands](https://code.claude.com/docs/en/slash-commands) for every "inner loop" workflow you do many times a day — saves repeated prompting, commands live in .claude/commands/ and are checked into git | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) |
+| if you do something more than once a day, turn it into a [skill](https://code.claude.com/docs/en/skills) or [command](https://code.claude.com/docs/en/slash-commands) — build /techdebt, context-dump, or analytics commands | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742748984742078) |
+
+<a id="tips-skills"></a><img src="!/tags/s.svg" height="14"> **Skills (9)**
+
+| Tip | Source |
+|-----|--------|
+| use [context: fork](https://code.claude.com/docs/en/skills) to run a skill in an isolated subagent — main context only sees the final result, not intermediate tool calls. The agent field lets you set the subagent type | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2033603164398883042) |
+| use [skills in subfolders](reports/claude-skills-for-larger-mono-repos.md) for monorepos | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/skills) |
+| skills are folders, not files — use references/, scripts/, examples/ subdirectories for [progressive disclosure](https://code.claude.com/docs/en/skills) | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| build a Gotchas section in every skill — highest-signal content, add Claude's failure points over time | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| skill description field is a trigger, not a summary — write it for the model ("when should I fire?") | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| don't state the obvious in skills — focus on what pushes Claude out of its default behavior 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| don't railroad Claude in skills — give goals and constraints, not prescriptive step-by-step instructions 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| include scripts and libraries in skills so Claude composes rather than reconstructs boilerplate | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| embed !command in SKILL.md to inject dynamic shell output into the prompt — Claude runs it on invocation and the model only sees the result | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2034337963820327017) |
+
+<a id="tips-hooks"></a>■ **Hooks (5)**
+
+| Tip | Source |
+|-----|--------|
+| use [on-demand hooks](https://code.claude.com/docs/en/skills) in skills — /careful blocks destructive commands, /freeze blocks edits outside a directory | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| [measure skill usage](https://code.claude.com/docs/en/skills) with a PreToolUse hook to find popular or undertriggering skills | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| use a [PostToolUse hook](https://code.claude.com/docs/en/hooks) to auto-format code — Claude generates well-formatted code, the hook handles the last 10% to avoid CI failures | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179852047335529) |
+| route [permission requests](https://code.claude.com/docs/en/hooks) to Opus via a hook — let it scan for attacks and auto-approve safe ones 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) |
+| use a [Stop hook](https://code.claude.com/docs/en/hooks) to nudge Claude to keep going or verify its work at the end of a turn | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701059253874861) |
+
+<a id="tips-workflows"></a>■ **Workflows (5)**
+
+| Tip | Source |
+|-----|--------|
+| use [/model](https://code.claude.com/docs/en/model-config) to select model and reasoning, [/context](https://code.claude.com/docs/en/interactive-mode) to see context usage, [/usage](https://code.claude.com/docs/en/costs) to check plan limits, [/extra-usage](https://code.claude.com/docs/en/interactive-mode) to configure overflow billing, [/config](https://code.claude.com/docs/en/settings) to configure settings — use Opus for plan mode and Sonnet for code to get the best of both | [![Cat](!/tags/cat-wu.svg)](https://x.com/_catwu/status/1955694117264261609) |
+| always use [thinking mode](https://code.claude.com/docs/en/model-config) true (to see reasoning) and [Output Style](https://code.claude.com/docs/en/output-styles) Explanatory (to see detailed output with ★ Insight boxes) in [/config](https://code.claude.com/docs/en/settings) for better understanding of Claude's decisions | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179838864666847) |
+| use ultrathink keyword in prompts for [high effort reasoning](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | [![Claude](!/tags/claude.svg)](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) |
+| /focus mode hides all intermediate work and shows only the final result — trust the model to run the right commands and just look at the outcome (toggle with /focus) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+| tune effort level with Opus 4.7's adaptive thinking — low for speed and fewer tokens, max for most intelligence (slider: low · medium · high · xhigh · max) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+
+<a id="tips-workflows-advanced"></a>■ **Workflows Advanced (9)**
+
+| Tip | Source |
+|-----|--------|
+| use ASCII diagrams a lot to understand your architecture | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742759218794768) |
+| use [/loop](https://code.claude.com/docs/en/scheduled-tasks) for local recurring monitoring (up to 7 days) · use [/schedule](https://code.claude.com/docs/en/routines) for cloud-based recurring tasks that run even when your machine is off | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454341884154269) |
+| use [Ralph Wiggum plugin](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) for long-running autonomous tasks | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179858435281082) |
+| [/permissions](https://code.claude.com/docs/en/permissions) with wildcard syntax (Bash(npm run *), Edit(/docs/**)) instead of dangerously-skip-permissions | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179854077407667) |
+| [/sandbox](https://code.claude.com/docs/en/sandboxing) to reduce permission prompts with file and network isolation — 84% reduction internally | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700506465579443) [![Cat](!/tags/cat-wu.svg)](https://creatoreconomy.so/p/inside-claude-code-how-an-ai-native-actually-works-cat-wu) |
+| invest in [product verification](https://code.claude.com/docs/en/skills) skills (signup-flow-driver, checkout-verifier) — worth spending a week to perfect | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) |
+| use [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) instead of dangerously-skip-permissions — a model-based classifier decides if each command is safe and auto-approves, pauses and asks if risky. Shift+Tab to cycle Ask → Plan → Auto modes 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+| use /less-permission-prompts skill to scan session history for safe bash/MCP commands that repeatedly prompt, then get a recommended allowlist to paste into [settings](best-practice/claude-settings.md) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+| build a /go skill that (1) tests end-to-end via bash/browser/computer use (2) runs /simplify (3) puts up a PR — so when you come back, you know the code works 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) |
+
+<a id="tips-git-pr"></a>■ **Git / PR (5)**
+
+| Tip | Source |
+|-----|--------|
+| keep PRs small and focused — [p50 of 118 lines](tips/claude-boris-2-tips-25-mar-26.md) (141 PRs, 45K lines changed in a day), one feature per PR, easier to review and revert | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) |
+| always [squash merge](tips/claude-boris-2-tips-25-mar-26.md) PRs — clean linear history, one commit per feature, easy git revert and git bisect | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) |
+| commit often — try to commit at least once per hour, as soon as task is completed, commit | ![Shayan](!/tags/community-shayan.svg) |
+| tag [@claude](https://github.com/apps/claude) on a coworker's PR to auto-generate lint rules for recurring review feedback — automate yourself out of code review 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=2715) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=2715) |
+| use [/code-review](https://code.claude.com/docs/en/code-review) for multi-agent PR analysis — catches bugs, security vulnerabilities, and regressions before merge | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031089411820228645) |
+
+<a id="tips-debugging"></a>■ **Debugging (6)**
+
+| Tip | Source |
+|-----|--------|
+| make it a habit to take screenshots and share with Claude whenever you are stuck with any issue | ![Shayan](!/tags/community-shayan.svg) |
+| use mcp ([Claude in Chrome](https://code.claude.com/docs/en/chrome), [Playwright](https://github.com/microsoft/playwright-mcp), [Chrome DevTools](https://developer.chrome.com/blog/chrome-devtools-mcp)) to let claude see chrome console logs on its own | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/chrome) |
+| always ask claude to run the terminal (you want to see logs of) as a background task for better debugging | ![Shayan](!/tags/community-shayan.svg) |
+| [/doctor](https://code.claude.com/docs/en/cli-reference) to diagnose installation, authentication, and configuration issues | ![Shayan](!/tags/community-shayan.svg) |
+| use a [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) for QA — e.g. [Codex](https://github.com/shanraisshan/codex-cli-best-practice) for plan and implementation review | ![Shayan](!/tags/community-shayan.svg) |
+| agentic search (glob + grep) beats RAG — Claude Code tried and discarded vector databases because code drifts out of sync and permissions are complex | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3095) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3095) |
+
+<a id="tips-utilities"></a>■ **Utilities (5)**
+
+| Tip | Source |
+|-----|--------|
+| [iTerm](https://iterm2.com/)/[Ghostty](https://ghostty.org/)/[tmux](https://github.com/tmux/tmux) terminals instead of IDE ([VS Code](https://code.visualstudio.com/)/[Cursor](https://www.cursor.com/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742753971769626) |
+| [/voice](https://code.claude.com/docs/en/voice-dictation) or [Wispr Flow](https://wisprflow.ai) for voice prompting (10x productivity) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454362226467112) |
+| [claude-code-hooks](https://github.com/shanraisshan/claude-code-hooks) for claude feedback | ![Shayan](!/tags/community-shayan.svg) |
+| [status line](https://github.com/shanraisshan/claude-code-status-line) for context awareness and fast compacting | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700784019452195) ![Shayan](!/tags/community-shayan.svg) |
+| explore [settings.json](best-practice/claude-settings.md) features like [Plans Directory](best-practice/claude-settings.md#plans-directory), [Spinner Verbs](best-practice/claude-settings.md#display--ux) for a personalized experience | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701145023197516) |
+
+<a id="tips-daily"></a>■ **Daily (2)**
+
+| Tip | Source |
+|-----|--------|
+| [update](https://code.claude.com/docs/en/setup) Claude Code daily | ![Shayan](!/tags/community-shayan.svg) |
+| start your day by reading the [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) | ![Shayan](!/tags/community-shayan.svg) |
+
+![Boris Cherny + Team](!/tags/claude.svg)
+
+| Article / Tweet | Source |
+|-----------------|--------|
+| [6 Tips for Getting More Out of Opus 4.7 (Boris) \| 16/Apr/26](tips/claude-boris-6-tips-16-apr-26.md) | [Tweet](https://x.com/bcherny) |
+| [Session Management & 1M Context (Thariq) \| 16/Apr/26](tips/claude-thariq-tips-16-apr-26.md) | [Tweet](https://x.com/trq212) |
+| [15 Hidden & Under-Utilized Features in Claude Code (Boris) \| 30/Mar/26](tips/claude-boris-15-tips-30-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038454336355999749) |
+| [Squash Merging & PR Size Distribution (Boris) \| 25/Mar/26](tips/claude-boris-2-tips-25-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038552880018538749) |
+| [Lessons from Building Claude Code: How We Use Skills (Thariq) \| 17/Mar/26](tips/claude-thariq-tips-17-mar-26.md) | [Article](https://x.com/trq212/status/2033949937936085378) |
+| [Code Review & Test Time Compute (Boris) \| 10/Mar/26](tips/claude-boris-2-tips-10-mar-26.md) | [Tweet](https://x.com/bcherny/status/2031089411820228645) |
+| /loop — schedule recurring tasks for up to 3 days (Boris) \| 07 Mar 2026 | [Tweet](https://x.com/bcherny/status/2030193932404150413) |
+| AskUserQuestion + ASCII Markdowns (Thariq) \| 28 Feb 2026 | [Tweet](https://x.com/trq212/status/2027543858289250472) |
+| Seeing like an Agent - lessons from building Claude Code (Thariq) \| 28 Feb 2026 | [Article](https://x.com/trq212/status/2027463795355095314) |
+| Git Worktrees - 5 ways how boris is using \| 21 Feb 2026 | [Tweet](https://x.com/bcherny/status/2025007393290272904) |
+| Lessons from Building Claude Code: Prompt Caching Is Everything (Thariq) \| 20 Feb 2026 | [Article](https://x.com/trq212/status/2024574133011673516) |
+| [12 ways how people are customizing their claudes (Boris) \| 12/Feb/26](tips/claude-boris-12-tips-12-feb-26.md) | [Tweet](https://x.com/bcherny/status/2021699851499798911) |
+| [10 tips for using Claude Code from the team (Boris) \| 01/Feb/26](tips/claude-boris-10-tips-01-feb-26.md) | [Tweet](https://x.com/bcherny/status/2017742741636321619) |
+| [How I use Claude Code — 13 tips from my surprisingly vanilla setup (Boris) \| 03/Jan/26](tips/claude-boris-13-tips-03-jan-26.md) | [Tweet](https://x.com/bcherny/status/2007179832300581177) |
+| Ask Claude to interview you using AskUserQuestion tool (Thariq) \| 28/Dec/25 | [Tweet](https://x.com/trq212/status/2005315275026260309) |
+| Always use plan mode, give Claude a way to verify, use /code-review (Boris) \| 27/Dec/25 | [Tweet](https://x.com/bcherny/status/2004711722926616680) |
+
+#### Tips from Claude code CLI binary
+
+[Spinner Verbs & Tips (extracted from CLI binary v2.1.121)](reports/claude-spinner-verbs-and-tips.md)
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 🎬 VIDEOS / PODCASTS
+
+| Video / Podcast | Source | YouTube |
+|-----------------|--------|--------|
+| From Vibe Coding to Agentic Engineering (Andrej) \| 02 May 2026 \| AI Engineer | [![Karpathy](!/tags/community-karpathy.svg)](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) |
+| Full Walkthrough: Workflow for AI Coding (Matt) \| 24 Apr 2026 \| Matt Pocock | [![Matt](!/tags/community-matt.svg)](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) |
+| Everything We Got Wrong About Research-Plan-Implement (Dex) \| 24 Mar 2026 \| MLOps Community | [![Dex](!/tags/community-dex.svg)](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) |
+| Building Claude Code with Boris Cherny (Boris) \| 04 Mar 2026 \| The Pragmatic Engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/julbw1JuAz0) |
+| Head of Claude Code: What happens after coding is solved (Boris) \| 19 Feb 2026 \| Lenny's Podcast | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/We7BZVKbCVw) |
+| Inside Claude Code With Its Creator Boris Cherny (Boris) \| 17 Feb 2026 \| Y Combinator | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/PQU9o_5rHC4) |
+| Boris Cherny (Creator of Claude Code) On What Grew His Career (Boris) \| 15 Dec 2025 \| Ryan Peterman | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/AmdLVWMdjOk) |
+| The Secrets of Claude Code From the Engineers Who Built It (Cat) \| 29 Oct 2025 \| Every | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/IDSAMqip6ms) |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## 🔔 SUBSCRIBE
+
+| Source | Name | Badge |
+|--------|------|-------|
+| ![Reddit](https://img.shields.io/badge/-FF4500?style=flat&logo=reddit&logoColor=white) | [r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/), [r/ClaudeCode](https://www.reddit.com/r/ClaudeCode/), [r/Anthropic](https://www.reddit.com/r/Anthropic/) | ![Boris + Team](!/tags/claude.svg) |
+| ![X](https://img.shields.io/badge/-000?style=flat&logo=x&logoColor=white) | [Claude](https://x.com/claudeai), [Claude Devs](https://x.com/ClaudeDevs), [Anthropic](https://x.com/AnthropicAI), [Boris](https://x.com/bcherny), [Thariq](https://x.com/trq212), [Cat](https://x.com/_catwu), [Lydia](https://x.com/lydiahallie), [Noah](https://x.com/noahzweben), [Anthony](https://x.com/amorriscode), [Alex](https://x.com/alexalbert__), [Kenneth](https://x.com/neilhtennek) | ![Boris + Team](!/tags/claude.svg) |
+| ![X](https://img.shields.io/badge/-000?style=flat&logo=x&logoColor=white) | [Jesse Kriss](https://x.com/obra) ([Superpowers](https://github.com/obra/superpowers)), [Affaan Mustafa](https://x.com/affaanmustafa) ([ECC](https://github.com/affaan-m/everything-claude-code)), [Garry Tan](https://x.com/garrytan) ([gstack](https://github.com/garrytan/gstack)), [Dex Horthy](https://x.com/dexhorthy) ([HumanLayer](https://github.com/humanlayer/humanlayer)), [Kieran Klaassen](https://x.com/kieranklaassen) ([Compound Eng](https://github.com/EveryInc/compound-engineering-plugin)), [Tabish Gilani](https://x.com/0xTab) ([OpenSpec](https://github.com/Fission-AI/OpenSpec)), [Brian McAdams](https://x.com/BMadCode) ([BMAD](https://github.com/bmad-code-org/BMAD-METHOD)), [Lex Christopherson](https://x.com/official_taches) ([GSD](https://github.com/gsd-build/get-shit-done)), [Matt Pocock](https://x.com/mattpocockuk) ([Skills](https://github.com/mattpocock/skills)), [Dani Avila](https://x.com/dani_avila7) ([CC Templates](https://github.com/davila7/claude-code-templates)), [Dan Shipper](https://x.com/danshipper) ([Every](https://every.to/)), [Andrej Karpathy](https://x.com/karpathy) ([AutoResearch](https://x.com/karpathy/status/2015883857489522876)), [Peter Steinberger](https://x.com/steipete) ([OpenClaw](https://x.com/openclaw)), [Sigrid Jin](https://x.com/realsigridjin) ([claw-code](https://github.com/ultraworkers/claw-code)), [Yeachan Heo](https://x.com/bellman_ych) ([oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)) | ![Community](!/tags/community.svg) |
+| ![YouTube](https://img.shields.io/badge/-F00?style=flat&logo=youtube&logoColor=white) | [Anthropic](https://www.youtube.com/@anthropic-ai) | ![Boris + Team](!/tags/claude.svg) |
+| ![YouTube](https://img.shields.io/badge/-F00?style=flat&logo=youtube&logoColor=white) | [Lenny's Podcast](https://www.youtube.com/@LennysPodcast), [Y Combinator](https://www.youtube.com/@ycombinator), [The Pragmatic Engineer](https://www.youtube.com/@pragmaticengineer), [Ryan Peterman](https://www.youtube.com/@ryanlpeterman), [Every](https://www.youtube.com/@every_media), [MLOps Community](https://www.youtube.com/@MLOps) | ![Community](!/tags/community.svg) |
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## ☠️ STARTUPS / BUSINESSES
+
+| Claude | Replaced |
+|-|-|
+|[**Code Review**](https://code.claude.com/docs/en/code-review)|[Greptile](https://greptile.com), [CodeRabbit](https://coderabbit.ai), [Devin Review](https://devin.ai), [OpenDiff](https://opendiff.com), [Cursor BugBot](https://bugbot.dev)|
+|[**Voice Dictation**](https://code.claude.com/docs/en/voice-dictation)|[Wispr Flow](https://wisprflow.ai), [SuperWhisper](https://superwhisper.com/)|
+|[**Remote Control**](https://code.claude.com/docs/en/remote-control)|[OpenClaw](https://openclaw.ai/)
+|[**Claude in Chrome**](https://code.claude.com/docs/en/chrome)|[Playwright MCP](https://github.com/microsoft/playwright-mcp), [Chrome DevTools MCP](https://developer.chrome.com/blog/chrome-devtools-mcp)|
+|[**Computer Use**](https://docs.anthropic.com/en/docs/agents-and-tools/computer-use)|[OpenAI CUA](https://openai.com/index/computer-using-agent/)|
+|[**Cowork**](https://claude.com/blog/cowork-research-preview)|[ChatGPT Agent](https://openai.com/chatgpt/agent/), [Perplexity Computer](https://www.perplexity.ai/computer/), [Manus](https://manus.im)|
+|[**Tasks**](https://x.com/trq212/status/2014480496013803643)|[Beads](https://github.com/steveyegge/beads)
+|[**Plan Mode**](https://code.claude.com/docs/en/common-workflows)|[Agent OS](https://github.com/buildermethods/agent-os)|
+|[**Design**](https://claude.com/design)|[Figma](https://figma.com), [Framer](https://framer.com), [Sketch](https://sketch.com), [v0](https://v0.dev)|
+|[**Agent SDK**](https://code.claude.com/docs/en/agent-sdk/overview)|[LangChain](https://langchain.com), [LangGraph](https://www.langchain.com/langgraph), [CrewAI](https://www.crewai.com), [AutoGen](https://github.com/microsoft/autogen), [OpenAI Assistants API](https://platform.openai.com/docs/assistants/overview)|
+|[**Skills / Plugins**](https://code.claude.com/docs/en/plugins)|YC AI wrapper startups ([reddit](https://reddit.com/r/ClaudeAI/comments/1r6bh4d/claude_code_skills_are_basically_yc_ai_startup/))|
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+<a id="billion-dollar-questions"></a>
+![Billion-Dollar Questions](!/tags/billion-dollar-questions.svg)
+
+*If you have answers, do let me know at shanraisshan@gmail.com*
+
+**Memory & Instructions (4)**
+
+1. What exactly should you put inside your CLAUDE.md — and what should you leave out?
+2. If you already have a CLAUDE.md, is a separate constitution.md or rules.md actually needed?
+3. How often should you update your CLAUDE.md, and how do you know when it's become stale?
+4. Why does Claude still ignore CLAUDE.md instructions — even when they say MUST in all caps? ([reddit](https://reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/))
+
+**Agents, Skills & Workflows (6)**
+
+1. When should you use a command vs an agent vs a skill — and when is vanilla Claude Code just better?
+2. How often should you update your agents, commands, and workflows as models improve?
+3. Should you have a generalist subagent or a feature-specific/role-specific agent? Does giving your subagent a detailed persona improve quality, and what does a "perfect persona prompt" for research/vision look like?
+4. Should you rely on Claude Code's built-in plan mode — or build your own planning command/agent that enforces your team's workflow?
+5. If you have a personal skill (e.g., /implement with your coding style), how do you incorporate community skills (e.g., /simplify) without conflicts — and who wins when they disagree?
+6. Are we there yet? Can we convert an existing codebase into specs, delete the code, and have AI regenerate the exact same code from those specs alone?
+
+**Specs & Documentation (3)**
+
+1. Should every feature in your repo have a spec as a markdown file?
+2. How often do you need to update specs so they don't become obsolete when a new feature is implemented?
+3. When implementing a new feature, how do you handle the ripple effect on specs for other features?
+
+### 🤔 [Does code matter?](https://github.com/shanraisshan/agentic-engineering)
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## REPORTS
+
+<p align="center">
+  <a href="reports/claude-agent-sdk-vs-cli-system-prompts.md"><img src="https://img.shields.io/badge/Agent_SDK_vs_CLI-555?style=for-the-badge" alt="Agent SDK vs CLI"></a>
+  <a href="reports/claude-in-chrome-v-chrome-devtools-mcp.md"><img src="https://img.shields.io/badge/Browser_Automation_MCP-555?style=for-the-badge" alt="Browser Automation MCP"></a>
+  <a href="reports/claude-global-vs-project-settings.md"><img src="https://img.shields.io/badge/Global_vs_Project_Settings-555?style=for-the-badge" alt="Global vs Project Settings"></a>
+  <a href="reports/claude-skills-for-larger-mono-repos.md"><img src="https://img.shields.io/badge/Skills_in_Monorepos-555?style=for-the-badge" alt="Skills in Monorepos"></a>
+  <br>
+  <a href="reports/claude-agent-memory.md"><img src="https://img.shields.io/badge/Agent_Memory-555?style=for-the-badge" alt="Agent Memory"></a>
+  <a href="reports/claude-advanced-tool-use.md"><img src="https://img.shields.io/badge/Advanced_Tool_Use-555?style=for-the-badge" alt="Advanced Tool Use"></a>
+  <a href="reports/claude-usage-and-rate-limits.md"><img src="https://img.shields.io/badge/Usage_&_Rate_Limits-555?style=for-the-badge" alt="Usage & Rate Limits"></a>
+  <a href="reports/claude-agent-command-skill.md"><img src="https://img.shields.io/badge/Agents_vs_Commands_vs_Skills-555?style=for-the-badge" alt="Agents vs Commands vs Skills"></a>
+  <br>
+  <a href="reports/llm-day-to-day-degradation.md"><img src="https://img.shields.io/badge/LLM_Degradation-555?style=for-the-badge" alt="LLM Degradation"></a>
+  <a href="reports/why-harness-is-important.md"><img src="https://img.shields.io/badge/Why_Harness_is_Important-555?style=for-the-badge" alt="Why Harness is Important"></a>
+  <a href="reports/claude-spinner-verbs-and-tips.md"><img src="https://img.shields.io/badge/Spinner_Verbs_&_Tips-555?style=for-the-badge" alt="Spinner Verbs & Tips"></a>
+</p>
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+<a id="how-to-use"></a>
+
+## <img src="!/tags/how-to-use-hd.svg" alt="How to Use">
+
+Get the maximum out of this repo by following these steps:
+
+1. **Read this repo as a course, not as a workflow or skill.** It's reference material first; you'll run things later.
+2. **Don't use Claude as a chatbot.** Learn the primitives — agents, commands, skills, hooks — and assemble them into your own workflow.
+3. **Run [`/weather-orchestrator`](orchestration-workflow/orchestration-workflow.md)** to see a complete command → agent → skill flow. Use it as a template for any dev workflow, from planning to shipping.
+4. **Listen for the custom hook sounds while you work.** Their implementation lives in the dedicated [Claude Code Hooks repo](https://github.com/shanraisshan/claude-code-hooks); other patterns like [Agent Teams](implementation/claude-agent-teams-implementation.md) ship inside this repo's `implementation/` directory.
+5. **Learn the advanced topics and their implementations** from the [🔥 Hot](#-hot) sub-table — for example, the [Ralph Wiggum self-evolving loop](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) is a full working repo you can clone to see one of these patterns end-to-end.
+6. **Point Claude at the [tips and tricks](#-tips-and-tricks-83) section in your own project** and ask it to suggest edits — especially how to restructure your `CLAUDE.md`. Every tip is sourced from the Claude team or the community.
+7. **Subscribe to the Reddit and YouTube channels in the [Subscribe section](#-subscribe)** to keep up with the community.
+
+**🎬 Videos**
+
+<a href="https://www.youtube.com/watch?v=AkAhkalkRY4"><img src="!/thumbnail/video-1.png" alt="Watch on YouTube" width="240"></a>
+<a href="https://youtu.be/lPjhM6BBK0Q"><img src="!/thumbnail/video-2.png" alt="Watch on YouTube" width="240"></a>
+
+**📊 Presentations**
+
+<a href="https://github.com/shanraisshan/claude-code-best-practice/tree/main/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini"><img src="!/thumbnail/presentation-1.png" alt="Claude Code & Gemini CLI — GDG Kolachi" width="240"></a>
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+<p align="center">
+  <a href="https://github.com/trending?since=monthly"><img src="!/root/github-trending.png" alt="GitHub Trending" width="1200"></a><br>
+  ✨Trending on Github in March 2026✨
+</p>
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=shanraisshan/claude-code-best-practice&type=Date&v=2)](https://star-history.com/#shanraisshan/claude-code-best-practice&Date)
+
+<a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars" align="center"></a> stars and counting
+
+## Other Repos
+
+<table>
+<tr>
+<td align="center" width="140">
+  <a href="https://github.com/shanraisshan/claude-code-hooks"><img src="!/claude-speaking.svg" alt="Claude Code Hooks" width="64" height="64"></a><br>
+  <a href="https://github.com/shanraisshan/claude-code-hooks"><strong>Claude Code<br>Hooks</strong></a>
+</td>
+<td align="center" width="140">
+  <a href="https://github.com/shanraisshan/codex-cli-best-practice"><img src="!/codex-jumping.svg" alt="Codex CLI Best Practice" width="64" height="64"></a><br>
+  <a href="https://github.com/shanraisshan/codex-cli-best-practice"><strong>Codex CLI<br>Best Practice</strong></a>
+</td>
+<td align="center" width="140">
+  <a href="https://github.com/shanraisshan/codex-cli-hooks"><img src="!/codex-speaking.svg" alt="Codex CLI Hooks" width="64" height="64"></a><br>
+  <a href="https://github.com/shanraisshan/codex-cli-hooks"><strong>Codex CLI<br>Hooks</strong></a>
+</td>
+<td align="center" width="140">
+  <a href="https://github.com/shanraisshan/gemini-cli-best-practice"><img src="!/gemini-jumping.svg" alt="Gemini CLI Best Practice" width="64" height="64"></a><br>
+  <a href="https://github.com/shanraisshan/gemini-cli-best-practice"><strong>Gemini CLI<br>Best Practice</strong></a>
+</td>
+<td align="center" width="140">
+  <a href="https://github.com/shanraisshan/gemini-cli-hooks"><img src="!/gemini-speaking.svg" alt="Gemini CLI Hooks" width="64" height="64"></a><br>
+  <a href="https://github.com/shanraisshan/gemini-cli-hooks"><strong>Gemini CLI<br>Hooks</strong></a>
+</td>
+</tr>
+</table>
+
+## Developed by
+
+![Developed by](!/tags/developed-by.svg)
+
+> | # | Workflow | Description |
+> |---|----------|-------------|
+> | 1 | /workflows:development-workflows | Update the DEVELOPMENT WORKFLOWS table and cross-workflow analysis report by researching all 10 workflow repos in parallel |
+> | 2 | /workflows:skill-collections | Update the SKILL COLLECTIONS table by researching all 5 skill-collection repos in parallel |
+> | 3 | /workflows:agent-collections | Update the AGENT COLLECTIONS table by researching all agent-collection repos in parallel |
+> | 4 | /workflows:best-practice:workflow-concepts | Update the README CONCEPTS section with the latest Claude Code features and concepts |
+> | 5 | /workflows:best-practice:workflow-claude-settings | Track Claude Code settings report changes and find what needs updating |
+> | 6 | /workflows:best-practice:workflow-claude-subagents | Track Claude Code subagents report changes and find what needs updating |
+> | 7 | /workflows:best-practice:workflow-claude-commands | Track Claude Code commands report changes and find what needs updating |
+> | 8 | /workflows:best-practice:workflow-claude-skills | Track Claude Code skills report changes and find what needs updating |
+
+## Extras
+
+[![Claude for OSS](!/tags/claude-for-oss.svg)](https://claude.com/contact-sales/claude-for-oss)
+[![Claude Community Ambassador](!/tags/claude-community-ambassador.svg)](https://claude.com/community/ambassadors)
+[![Claude Certified Architect](!/tags/claude-certified-architect.svg)](https://anthropic.skilljar.com/claude-certified-architect-foundations-access-request)
+[![Anthropic Academy](!/tags/anthropic-academy.svg)](https://anthropic.skilljar.com/)
+[![Join Claude Pakistan community on WhatsApp](!/tags/whatsapp-claude-pakistan.svg)](https://chat.whatsapp.com/BDUV2stIS0c7X5uY7RY6nS)
+
+<p align="center">
+  <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
+</p>
+
+## <img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> Sponsor My Work
+
+If you like my work, buy me a doodh patti 🍵 on
+
+<a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><img src="!/tags/polar.svg" alt="Polar" width="40" height="40" align="center"></a> <a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><strong>Polar</strong></a>
+
+**Want your brand in the header?** Header placements are available — email [shanraisshan@gmail.com](mailto:shanraisshan@gmail.com).

docs/research/shanraisshan-claude-code-best-practice/raw/github-repo.raw.json

@@ -0,0 +1,91 @@
+{
+  "createdAt": "2025-10-31T14:15:28Z",
+  "defaultBranchRef": {
+    "name": "main"
+  },
+  "description": "from vibe coding to agentic engineering - practice makes claude perfect",
+  "forkCount": 6189,
+  "homepageUrl": "https://linkedin.com/in/shanraisshan",
+  "isArchived": false,
+  "isFork": false,
+  "isMirror": false,
+  "latestRelease": null,
+  "licenseInfo": {
+    "key": "mit",
+    "name": "MIT License",
+    "nickname": ""
+  },
+  "nameWithOwner": "shanraisshan/claude-code-best-practice",
+  "primaryLanguage": {
+    "name": "HTML"
+  },
+  "pushedAt": "2026-07-02T06:38:21Z",
+  "repositoryTopics": [
+    {
+      "name": "claude-ai"
+    },
+    {
+      "name": "claude-code"
+    },
+    {
+      "name": "best-practices"
+    },
+    {
+      "name": "claude"
+    },
+    {
+      "name": "claude-code-best-practices"
+    },
+    {
+      "name": "agentic-engineering"
+    },
+    {
+      "name": "anthropic"
+    },
+    {
+      "name": "claude-code-agents"
+    },
+    {
+      "name": "claude-code-commands"
+    },
+    {
+      "name": "claude-code-skills"
+    },
+    {
+      "name": "vibe-coding"
+    },
+    {
+      "name": "boris"
+    },
+    {
+      "name": "agentic-ai"
+    },
+    {
+      "name": "agentic-coding"
+    },
+    {
+      "name": "agentic-workflow"
+    },
+    {
+      "name": "ai"
+    },
+    {
+      "name": "context-engineering"
+    },
+    {
+      "name": "pakistan"
+    },
+    {
+      "name": "pakistani-developer"
+    },
+    {
+      "name": "ai-agents"
+    }
+  ],
+  "stargazerCount": 61856,
+  "updatedAt": "2026-07-02T22:34:04Z",
+  "url": "https://github.com/shanraisshan/claude-code-best-practice",
+  "watchers": {
+    "totalCount": 463
+  }
+}

docs/research/shanraisshan-claude-code-best-practice/raw/github-root-contents.raw.json

@@ -0,0 +1,322 @@
+[
+  {
+    "name": "!",
+    "path": "!",
+    "sha": "43e2f46faf3e3e4a2221d85ba0aa6fe3a9884595",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/!?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/!",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/43e2f46faf3e3e4a2221d85ba0aa6fe3a9884595",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/!?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/43e2f46faf3e3e4a2221d85ba0aa6fe3a9884595",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/!"
+    }
+  },
+  {
+    "name": ".claude",
+    "path": ".claude",
+    "sha": "8b94dd1c958681cc820b8ae5e43b34104bacf388",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.claude?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/8b94dd1c958681cc820b8ae5e43b34104bacf388",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.claude?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/8b94dd1c958681cc820b8ae5e43b34104bacf388",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude"
+    }
+  },
+  {
+    "name": ".codex",
+    "path": ".codex",
+    "sha": "da58dcaac5ebfedc07aece55abb3a3f8a6d05d6c",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.codex?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.codex",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/da58dcaac5ebfedc07aece55abb3a3f8a6d05d6c",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.codex?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/da58dcaac5ebfedc07aece55abb3a3f8a6d05d6c",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.codex"
+    }
+  },
+  {
+    "name": ".github",
+    "path": ".github",
+    "sha": "40c6b2e5ec15538048980daabc568d72a10401cc",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.github?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.github",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/40c6b2e5ec15538048980daabc568d72a10401cc",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.github?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/40c6b2e5ec15538048980daabc568d72a10401cc",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/.github"
+    }
+  },
+  {
+    "name": ".gitignore",
+    "path": ".gitignore",
+    "sha": "4873ba44ceac0b0d7f3032183de79e36b09454d2",
+    "size": 233,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.gitignore?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.gitignore",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/4873ba44ceac0b0d7f3032183de79e36b09454d2",
+    "download_url": "https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.gitignore",
+    "type": "file",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.gitignore?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/4873ba44ceac0b0d7f3032183de79e36b09454d2",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.gitignore"
+    }
+  },
+  {
+    "name": ".mcp.json",
+    "path": ".mcp.json",
+    "sha": "0b9fdeaa522edb92fddce5c3234f31f65452c544",
+    "size": 388,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.mcp.json?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.mcp.json",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/0b9fdeaa522edb92fddce5c3234f31f65452c544",
+    "download_url": "https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.mcp.json",
+    "type": "file",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/.mcp.json?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/0b9fdeaa522edb92fddce5c3234f31f65452c544",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/.mcp.json"
+    }
+  },
+  {
+    "name": "CLAUDE.md",
+    "path": "CLAUDE.md",
+    "sha": "953fe929d0d02d06e94604a7bfa3ae697b0aed30",
+    "size": 7809,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/CLAUDE.md?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/CLAUDE.md",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/953fe929d0d02d06e94604a7bfa3ae697b0aed30",
+    "download_url": "https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/CLAUDE.md",
+    "type": "file",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/CLAUDE.md?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/953fe929d0d02d06e94604a7bfa3ae697b0aed30",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/CLAUDE.md"
+    }
+  },
+  {
+    "name": "LICENSE",
+    "path": "LICENSE",
+    "sha": "a618c28c1b7517ced276c5b509ae57ee7a58e612",
+    "size": 1073,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/LICENSE?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/LICENSE",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/a618c28c1b7517ced276c5b509ae57ee7a58e612",
+    "download_url": "https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/LICENSE",
+    "type": "file",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/LICENSE?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/a618c28c1b7517ced276c5b509ae57ee7a58e612",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/LICENSE"
+    }
+  },
+  {
+    "name": "README.md",
+    "path": "README.md",
+    "sha": "abb175faaa959697868e949673d2fd0f2fb412f9",
+    "size": 76469,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/README.md?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/README.md",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/abb175faaa959697868e949673d2fd0f2fb412f9",
+    "download_url": "https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/README.md",
+    "type": "file",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/README.md?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/blobs/abb175faaa959697868e949673d2fd0f2fb412f9",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/blob/main/README.md"
+    }
+  },
+  {
+    "name": "agent-teams",
+    "path": "agent-teams",
+    "sha": "e5e2c8ba0e2e05af4b7b41fb761a0ceb6e1accc6",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/agent-teams?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/agent-teams",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/e5e2c8ba0e2e05af4b7b41fb761a0ceb6e1accc6",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/agent-teams?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/e5e2c8ba0e2e05af4b7b41fb761a0ceb6e1accc6",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/agent-teams"
+    }
+  },
+  {
+    "name": "best-practice",
+    "path": "best-practice",
+    "sha": "2f3a918d37f86bbafb60541dc18de4e1365a0446",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/best-practice?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/best-practice",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/2f3a918d37f86bbafb60541dc18de4e1365a0446",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/best-practice?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/2f3a918d37f86bbafb60541dc18de4e1365a0446",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/best-practice"
+    }
+  },
+  {
+    "name": "changelog",
+    "path": "changelog",
+    "sha": "36d883ca2d9883dd8ce76e55dcede32eefa38fa7",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/changelog?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/changelog",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/36d883ca2d9883dd8ce76e55dcede32eefa38fa7",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/changelog?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/36d883ca2d9883dd8ce76e55dcede32eefa38fa7",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/changelog"
+    }
+  },
+  {
+    "name": "development-workflows",
+    "path": "development-workflows",
+    "sha": "a7d92f7843a789efedd24a8d3da3aacf4e619a6d",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/development-workflows?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/development-workflows",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/a7d92f7843a789efedd24a8d3da3aacf4e619a6d",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/development-workflows?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/a7d92f7843a789efedd24a8d3da3aacf4e619a6d",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/development-workflows"
+    }
+  },
+  {
+    "name": "implementation",
+    "path": "implementation",
+    "sha": "4ce54b5fb5c781fa0fee7c29bef40300c78264aa",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/implementation?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/implementation",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/4ce54b5fb5c781fa0fee7c29bef40300c78264aa",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/implementation?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/4ce54b5fb5c781fa0fee7c29bef40300c78264aa",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/implementation"
+    }
+  },
+  {
+    "name": "orchestration-workflow",
+    "path": "orchestration-workflow",
+    "sha": "35679f637de6438d3b0cea41d275dbe4dde0ca46",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/orchestration-workflow?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/orchestration-workflow",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/35679f637de6438d3b0cea41d275dbe4dde0ca46",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/orchestration-workflow?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/35679f637de6438d3b0cea41d275dbe4dde0ca46",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/orchestration-workflow"
+    }
+  },
+  {
+    "name": "presentation",
+    "path": "presentation",
+    "sha": "bdc9d9d25211468b3190d5db0d6518d9bece0b82",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/presentation?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/presentation",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/bdc9d9d25211468b3190d5db0d6518d9bece0b82",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/presentation?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/bdc9d9d25211468b3190d5db0d6518d9bece0b82",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/presentation"
+    }
+  },
+  {
+    "name": "reports",
+    "path": "reports",
+    "sha": "b6f521ac2d204d9af3e7f2464d15d6411a6b50f7",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/reports?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/reports",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/b6f521ac2d204d9af3e7f2464d15d6411a6b50f7",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/reports?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/b6f521ac2d204d9af3e7f2464d15d6411a6b50f7",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/reports"
+    }
+  },
+  {
+    "name": "tips",
+    "path": "tips",
+    "sha": "063bd28e69515a4b4c99318dae5c8aec06fa869b",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/tips?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/tips",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/063bd28e69515a4b4c99318dae5c8aec06fa869b",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/tips?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/063bd28e69515a4b4c99318dae5c8aec06fa869b",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/tips"
+    }
+  },
+  {
+    "name": "tutorial",
+    "path": "tutorial",
+    "sha": "801039a4c1d6804b9c20a001e23d5ed6825b5220",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/tutorial?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/tutorial",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/801039a4c1d6804b9c20a001e23d5ed6825b5220",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/tutorial?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/801039a4c1d6804b9c20a001e23d5ed6825b5220",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/tutorial"
+    }
+  },
+  {
+    "name": "videos",
+    "path": "videos",
+    "sha": "b87bc8b353c384d7e29e0ae9db189008e64410d0",
+    "size": 0,
+    "url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/videos?ref=main",
+    "html_url": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/videos",
+    "git_url": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/b87bc8b353c384d7e29e0ae9db189008e64410d0",
+    "download_url": null,
+    "type": "dir",
+    "_links": {
+      "self": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/contents/videos?ref=main",
+      "git": "https://api.github.com/repos/shanraisshan/claude-code-best-practice/git/trees/b87bc8b353c384d7e29e0ae9db189008e64410d0",
+      "html": "https://github.com/shanraisshan/claude-code-best-practice/tree/main/videos"
+    }
+  }
+]

docs/research/shanraisshan-claude-code-best-practice/raw/sources.yml

@@ -0,0 +1,38 @@
+version: 1
+domain_id: shanraisshan-claude-code-best-practice
+object:
+  type: github_repository
+  name: shanraisshan/claude-code-best-practice
+  url: https://github.com/shanraisshan/claude-code-best-practice
+pulled_at: '2026-07-02T22:47:14+00:00'
+puller: scripts/fetch-research-raw.py
+files:
+  - path: repository/
+    kind: git-working-tree
+    status: ok
+    source: 'git clone --depth=1 --single-branch --no-tags https://github.com/shanraisshan/claude-code-best-practice.git docs/research/shanraisshan-claude-code-best-practice/raw/repository'
+  - path: github-repo.raw.json
+    kind: repository-metadata
+    status: ok
+    source: 'gh repo view shanraisshan/claude-code-best-practice --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
+  - path: github-readme.raw.md.txt
+    kind: readme
+    status: ok
+    source: 'gh api repos/shanraisshan/claude-code-best-practice/readme -H Accept: application/vnd.github.raw'
+  - path: github-license.raw.txt
+    kind: license
+    status: ok
+    source: 'gh api repos/shanraisshan/claude-code-best-practice/license -H Accept: application/vnd.github.raw'
+  - path: github-root-contents.raw.json
+    kind: root-contents
+    status: ok
+    source: 'gh api repos/shanraisshan/claude-code-best-practice/contents'
+  - path: github-languages.raw.json
+    kind: languages
+    status: ok
+    source: 'gh api repos/shanraisshan/claude-code-best-practice/languages'
+  - path: github-latest-release.raw.json
+    kind: latest-release
+    status: missing_or_error
+    source: 'gh api repos/shanraisshan/claude-code-best-practice/releases/latest'
+    message: 'gh: Not Found (HTTP 404)'