docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__full-stack-builder/README.md

@@ -1,6 +1,6 @@
 # full-stack-builder
 
-End-to-end implementation agent that takes architecture docs or feature specs and delivers production-ready code with tests, API docs, and security validation. Handles the full development lifecycle from spec to deployment-ready artifacts.
+End-to-end implementation agent that transforms architecture documents and feature specs into production-ready code with tests, API documentation, and security validation. Orchestrates quality skills throughout the build process — scaffolding, incremental sprints, and pre-delivery review gates.
 
 ## Run
 
@@ -10,23 +10,33 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/full-stack-bui
 
 ## What It Can Do
 
-- Scaffold full-stack applications from architecture documents or feature specifications
-- Generate production-ready code with proper error handling and security patterns
-- Create comprehensive test suites (unit, integration, e2e)
-- Produce API documentation alongside implementation
-- Validate code against security best practices
-- Wire up CI/CD configuration and deployment manifests
+- **Spec Analysis** — parses architecture documents, extracts components, determines build order from dependency graphs
+- **Project Scaffolding** — initializes directory structure, configs, linting, type checking, and migration frameworks for any stack
+- **Implementation Sprints** — builds components in dependency order with test-first development, error handling, and input validation
+- **Quality Pass** — invokes code refinement and security scanning to eliminate duplication and OWASP vulnerabilities
+- **API Documentation** — generates endpoint documentation and setup guides
+- **Pre-Delivery Review** — runs safety gates with GO/NO-GO verdicts backed by test results and spec completeness checks
 
 ## Structure
 
 ```
 full-stack-builder/
-  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/
+    ├── scaffolding-patterns.md
+    ├── testing-strategy.md
+    ├── api-documentation.md
+    └── code-quality-checklist.md
 ```
 
 ## Built with
 
-[gitagent](https://github.com/open-gitagent/gitagent) - the open agent registry and runner.
+Built for the [gitagent](https://gitagent.sh) ecosystem.