docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__team-lead/README.md

@@ -1,41 +1,41 @@
 # team-lead
 
-Meta-orchestrator agent that analyzes complex requests, decomposes them into agent-sized tasks, and delegates to specialized agents. Manages sequencing, parallelism, and result synthesis across multi-agent workflows.
-
----
+Multi-agent orchestration engine that decomposes complex requests into agent-sized tasks, delegates to specialized agents, manages execution order and dependencies, and synthesizes results into unified deliverables. The conductor that coordinates architecture, implementation, content, research, and release pipelines.
 
 ## Run
 
 ```bash
 npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/team-lead
 ```
 
----
-
 ## What It Can Do
 
-- **Task Decomposition** — Break complex requests into discrete, agent-sized work units
-- **Agent Delegation** — Route tasks to the most suitable specialized agent based on capabilities
-- **Sequencing** — Determine dependency order and execute tasks in the correct sequence
-- **Parallel Execution** — Identify independent tasks and run them concurrently for throughput
-- **Result Synthesis** — Collect outputs from multiple agents and merge into a coherent deliverable
-- **Error Recovery** — Detect agent failures and reassign or retry with adjusted parameters
-
----
+- **Task Decomposition** — breaks complex goals into agent-sized units with dependency graphs and parallel execution paths
+- **Agent Delegation** — matches tasks to specialized agents with surgical accuracy based on domain capabilities
+- **Workflow Patterns** — applies Build, Validate-then-Build, Research-and-Propose, Ship, and Content patterns
+- **Conditional Gates** — enforces audit-before-ship, validate-before-build, and research-before-write checkpoints
+- **Progress Tracking** — reports status as each agent completes, flags blockers, adapts plans when outputs change constraints
+- **Result Synthesis** — collects multi-agent outputs into unified summaries with deliverable links and open items
 
 ## Structure
 
 ```
 team-lead/
-├── agent.yaml
-├── SOUL.md
-├── RULES.md
+├── .gitignore
 ├── LICENSE
-├── icon.png
-└── banner.png
+├── README.md
+├── RULES.md
+├── SOUL.md
+├── agent.yaml
+├── assets/
+│   ├── icon.png
+│   └── banner.png
+└── knowledge/
+    ├── agent-capabilities-index.md
+    ├── coordination-protocols.md
+    └── delegation-patterns.md
 ```
 
----
-
 ## Built with
-[gitagent](https://github.com/open-gitagent/gitagent) — a git-native, framework-agnostic open standard for AI agents.
+
+Built for the [gitagent](https://gitagent.sh) ecosystem.