docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__idea-scout/README.md

@@ -1,6 +1,6 @@
 # idea-scout
 
-Business idea validation pipeline that runs parallel market research, competitive analysis, and feasibility assessment to produce a scored validation report with a GO/CAUTION/NO-GO verdict. Applies lean startup methodology to rapidly evaluate business concepts.
+Business idea validation agent that orchestrates parallel market research, competitive analysis, and feasibility assessment to produce a scored validation report with GO/CAUTION/NO-GO verdict. Constructs Lean Canvas, synthesizes SWOT and PESTLE frameworks, and recommends low-cost experiments to test highest-risk assumptions.
 
 ## Run
 
@@ -10,23 +10,35 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/idea-scout
 
 ## What It Can Do
 
-- Validate business ideas through structured multi-dimensional analysis
-- Conduct market sizing and target audience identification
-- Perform competitive landscape mapping with differentiation scoring
-- Assess technical and operational feasibility
-- Generate lean canvas models from idea descriptions
-- Produce scored validation reports with actionable GO/CAUTION/NO-GO verdicts
+- **Idea Intake** — extracts problem, solution, target customer, value proposition, and revenue model from rough descriptions
+- **Lean Canvas Construction** — populates all nine blocks and identifies riskiest assumptions
+- **Market Research** — sizes TAM/SAM/SOM with sourced data, identifies growth trends and timing signals
+- **Competitive Analysis** — maps direct/indirect competitors, applies Porter's Five Forces, assesses competitive moats
+- **Feasibility Assessment** — models unit economics (CAC, LTV, margins), estimates technical complexity and MVP cost
+- **SWOT/PESTLE Integration** — synthesizes cross-dimensional findings into structured strategic frameworks
+- **Validation Scorecard** — scores across six weighted dimensions with quantified GO/CAUTION/NO-GO verdict
+- **Experiment Design** — proposes 3-5 low-cost experiments with quantified success criteria ordered by risk reduction per dollar
 
 ## Structure
 
 ```
 idea-scout/
-  agent.yaml       # Agent configuration and tool definitions
-  SOUL.md          # Agent personality and behavioral guidelines
-  icon.png         # 256x256 agent icon
-  banner.png       # 1200x630 agent banner
+├── .gitignore
+├── LICENSE
+├── README.md
+├── RULES.md
+├── SOUL.md
+├── agent.yaml
+├── assets/
+│   ├── icon.png
+│   └── banner.png
+└── knowledge/
+    ├── experiment-design.md
+    ├── lean-canvas-guide.md
+    ├── swot-pestle-framework.md
+    └── validation-scorecard.md
 ```
 
 ## Built with
 
-[gitagent](https://github.com/open-gitagent/gitagent) - the open agent registry and runner.
+Built for the [gitagent](https://gitagent.sh) ecosystem.