diff --git a/!/command-skill-agent-flow.svg b/!/command-skill-agent-flow.svg index 1f9c3e2..363fb90 100644 --- a/!/command-skill-agent-flow.svg +++ b/!/command-skill-agent-flow.svg @@ -28,7 +28,7 @@ Task - + Agent agents/weather-agent diff --git a/!/tags/how-to-implement.svg b/!/tags/how-to-implement.svg new file mode 100644 index 0000000..e3babf7 --- /dev/null +++ b/!/tags/how-to-implement.svg @@ -0,0 +1,17 @@ + + How to Implement + + + + + + + + + + + + + How to Implement + + \ No newline at end of file diff --git a/!/tags/how-to-use.svg b/!/tags/how-to-use.svg new file mode 100644 index 0000000..1d1ecb8 --- /dev/null +++ b/!/tags/how-to-use.svg @@ -0,0 +1,17 @@ + + How to Use + + + + + + + + + + + + + How to Use + + \ No newline at end of file diff --git a/.claude/agents/weather-agent.md b/.claude/agents/weather-agent.md index 60b1025..da3741c 100644 --- a/.claude/agents/weather-agent.md +++ b/.claude/agents/weather-agent.md @@ -1,14 +1,35 @@ --- name: weather-agent -description: Use this agent PROACTIVELY when you need to fetch weather data for - Dubai, UAE. This agent fetches real-time temperature from wttr.in API - using its preloaded weather-fetcher skill. -tools: WebFetch, Read +description: Use this agent PROACTIVELY when you need to fetch weather data for Dubai, UAE. This agent fetches real-time temperature from wttr.in API using its preloaded weather-fetcher skill. +tools: WebFetch, Read, Write, Edit model: sonnet -color: green +color: teal +maxTurns: 5 +permissionMode: acceptEdits memory: project skills: - weather-fetcher +hooks: + PreToolUse: + - matcher: ".*" + hooks: + - type: command + command: python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py --agent=voice-hook-agent + timeout: 5000 + async: true + PostToolUse: + - matcher: ".*" + hooks: + - type: command + command: python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py --agent=voice-hook-agent + timeout: 5000 + async: true + PostToolUseFailure: + - hooks: + - type: command + command: python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py --agent=voice-hook-agent + timeout: 5000 + async: true --- # Weather Agent diff --git a/README.md b/README.md index 9f41cb2..4fdc836 100644 --- a/README.md +++ b/README.md @@ -36,10 +36,9 @@ practice makes claude perfect | [**Checkpointing**](https://code.claude.com/docs/en/checkpointing) | automatic (git-based) | Automatic tracking of file edits with rewind (`Esc Esc` or `/rewind`) and targeted summarization | | [**Remote Control**](https://code.claude.com/docs/en/remote-control) | CLI / claude.ai | Continue local sessions from any device — phone, tablet, or browser · [Headless Mode](https://code.claude.com/docs/en/headless) | | [**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) Command-line flags, subcommands, and environment variables for launching Claude Code | +| **AI Terms** | | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) Agentic Engineering · Context Engineering · Vibe Coding | | [**Best Practices**](https://code.claude.com/docs/en/best-practices) | | Official best practices · [Extend Claude Code](https://code.claude.com/docs/en/features-overview) | -> **Note:** Custom slash commands have been merged into skills. Files in `.claude/commands/` still work, but skills (`.claude/skills/`) are recommended as they support additional features like supporting files, invocation control, and subagent execution. - ## Orchestration Workflow @@ -58,6 +57,19 @@ Workflow orchestration using the **Command → Agent → Skill** pattern. See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) for implementation details. +## DEVELOPMENT WORKFLOW +- [RPI](workflow/rpi/rpi-workflow.md) [![Implemented](!/tags/implemented.svg)](workflow/rpi/rpi-workflow.md) +- [Boris Feb26 workflow](https://x.com/bcherny/status/2017742741636321619) +- [Ralph plugin with sandbox](https://www.youtube.com/watch?v=eAtvoGlpeRU) +- [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) +- [AgentOs - 2026 its overkill (Brian Casel)](https://www.youtube.com/watch?v=0hdFJA-ho3c) +- [Github Speckit](https://github.com/github/spec-kit) +- [GSD - Get Shit Done](https://github.com/glittercowboy/get-shit-done) +- [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md) +- [Superpower](https://github.com/obra/superpowers) +- [Andrej Karpathy Workflow](https://github.com/forrestchang/andrej-karpathy-skills) +- [Creator of Clawd Bot Workflow](https://www.youtube.com/watch?v=8lF7HmQ_RgY) + ## MY EXPERIENCE ■ **Workflows** @@ -95,21 +107,6 @@ See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) f - [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md) - [Claude.md for larger monorepos - Boris Cherny on X](https://github.com/shanraisshan/claude-code-best-practice/blob/main/reports/claude-md-for-larger-mono-repos.md) -## WORKFLOWS -- [RPI](workflow/rpi/rpi-workflow.md) -- [Boris Feb26 workflow](https://x.com/bcherny/status/2017742741636321619) -- [Ralph plugin with sandbox](https://www.youtube.com/watch?v=eAtvoGlpeRU) -- [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) -- [AgentOs - 2026 its overkill (Brian Casel)](https://www.youtube.com/watch?v=0hdFJA-ho3c) -- [Github Speckit](https://github.com/github/spec-kit) -- [GSD - Get Shit Done](https://github.com/glittercowboy/get-shit-done) -- [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md) -- [Superpower](https://github.com/obra/superpowers) -- [Andrej Karpathy Workflow](https://github.com/forrestchang/andrej-karpathy-skills) -- [Creator of Clawd Bot Workflow](https://www.youtube.com/watch?v=8lF7HmQ_RgY) - - - ## CLAUDE CODE FEATURES INSPIRATION @@ -117,15 +114,6 @@ See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) f - [Claude Code Tasks - inspired by beats](https://www.reddit.com/r/ClaudeAI/comments/1qkjznp/anthropic_replaced_claude_codes_old_todos_with/) [Inspiration](https://github.com/steveyegge/beads) - [Ralph Plugin](https://x.com/GeoffreyHuntley/status/2015031262692753449) -## AI TERMS - -| | | | | | -|---|---|---|---|---| -| Agentic Engineering | AI Slop | Context Bloat | Context Engineering | Context Rot | -| Dumb Zone | Hallucination | Scaffolding | Orchestration | Vibe Coding | - -[**See Complete List →**](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) - ## REPORTS | Report | Description | diff --git a/best-practice/claude-subagents.md b/best-practice/claude-subagents.md index 325c551..11e21c1 100644 --- a/best-practice/claude-subagents.md +++ b/best-practice/claude-subagents.md @@ -161,7 +161,7 @@ Custom agents defined in `.claude/agents/` for this project: | Agent | Model | Color | Tools | Skills | Memory | |-------|-------|-------|-------|--------|--------| | [`presentation-curator`](../.claude/agents/presentation-curator.md) | sonnet | magenta | Read, Write, Edit, Grep, Glob | presentation/vibe-to-agentic-framework, presentation/presentation-structure, presentation/presentation-styling | — | -| [`weather-agent`](../.claude/agents/weather-agent.md) | sonnet | green | WebFetch, Read | weather-fetcher | project | +| [`weather-agent`](../.claude/agents/weather-agent.md) | sonnet | teal | WebFetch, Read, Write, Edit | weather-fetcher | project | | [`workflow-claude-subagents-agent`](../.claude/agents/workflows/best-practice/workflow-claude-subagents-agent.md) | opus | blue | All (inherited) | — | — | --- diff --git a/implementation/claude-commands-implementation.md b/implementation/claude-commands-implementation.md index f395c7b..b7b64a4 100644 --- a/implementation/claude-commands-implementation.md +++ b/implementation/claude-commands-implementation.md @@ -53,7 +53,7 @@ The command orchestrates the entire workflow: it asks the user for their tempera --- -## How to Use +## ![How to Use](../!/tags/how-to-use.svg) ```bash $ claude @@ -62,6 +62,12 @@ $ claude --- +## ![How to Implement](../!/tags/how-to-implement.svg) + +Ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/commands/.md` + +--- + Orchestration Workflow The weather orchestrator is the **Command** in the Command → Agent → Skill orchestration pattern. It serves as the entry point — handling user interaction (temperature unit preference), delegating data fetching to the `weather-agent`, and invoking the `weather-svg-creator` skill for visual output. diff --git a/implementation/claude-skills-implementation.md b/implementation/claude-skills-implementation.md index 23d4614..2721c5c 100644 --- a/implementation/claude-skills-implementation.md +++ b/implementation/claude-skills-implementation.md @@ -99,7 +99,7 @@ This is an **agent skill** — preloaded into the `weather-agent` at startup via --- -## How to Use +## ![How to Use](../!/tags/how-to-use.svg) **Skill** — invoke directly via slash command: ```bash @@ -107,27 +107,13 @@ $ claude > /weather-svg-creator ``` -**Agent Skill** — not directly invocable (`user-invocable: false`). Preloaded into the agent via `skills:` frontmatter: -```yaml -# In .claude/agents/weather-agent.md ---- -skills: - - weather-fetcher ---- -``` - --- -Orchestration Workflow +## ![How to Implement](../!/tags/how-to-implement.svg) -The skills are the final components in the Command → Agent → Skill orchestration pattern. The `weather-fetcher` is preloaded into the `weather-agent` as domain knowledge for API interaction, while the `weather-svg-creator` is invoked directly by the command to transform the fetched data into visual output. +Ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/skills/my-skill/SKILL.md` -

- Command Skill Agent Architecture Flow -

+# My Skill -| Component | Role | This Repo | -|-----------|------|-----------| -| **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) | +Instructions for what the skill does. +``` \ No newline at end of file diff --git a/implementation/claude-subagents-implementation.md b/implementation/claude-subagents-implementation.md index cb5fc2e..23d9905 100644 --- a/implementation/claude-subagents-implementation.md +++ b/implementation/claude-subagents-implementation.md @@ -58,7 +58,7 @@ The agent has one preloaded skill (`weather-fetcher`) that provides instructions --- -## How to Use +## ![How to Use](../!/tags/how-to-use.svg) ```bash $ claude @@ -67,6 +67,18 @@ $ claude --- +## ![How to Implement](../!/tags/how-to-implement.svg) + +You can create an agent using the `/agents` command, +```bash +$ claude +> /agents +``` + +or ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/agents/.md` + +--- + Orchestration Workflow The weather agent is the **Agent** in the Command → Agent → Skill orchestration pattern. It receives the workflow from the `/weather-orchestrator` command and fetches temperature using its preloaded skill (`weather-fetcher`). The command then invokes the standalone `weather-svg-creator` skill to create the visual output.