From cf12139f6e8d657258f712491f0bddb5fe5847fd Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Wed, 28 Jan 2026 18:49:01 +0500 Subject: [PATCH] [] --- .claude/commands/weather-orchestrator.md | 4 +--- CLAUDE.md | 26 +++++++++++++++++++++--- output/output.md | 6 +++--- 3 files changed, 27 insertions(+), 9 deletions(-) diff --git a/.claude/commands/weather-orchestrator.md b/.claude/commands/weather-orchestrator.md index c94ff03..9d0e7ce 100644 --- a/.claude/commands/weather-orchestrator.md +++ b/.claude/commands/weather-orchestrator.md @@ -14,9 +14,7 @@ Fetch the current temperature for Karachi, Pakistan and apply transformations. ## Agent Invocation -Use the Task tool to invoke the weather agent. This agent has two skills preloaded: -- `weather-fetcher`: Fetches current temperature from wttr.in API -- `weather-transformer`: Applies transformation rules and writes results +Use the Task tool to invoke the weather agent. ### Invoke Weather Agent diff --git a/CLAUDE.md b/CLAUDE.md index 6e5b27a..31c3a36 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,7 +15,7 @@ A demonstration of the **Command → Agent → Skills** architecture pattern: - `weather-fetcher` skill (`.claude/skills/weather-fetcher/SKILL.md`): Instructions for fetching temperature from wttr.in API - `weather-transformer` skill (`.claude/skills/weather-transformer/SKILL.md`): Instructions for applying transformation rules from `input/input.md`, writes results to `output/output.md` -The agent has skills preloaded via the `skills` field, providing domain knowledge for sequential execution. +The agent has skills preloaded via the `skills` field, providing domain knowledge for sequential execution. See `docs/weather-flow-architecture.md` for the complete flow diagram. ### Skill Definition Structure Skills in `.claude/skills//SKILL.md` use YAML frontmatter: @@ -28,12 +28,12 @@ Skills in `.claude/skills//SKILL.md` use YAML frontmatter: ### Hooks System Cross-platform sound notification system in `.claude/hooks/`: -- `scripts/hooks.py`: Main handler for all 11 Claude Code hook events +- `scripts/hooks.py`: Main handler for Claude Code hook events - `config/hooks-config.json`: Shared team configuration - `config/hooks-config.local.json`: Personal overrides (git-ignored) - `sounds/`: Audio files organized by hook event (generated via ElevenLabs TTS) -Hook events: PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStart, SubagentStop, PreCompact, SessionStart, SessionEnd, Setup, PermissionRequest. +Hook events configured in `.claude/settings.json`: PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStart, SubagentStop, PreCompact, SessionStart, SessionEnd, Setup, PermissionRequest. Special handling: git commits trigger `pretooluse-git-committing` sound. @@ -54,6 +54,7 @@ Subagents in `.claude/agents/*.md` use YAML frontmatter: - `tools`: Comma-separated list of allowed tools - `model`: Typically "haiku" for efficiency - `color`: CLI output color for visual distinction +- `skills`: List of skill names to preload into agent context ### Configuration Hierarchy 1. `.claude/settings.local.json`: Personal settings (git-ignored) @@ -63,6 +64,25 @@ Subagents in `.claude/agents/*.md` use YAML frontmatter: ### Disable Hooks Set `"disableAllHooks": true` in `.claude/settings.local.json`, or disable individual hooks in `hooks-config.json`. +## Workflow Best Practices + +From experience with this repository: + +- Keep CLAUDE.md under 150 lines for reliable adherence +- Use commands for workflows instead of standalone agents +- Create feature-specific subagents with skills (progressive disclosure) rather than general-purpose agents +- Perform manual `/compact` at ~50% context usage +- Start with plan mode for complex tasks +- Use human-gated todo list workflow for multi-step tasks +- Break subtasks small enough to complete in under 50% context + +### Debugging Tips + +- Use `/doctor` for diagnostics +- Run long-running terminal commands as background tasks for better log visibility +- Use browser automation MCPs (Claude in Chrome, Playwright, Chrome DevTools) for Claude to inspect console logs +- Provide screenshots when reporting visual issues + ## Documentation - `docs/AGENTS.md`: Subagent orchestration troubleshooting diff --git a/output/output.md b/output/output.md index bd67070..123cb79 100644 --- a/output/output.md +++ b/output/output.md @@ -1,13 +1,13 @@ # Weather Transformation Result ## Original Temperature -24°C +25°C ## Transformation Applied Add +20 to the temperature value ## Final Result -44°C +45°C ## Calculation Details -24°C + 20 = 44°C +25°C + 20 = 45°C