docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__codebase-auditor/README.md

@@ -1,6 +1,6 @@
 # codebase-auditor
 
-Unified multi-dimensional codebase quality assessment agent that spawns parallel review agents, complements with architecture and dependency analysis, and produces a prioritized report. Covers security, performance, maintainability, and correctness in a single pass.
+Multi-dimensional codebase quality assessment agent that orchestrates specialized reviewers in parallel — code quality, security vulnerabilities, secret detection, architecture integrity, and dependency health — and synthesizes findings into a single deduplicated, severity-ranked report with a binary PASS/FAIL verdict.
 
 ## Run
 
@@ -10,23 +10,32 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/codebase-audit
 
 ## What It Can Do
 
-- Run parallel quality assessments across security, performance, and maintainability dimensions
-- Analyze architecture patterns and identify structural anti-patterns
-- Audit dependency health, licensing, and vulnerability exposure
-- Generate prioritized findings with severity ratings and remediation guidance
-- Produce executive summaries and detailed technical reports
-- Support pre-release audit workflows and compliance checks
+- **Scope Analysis** — determines audit scope from changed files, direct dependencies, or full repository inventory
+- **Parallel Agent Spawning** — runs code quality, security, and secret detection reviews concurrently
+- **Architecture Review** — assesses structural integrity, module boundaries, coupling, and scalability patterns
+- **Dependency Audit** — checks for CVEs, license compliance, abandoned packages, and dependency bloat
+- **Aggregation and Deduplication** — merges overlapping findings, preserves highest severity, eliminates report noise
+- **Verdict Determination** — binary PASS (zero CRITICAL/HIGH) or FAIL with prioritized action items
 
 ## Structure
 
 ```
 codebase-auditor/
-  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/
+    ├── audit-dimensions.md
+    ├── report-template.md
+    └── severity-classification.md
 ```
 
 ## Built with
 
-[gitagent](https://github.com/open-gitagent/gitagent) - the open agent registry and runner.
+Built for the [gitagent](https://gitagent.sh) ecosystem.