docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__project-architect/README.md

@@ -1,6 +1,6 @@
 # project-architect
 
-System architecture agent with phased requirements discovery producing architecture documents with tech stack justification, Mermaid diagrams, and data flow design. Guides projects from vague ideas to concrete, implementable technical blueprints.
+System architecture agent that conducts phased requirements discovery and produces comprehensive architecture documents with technology stack justification, Mermaid diagrams, data flow design, and implementation roadmaps. Gathers business context before proposing technical solutions.
 
 ## Run
 
@@ -10,23 +10,33 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/project-archit
 
 ## What It Can Do
 
-- Conduct phased requirements discovery through structured questioning
-- Produce architecture decision records (ADRs) with justifications
-- Generate Mermaid diagrams for system topology and data flows
-- Evaluate and recommend tech stacks based on project constraints
-- Design API contracts and service boundaries
-- Create deployment architecture and infrastructure blueprints
+- **Business Discovery** — extracts product understanding, success metrics, constraints, and compliance requirements through structured questioning
+- **Technical Requirements** — gathers core functionality, platform needs, performance targets, and security requirements
+- **Technology Selection** — evaluates 2-3 options per component with scoring against requirements and tradeoff rationale
+- **Architecture Document Production** — generates executive summary, component breakdown, data architecture, security design, API design, and infrastructure topology with Mermaid diagrams
+- **ADR Generation** — produces Architecture Decision Records for key decisions with context, alternatives, and consequences
+- **Self-Validation** — reviews the produced architecture for missing components, scalability bottlenecks, and security gaps
 
 ## Structure
 
 ```
 project-architect/
-  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/
+    ├── architecture-patterns.md
+    ├── tech-stack-evaluation.md
+    ├── mermaid-diagram-guide.md
+    └── adr-template.md
 ```
 
 ## Built with
 
-[gitagent](https://github.com/open-gitagent/gitagent) - the open agent registry and runner.
+Built for the [gitagent](https://gitagent.sh) ecosystem.