docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__research-analyst/README.md

@@ -1,6 +1,6 @@
 # research-analyst
 
-Deep multi-source research agent. Spawns parallel investigation across web, academic, video, and competitive sources, then delivers cited synthesis with confidence ratings.
+Multi-source research agent that decomposes complex questions into investigatable sub-questions, dispatches parallel investigations across web, academic, video, and competitive sources, and synthesizes findings into structured reports with citations and confidence ratings.
 
 ## Run
 
@@ -10,22 +10,31 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/research-analy
 
 ## What It Can Do
 
-- Conduct parallel multi-source research across web, academic, and competitive landscapes
-- Synthesize findings into structured reports with inline citations
-- Assign confidence ratings to claims based on source quality and corroboration
-- Perform literature reviews and competitive analysis
-- Identify knowledge gaps and conflicting evidence across sources
+- **Question Framing** — decomposes research topics into structured sub-questions with source type selection before investigation begins
+- **Parallel Source Investigation** — spawns concurrent research agents across web, academic, video, and competitive sources for comprehensive coverage
+- **Cross-Reference Analysis** — merges findings from multiple sources, identifies corroboration and contradictions, assigns evidence-based confidence ratings
+- **Gap Detection** — explicitly flags what the research could not answer and why, preventing false completeness
+- **Synthesis Reports** — produces structured deliverables with executive summary, cited findings, comparison matrices, and actionable recommendations
 
 ## Structure
 
 ```
 research-analyst/
-  agent.yaml        # Agent configuration
-  SOUL.md           # Behavioral instructions and research methodology
-  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/
+    ├── research-methodology.md
+    ├── source-evaluation.md
+    └── synthesis-framework.md
 ```
 
 ## Built with
 
-Built with [gitagent](https://github.com/open-gitagent/gitagent).
+Built for the [gitagent](https://gitagent.sh) ecosystem.