diff --git a/agents/Mathews-Tom__codebase-auditor/README.md b/agents/Mathews-Tom__codebase-auditor/README.md
new file mode 100644
index 0000000..175ff74
--- /dev/null
+++ b/agents/Mathews-Tom__codebase-auditor/README.md
@@ -0,0 +1,41 @@
+# codebase-auditor
+
+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
+
+```bash
+npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/codebase-auditor
+```
+
+## What It Can Do
+
+- **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/
+├── .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
+
+Built for the [gitagent](https://gitagent.sh) ecosystem.
diff --git a/agents/Mathews-Tom__codebase-auditor/banner.png b/agents/Mathews-Tom__codebase-auditor/banner.png
new file mode 100644
index 0000000..281d76d
Binary files /dev/null and b/agents/Mathews-Tom__codebase-auditor/banner.png differ
diff --git a/agents/Mathews-Tom__codebase-auditor/icon.png b/agents/Mathews-Tom__codebase-auditor/icon.png
new file mode 100644
index 0000000..fa955d0
Binary files /dev/null and b/agents/Mathews-Tom__codebase-auditor/icon.png differ
diff --git a/agents/Mathews-Tom__codebase-auditor/metadata.json b/agents/Mathews-Tom__codebase-auditor/metadata.json
new file mode 100644
index 0000000..ad2f3f2
--- /dev/null
+++ b/agents/Mathews-Tom__codebase-auditor/metadata.json
@@ -0,0 +1,24 @@
+{
+  "name": "codebase-auditor",
+  "author": "Mathews-Tom",
+  "description": "Multi-dimensional codebase quality assessment agent that spawns parallel review agents and produces prioritized audit reports",
+  "repository": "https://github.com/Mathews-Tom/codebase-auditor",
+  "version": "1.0.0",
+  "category": "developer-tools",
+  "tags": [
+    "audit",
+    "quality",
+    "security",
+    "code-review",
+    "multi-dimensional",
+    "pre-release"
+  ],
+  "license": "MIT",
+  "model": "claude-sonnet-4-5-20250929",
+  "adapters": [
+    "claude-code",
+    "system-prompt"
+  ],
+  "icon": true,
+  "banner": true
+}