diff --git a/!/tags/anthropic-academy.svg b/!/tags/anthropic-academy.svg new file mode 100644 index 0000000..268501b --- /dev/null +++ b/!/tags/anthropic-academy.svg @@ -0,0 +1,35 @@ + diff --git a/!/tags/developed-by.svg b/!/tags/developed-by.svg new file mode 100644 index 0000000..f0c528d --- /dev/null +++ b/!/tags/developed-by.svg @@ -0,0 +1,35 @@ + diff --git a/README.md b/README.md index 1af87b6..bf00a85 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ practice makes claude perfect
-## CONCEPTS +## π§ CONCEPTS | Feature | Location | Description | |---------|----------|-------------| @@ -72,13 +72,7 @@ claude /weather-orchestrator ``` -| Component | Role | Example | -|-----------|------|---------| -| **Command** | Entry point, user interaction | [`/weather-orchestrator`](.claude/commands/weather-orchestrator.md) | -| **Agent** | Fetches data with preloaded skill (agent skill) | [`weather-agent`](.claude/agents/weather-agent.md) with [`weather-fetcher`](.claude/skills/weather-fetcher/SKILL.md) | -| **Skill** | Creates output independently (skill) | [`weather-svg-creator`](.claude/skills/weather-svg-creator/SKILL.md) | - -## DEVELOPMENT WORKFLOWS +## βοΈ DEVELOPMENT WORKFLOWS ### π₯ Hot - [Cross-Model (Claude Code + Codex) Workflow](development-workflows/cross-model-workflow/cross-model-workflow.md) [](development-workflows/cross-model-workflow/cross-model-workflow.md) @@ -96,13 +90,15 @@ claude - [Boris Cherny (Creator of Claude Code) - Feb 2026 Workflow](https://x.com/bcherny/status/2017742741636321619) - [Peter Steinberger (Creator of OpenClaw) Workflow](https://youtu.be/8lF7HmQ_RgY?t=2582) -## TIPS AND TRICKS +## π‘ TIPS AND TRICKS  -β **Prompting (2)** +β **Prompting (4)** - 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 [](https://x.com/bcherny/status/2017742752566632544) - after a mediocre fix β "knowing everything you know now, scrap this and implement the elegant solution" [](https://x.com/bcherny/status/2017742752566632544) +- Claude fixes most bugs by itself β paste the bug, say "fix", don't micromanage how πΆ [](https://x.com/bcherny/status/2017742750473720121) +- say "use subagents" to throw more compute at a problem β offload tasks to keep your main context clean and focused πΆ [](https://x.com/bcherny/status/2017742755737555434) β **Planning/Specs (5)** - always start with [plan mode](https://code.claude.com/docs/en/common-workflows) [](https://x.com/bcherny/status/2007179845336527000) @@ -211,17 +207,19 @@ claude ## REPORTS -| Report | Description | -|--------|-------------| -| [Agent SDK vs CLI System Prompts](reports/claude-agent-sdk-vs-cli-system-prompts.md) | Why Claude CLI and Agent SDK outputs may differβsystem prompt architecture and determinism | -| [Browser Automation MCP Comparison](reports/claude-in-chrome-v-chrome-devtools-mcp.md) | Comparison of Playwright, Chrome DevTools, and Claude in Chrome for automated testing | -| [Global vs Project Settings](reports/claude-global-vs-project-settings.md) | Which features are global-only (`~/.claude/`) vs dual-scope, including Tasks and Agent Teams | -| [Skills Discovery in Monorepos](reports/claude-skills-for-larger-mono-repos.md) | How skills are discovered and loaded in large monorepo projects | -| [Agent Memory Frontmatter](reports/claude-agent-memory.md) | Persistent memory scopes (`user`, `project`, `local`) for subagents β enabling agents to learn across sessions | -| [Advanced Tool Use Patterns](reports/claude-advanced-tool-use.md) | Programmatic Tool Calling (PTC), Tool Search, and Tool Use Examples | -| [Usage, Rate Limits & Extra Usage](reports/claude-usage-and-rate-limits.md) | Usage commands (`/usage`, `/extra-usage`, `/cost`), rate limits, and pay-as-you-go overflow billing | -| [LLM Day-to-Day Degradation](reports/llm-day-to-day-degradation.md) | Why LLM performance varies day-to-day β infrastructure bugs, MoE routing variance, and psychology | -| [Agents vs Commands vs Skills](reports/claude-agent-command-skill.md) | When to use each extension mechanism β comparison table, resolution order, and worked example | +

@@ -236,6 +234,19 @@ claude
3. Go to your own project and ask Claude to suggest what best practices from this repo you should add, give it this repo as a reference so it knows what's possible.
```
+## Developed by
+
+
+
+> | Workflow | Description |
+> |----------|-------------|
+> | /workflows:best-practice:workflow-concepts | Update the README CONCEPTS section with the latest Claude Code features and concepts |
+> | /workflows:best-practice:workflow-claude-settings | Track Claude Code settings report changes and find what needs updating |
+> | /workflows:best-practice:workflow-claude-subagents | Track Claude Code subagents report changes and find what needs updating |
+> | /workflows:best-practice:workflow-claude-commands | Track Claude Code commands report changes and find what needs updating |
+> | /workflows:best-practice:workflow-claude-skills | Track Claude Code skills report changes and find what needs updating |
+
[](https://claude.com/contact-sales/claude-for-oss)
[](https://claude.com/community/ambassadors)
[](https://anthropic.skilljar.com/claude-certified-architect-foundations-access-request)
+[](https://anthropic.skilljar.com/)
diff --git a/orchestration-workflow/orchestration-workflow.md b/orchestration-workflow/orchestration-workflow.md
index b7837ce..9e9c00c 100644
--- a/orchestration-workflow/orchestration-workflow.md
+++ b/orchestration-workflow/orchestration-workflow.md
@@ -20,6 +20,14 @@ This showcases the **Command β Agent β Skill** architecture pattern, where:
- An agent fetches data using its preloaded skill
- A skill creates the visual output independently
+## Component Summary
+
+| Component | Role | Example |
+|-----------|------|---------|
+| **Command** | Entry point, user interaction | [`/weather-orchestrator`](../.claude/commands/weather-orchestrator.md) |
+| **Agent** | Fetches data with preloaded skill (agent skill) | [`weather-agent`](../.claude/agents/weather-agent.md) with [`weather-fetcher`](../.claude/skills/weather-fetcher/SKILL.md) |
+| **Skill** | Creates output independently (skill) | [`weather-svg-creator`](../.claude/skills/weather-svg-creator/SKILL.md) |
+
## Flow Diagram
```