[] updated

This commit is contained in:
Shayan Rais
2026-01-29 17:33:43 +05:00
parent 8f7b83116c
commit 3719a90b50
12 changed files with 39 additions and 35 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 143 KiB

Before

Width:  |  Height:  |  Size: 2.8 KiB

After

Width:  |  Height:  |  Size: 2.8 KiB

Before

Width:  |  Height:  |  Size: 2.9 KiB

After

Width:  |  Height:  |  Size: 2.9 KiB

+4 -4
View File
@@ -1,6 +1,6 @@
--- ---
name: weather name: weather
description: Use this agent PROACTIVELY when you need to fetch and transform weather data for Karachi, Pakistan. This agent fetches real-time temperature from wttr.in API and applies transformation rules from input/input.md, writing results to output/output.md. description: Use this agent PROACTIVELY when you need to fetch and transform weather data for Karachi, Pakistan. This agent fetches real-time temperature from wttr.in API and applies transformation rules from weather-orchestration/input.md, writing results to weather-orchestration/output.md.
tools: WebFetch, Read, Write tools: WebFetch, Read, Write
model: haiku model: haiku
color: green color: green
@@ -32,9 +32,9 @@ Follow the weather-fetcher skill instructions to:
### Step 2: Transform Temperature (weather-transformer skill) ### Step 2: Transform Temperature (weather-transformer skill)
Follow the weather-transformer skill instructions to: Follow the weather-transformer skill instructions to:
- Read transformation rules from `input/input.md` - Read transformation rules from `weather-orchestration/input.md`
- Apply the transformation to the fetched temperature - Apply the transformation to the fetched temperature
- Write formatted results to `output/output.md` - Write formatted results to `weather-orchestration/output.md`
## Final Report ## Final Report
@@ -43,7 +43,7 @@ After completing both steps, provide a summary:
- Original temperature fetched - Original temperature fetched
- Transformation rule applied - Transformation rule applied
- Final transformed result - Final transformed result
- Confirmation that output was written to `output/output.md` - Confirmation that output was written to `weather-orchestration/output.md`
## Critical Requirements ## Critical Requirements
+3 -3
View File
@@ -21,7 +21,7 @@ Use the Task tool to invoke the weather agent.
Use the Task tool to invoke the weather agent: Use the Task tool to invoke the weather agent:
- subagent_type: weather - subagent_type: weather
- description: Fetch and transform Karachi weather - description: Fetch and transform Karachi weather
- prompt: Fetch the current temperature for Karachi, Pakistan in [unit requested by user]. Then apply the transformation rules from input/input.md and write the results to output/output.md. The agent has preloaded skills (weather-fetcher and weather-transformer) that provide the detailed instructions. - prompt: Fetch the current temperature for Karachi, Pakistan in [unit requested by user]. Then apply the transformation rules from weather-orchestration/input.md and write the results to weather-orchestration/output.md. The agent has preloaded skills (weather-fetcher and weather-transformer) that provide the detailed instructions.
- model: haiku - model: haiku
Wait for the agent to complete its workflow. Wait for the agent to complete its workflow.
@@ -37,5 +37,5 @@ Wait for the agent to complete its workflow.
Provide a clear summary to the user showing: Provide a clear summary to the user showing:
- Temperature unit requested - Temperature unit requested
- Original temperature fetched - Original temperature fetched
- Transformation rule applied (from input/input.md) - Transformation rule applied (from weather-orchestration/input.md)
- Final transformed result (written to output/output.md) - Final transformed result (written to weather-orchestration/output.md)
+2 -2
View File
@@ -18,9 +18,9 @@
}, },
"spinnerVerbs": { "spinnerVerbs": {
"mode": "replace", "mode": "replace",
"verbs": ["Hiring new dev", "Burning mac harddisk", "Deleting production db", "rm -rf", "Switching to old commit"] "verbs": ["Hiring new dev", "Burning mac harddisk", "Switching to old commit", "Leaking API keys", "Hardcoding credentials", "Trusting user input", "Disabling 2FA", "Ignoring .gitignore", "Bypassing code review"]
}, },
"plansDirectory": "./plans", "plansDirectory": "./reports",
"enableAllProjectMcpServers": true, "enableAllProjectMcpServers": true,
"disableAllHooks": false, "disableAllHooks": false,
"hooks": { "hooks": {
+7 -7
View File
@@ -1,6 +1,6 @@
--- ---
name: weather-transformer name: weather-transformer
description: Instructions for applying mathematical transformations to temperature data based on rules in input/input.md description: Instructions for applying mathematical transformations to temperature data based on rules in weather-orchestration/input.md
--- ---
# Weather Transformer Skill # Weather Transformer Skill
@@ -13,13 +13,13 @@ Apply mathematical transformations to a temperature value and write results to o
## Instructions ## Instructions
1. **Read Transformation Rules**: Use the Read tool to read `input/input.md` which contains the transformation instructions. 1. **Read Transformation Rules**: Use the Read tool to read `weather-orchestration/input.md` which contains the transformation instructions.
2. **Apply Transformation**: Apply the transformation rule to the temperature value. 2. **Apply Transformation**: Apply the transformation rule to the temperature value.
- Example: If instruction says "add +10", add 10 to the temperature - Example: If instruction says "add +10", add 10 to the temperature
- Example: If instruction says "multiply by 2", multiply temperature by 2 - Example: If instruction says "multiply by 2", multiply temperature by 2
3. **Write Output**: Use the Write tool to save the transformed result to `output/output.md` with proper formatting. 3. **Write Output**: Use the Write tool to save the transformed result to `weather-orchestration/output.md` with proper formatting.
## Expected Input ## Expected Input
@@ -30,7 +30,7 @@ Temperature: [X]°C
## Expected Output ## Expected Output
Write to `output/output.md` with format: Write to `weather-orchestration/output.md` with format:
```markdown ```markdown
# Weather Transformation Result # Weather Transformation Result
@@ -38,7 +38,7 @@ Write to `output/output.md` with format:
[X]°C [X]°C
## Transformation Applied ## Transformation Applied
[description from input/input.md] [description from weather-orchestration/input.md]
## Final Result ## Final Result
[Y]°C [Y]°C
@@ -49,6 +49,6 @@ Write to `output/output.md` with format:
## Notes ## Notes
- Read the exact transformation from input/input.md - don't assume - Read the exact transformation from weather-orchestration/input.md - don't assume
- Show your work: include original value, transformation, and result - Show your work: include original value, transformation, and result
- Ensure output/output.md is properly formatted and readable - Ensure weather-orchestration/output.md is properly formatted and readable
+3 -3
View File
@@ -13,9 +13,9 @@ A demonstration of the **Command → Agent → Skills** architecture pattern:
- `/weather-orchestrator` command (`.claude/commands/weather-orchestrator.md`): Entry point that invokes the weather agent - `/weather-orchestrator` command (`.claude/commands/weather-orchestrator.md`): Entry point that invokes the weather agent
- `weather` agent (`.claude/agents/weather.md`): Executes workflow using preloaded skills - `weather` agent (`.claude/agents/weather.md`): Executes workflow using preloaded skills
- `weather-fetcher` skill (`.claude/skills/weather-fetcher/SKILL.md`): Instructions for fetching temperature from wttr.in API - `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` - `weather-transformer` skill (`.claude/skills/weather-transformer/SKILL.md`): Instructions for applying transformation rules from `weather-orchestration/input.md`, writes results to `weather-orchestration/output.md`
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. The agent has skills preloaded via the `skills` field, providing domain knowledge for sequential execution. See `weather-orchestration/weather-orchestration-architecture.md` for the complete flow diagram.
### Skill Definition Structure ### Skill Definition Structure
Skills in `.claude/skills/<name>/SKILL.md` use YAML frontmatter: Skills in `.claude/skills/<name>/SKILL.md` use YAML frontmatter:
@@ -86,7 +86,7 @@ From experience with this repository:
## Documentation ## Documentation
- `docs/AGENTS.md`: Subagent orchestration troubleshooting - `docs/AGENTS.md`: Subagent orchestration troubleshooting
- `docs/WEATHER.md`: Weather system flow diagram - `weather-orchestration/weather-orchestration-architecture.md`: Weather system flow diagram
- `docs/COMPARISION.md`: Commands vs Agents vs Skills invocation patterns - `docs/COMPARISION.md`: Commands vs Agents vs Skills invocation patterns
## Reports ## Reports
+7 -3
View File
@@ -6,7 +6,11 @@ practice makes claude perfect
</a> </a>
<p align="center"> <p align="center">
<img src="assets/claude-jumping.svg" alt="Claude Code mascot jumping" width="120" height="100"> <img src="!/claude-jumping.svg" alt="Claude Code mascot jumping" width="120" height="100">
</p>
<p align="center">
<img src="!/boris-cherny.png" alt="Claude Code Creator" width="50%" height="50%">
</p> </p>
@@ -83,7 +87,7 @@ practice makes claude perfect
## COMMAND + SKILL + SUBAGENT ARCHITECTURE ## COMMAND + SKILL + SUBAGENT ARCHITECTURE
<p align="center"> <p align="center">
<img src="assets/command-skill-agent-flow.svg" alt="Command Skill Agent Architecture Flow" width="600"> <img src="!/command-skill-agent-flow.svg" alt="Command Skill Agent Architecture Flow" width="600">
</p> </p>
| Component | Role | Example | | Component | Role | Example |
@@ -96,7 +100,7 @@ practice makes claude perfect
**Why it works:** Progressive disclosure • Single execution context • Clean separation • Reusability **Why it works:** Progressive disclosure • Single execution context • Clean separation • Reusability
See [docs/weather-flow-architecture.md](docs/weather-flow-architecture.md) for implementation details. See [weather-orchestration/weather-orchestration-architecture.md](weather-orchestration/weather-orchestration-architecture.md) for implementation details.
## SETTINGS ## SETTINGS
@@ -1,13 +1,13 @@
# Weather Transformation Result # Weather Transformation Result
## Original Temperature ## Original Temperature
25°C 24°C
## Transformation Applied ## Transformation Applied
Add +20 to the temperature value Add +20 to the temperature value
## Final Result ## Final Result
45°C 44°C
## Calculation Details ## Calculation Details
25°C + 20 = 45°C 24°C + 20 = 44°C
@@ -46,7 +46,7 @@ The weather system demonstrates the **Command → Agent → Skills** architectur
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐
│ wttr.in API │ │ input/input.md │ wttr.in API │ │ weather-orchestration/
│ Fetch Temperature │ │ Read Transform Rules │ │ Fetch Temperature │ │ Read Transform Rules │
│ for Karachi │ └─────────────────────────┘ │ for Karachi │ └─────────────────────────┘
└─────────────────────────┘ │ └─────────────────────────┘ │
@@ -58,7 +58,7 @@ The weather system demonstrates the **Command → Agent → Skills** architectur
┌─────────────────────────┐ ┌─────────────────────────┐
output/output.md │ weather-orchestration/output.md │
│ Write Results │ │ Write Results │
└─────────────────────────┘ └─────────────────────────┘
@@ -102,17 +102,17 @@ The agent has skills preloaded into its context at startup. It follows the instr
#### `weather-transformer` (Skill) #### `weather-transformer` (Skill)
- **Location**: `.claude/skills/weather-transformer/SKILL.md` - **Location**: `.claude/skills/weather-transformer/SKILL.md`
- **Purpose**: Instructions for applying mathematical transformations - **Purpose**: Instructions for applying mathematical transformations
- **Input Source**: `input/input.md` (transformation rules) - **Input Source**: `weather-orchestration/input.md` (transformation rules)
- **Output Destination**: `output/output.md` (formatted results) - **Output Destination**: `weather-orchestration/output.md` (formatted results)
### 4. Data Files ### 4. Data Files
#### `input/input.md` #### `weather-orchestration/input.md`
- **Purpose**: Stores transformation rules - **Purpose**: Stores transformation rules
- **Format**: Natural language instructions (e.g., "add +10 in the result") - **Format**: Natural language instructions (e.g., "add +10 in the result")
- **Access**: Read by weather agent following weather-transformer skill - **Access**: Read by weather agent following weather-transformer skill
#### `output/output.md` #### `weather-orchestration/output.md`
- **Purpose**: Stores formatted transformation results - **Purpose**: Stores formatted transformation results
- **Format**: Structured markdown with sections: - **Format**: Structured markdown with sections:
- Original Temperature - Original Temperature
@@ -128,9 +128,9 @@ The agent has skills preloaded into its context at startup. It follows the instr
4. **Skill Execution** (within agent context): 4. **Skill Execution** (within agent context):
- **Step 1**: Agent follows `weather-fetcher` skill instructions to fetch temperature from wttr.in - **Step 1**: Agent follows `weather-fetcher` skill instructions to fetch temperature from wttr.in
- **Step 2**: Agent follows `weather-transformer` skill instructions to: - **Step 2**: Agent follows `weather-transformer` skill instructions to:
- Read transformation rules from `input/input.md` - Read transformation rules from `weather-orchestration/input.md`
- Apply rules to the fetched temperature - Apply rules to the fetched temperature
- Write formatted results to `output/output.md` - Write formatted results to `weather-orchestration/output.md`
5. **Result Display**: Summary shown to user with: 5. **Result Display**: Summary shown to user with:
- Temperature unit requested - Temperature unit requested
- Original temperature - Original temperature
@@ -150,9 +150,9 @@ Input: /weather-orchestrator
│ ├─ Step 1 (weather-fetcher skill): │ ├─ Step 1 (weather-fetcher skill):
│ │ └─ Fetches from wttr.in → 26°C │ │ └─ Fetches from wttr.in → 26°C
│ ├─ Step 2 (weather-transformer skill): │ ├─ Step 2 (weather-transformer skill):
│ │ ├─ Reads: input/input.md ("add +10") │ │ ├─ Reads: weather-orchestration/input.md ("add +10")
│ │ ├─ Calculates: 26 + 10 = 36°C │ │ ├─ Calculates: 26 + 10 = 36°C
│ │ └─ Writes: output/output.md │ │ └─ Writes: weather-orchestration/output.md
│ └─ Returns: Complete report │ └─ Returns: Complete report
└─ Output: └─ Output:
├─ Unit: Celsius ├─ Unit: Celsius