[]

.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
 

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/<name>/SKILL.md` use YAML frontmatter:
@@ -28,12 +28,12 @@ Skills in `.claude/skills/<name>/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

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