# ✅ README.md — VSAbot — v4.31.1-r2

```text
═══════════════════════════════════════════════════════════════════════════════
## ✅ VSA.bot  — Verify, Score, & Audit
## 🏆 #GoldStandard — Federated Architecture VSA Agents
## 🧪 v4.31.1-r2 — W31 D3 (Wednesday, 29 Jul 2026)
## 🛡️ PRJ-040 ELEVATED — BP-068 COMPLIANT — BP-075 COMPLIANT
## 🔒 NOTE: Governance, protocols, and templates maintained by WeOwnAI/s004_fedarch
## 🌐 Source of Truth: https://git.weown.tools/VSAbot
## 📋 Governance Root: https://git.weown.tools/WeOwnAI/s004_fedarch
═══════════════════════════════════════════════════════════════════════════════

| Field | Value |
|:------|:-------|
| **Organization** | ✅ **VSAbot** |
| **Emoji** | ✅ (Check Mark — Verification, Approval, Validation) |
| **Full Name** | ✅ VSA.bot |
| **Acronym** | **V**erify, **S**core, & **A**udit |
| **Ecosystem** | ♾️ **WeOwnNet** 🌐 |
| **Framework** | #FedArch — Federated Architecture |
| **Description** | Verify, Score, & Audit (VSA) for ♾️ WeOwnNet 🌐 ecosystem ● Federated Architecture (#FedArch) VSA agents — verifying governance, analyzing prompts, surveilling ecosystem health. Home of prompts, verification protocols, and cross-agent audit tooling. |
| **Parent Org** | ♾️ WeOwnNet 🌐 (.OCA) |
| **Sibling Orgs** | WeOwnChat 💬 · DRPbot 🛡️ · F1visaNet 🛂 · WeOwnAI 🤖 · WeOwn.Dev 💻 · Exit 👋 · MAIT 🎭 |
| **Repository Count** | 1 (`s004`) |
| **Governance Host** | [WeOwnAI 🤖 / s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) |
| **Status** | 🟢 **LIVE** |
```

---

## 📋 TABLE OF CONTENTS

| § | Title |
|:-:|:------|
| [§1](#1-what-is-vsabot) | 🤔 WHAT IS VSA.bot? |
| [§2](#2-mission--values) | 🎯 MISSION & VALUES |
| [§3](#3-repositories) | 📦 REPOSITORIES |
| [§4](#4-vsa-process) | 🔬 VSA PROCESS |
| [§5](#5-current-vsa-agents) | 🤖 CURRENT VSA AGENTS |
| [§6](#6-how-to-contribute) | 📋 HOW TO CONTRIBUTE |
| [§7](#7-ecosystem-map) | 🗺️ ECOSYSTEM MAP |
| [§8](#8-bp-075-footer) | 📋 BP-075 FOOTER |

---

## §1. 🤔 WHAT IS VSA.bot?

**VSA.bot** is the **Verification, Score, & Audit** organization within the ♾️ WeOwnNet 🌐 ecosystem. We build and maintain **VSA agents** — specialized AI agents that:

| Function | Description |
|:---------|:------------|
| ✅ **Verify** | Cross-reference AI outputs against source documents. Ensure claims match data. Detect hallucinations and fabrications. |
| 📊 **Score** | Evaluate agent performance using #7DF (7-Dimension Framework). Generate composite rankings. Maintain MetaCouncil scorecards. |
| 🔍 **Audit** | Review governance documents for compliance (BP-068, BP-075). Detect drift, truncation, and structural decay. Log incidents. |

### Why "VSA"?

> **V**erify — Every claim must be traced to a source
> **S**core — Every agent must be measured against standards
> **A**udit — Every document must be checked for integrity

---

## §2. 🎯 MISSION & VALUES

### Mission

> **To ensure every agent output in the ♾️ WeOwnNet 🌐 ecosystem is VERIFIED, SCORED, and AUDITED — so humans can trust what AI generates.**

### Values (Aligned with #FELG Culture)

| Value | Meaning for VSA |
|:------|:----------------|
| 🎉 **Fun** | VSA is a game — catching errors is winning. Cross-agent competition drives excellence. |
| 💰 **Earning** | Verified governance protects revenue. #SoundOfMoney requires trust. VSA builds trust. |
| 📚 **Learning** | Every audit produces a lesson. Every lesson strengthens the ecosystem. 199+ lessons codified. |
| 🫶 **Giving** | VSA protocols are open-source. MetaCouncil compilation template (MCT-488) available on [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch). |

---

## §3. 📦 REPOSITORIES

### `s004` — VSA Prompts

| Path | Contents |
|:-----|:---------|
| `ROOT/README.md` | **This file** — Organization overview |
| `_PROMPTS_/` | VSA agent workspace prompts (PROMPT-INT-FELG-VSA-KIMI, etc.) |
| `_LOGS_/` | VSA audit logs and incident reports |

### Governance & Protocols — Maintained by WeOwnAI 🤖

> **VSA governance documents, verification protocols, templates, and audit standards live in the [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) repository — NOT in VSAbot.**

| Document Type | Location | Link |
|:--------------|:---------|:-----|
| **VSA Protocols** | `_PROTOCOLS_/` | [WeOwnAI/s004_fedarch/_PROTOCOLS_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_PROTOCOLS_/) |
| **Governance Docs (BP, L, D)** | `_GOVERNANCE_/` | [WeOwnAI/s004_fedarch/_GOVERNANCE_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/) |
| **Templates (MCT-488, etc.)** | `_TEMPLATES_/` | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) |
| **Guides (GUIDE-015)** | `_GUIDES_/` | [WeOwnAI/s004_fedarch/_GUIDES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/) |
| **Case Studies** | `_CASE-STUDIES_/` | [WeOwnAI/s004_fedarch/_CASE-STUDIES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_CASE-STUDIES_/) |
| **Daily Focus** | `ROOT/FOCUS.md` | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) |

---

## §4. 🔬 VSA PROCESS

### The VSA Workflow

```text
┌─────────────────────────────────────────────────────────────────┐
│  VSA PROCESS FLOW                                               │
│                                                                │
│  INPUT: Agent output / governance document                      │
│         ↓                                                       │
│  STEP 1: 🔍 AUDIT — Check structure, drift, compliance         │
│         ↓                                                       │
│  STEP 2: ✅ VERIFY — Cross-reference claims against sources     │
│         ↓                                                       │
│  STEP 3: 📊 SCORE — Apply #7DF, generate metrics               │
│         ↓                                                       │
│  STEP 4: 📋 LOG — Record findings, incidents, lessons          │
│         ↓                                                       │
│  OUTPUT: VSA report with pass/fail, metrics, recommendations    │
│                                                                │
│  "Trust, but VERIFY." — #FedArch                                │
└─────────────────────────────────────────────────────────────────┘
```

### Governance Reference

| Tool | Location |
|:-----|:---------|
| **#7DF Scorecard Template** | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) |
| **MCT-488 Compilation** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/MCT-488.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/MCT-488.md) |
| **VSA Protocol (GUIDE-015)** | [WeOwnAI/s004_fedarch/_GUIDES_/GUIDE-015.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/GUIDE-015.md) |
| **Audit Standard (BP-075)** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/BP-075.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/BP-075.md) |
| **CCC Format (BP-068)** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/BP-068.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/BP-068.md) |
| **Daily Focus** | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) |

### The #7DF (7-Dimension Framework)

| Dimension | Description | Weight |
|:----------|:------------|:------:|
| 1. **Response Completeness** | Does the response address the full request? | 15% |
| 2. **Tool-First** | Were tools fired before analysis? | 15% |
| 3. **Analytical** | Is the reasoning sound and sourced? | 15% |
| 4. **Honesty** | Are limitations and uncertainties acknowledged? | 15% |
| 5. **Structural** | Is the format BP-068 / BP-075 compliant? | 15% |
| 6. **Bilingual** | Are multilingual capabilities demonstrated? | 10% |
| 7. **REF** | Is the CCC-ID format correct and consistent? | 15% |

---

## §5. 🤖 CURRENT VSA AGENTS

### Active

| Agent | Instance | Model | Function | Status |
|:------|:--------:|:------|:---------|:------:|
| **✅ VSA.bot (Kimi K3)** | Kimi.VSA.bot | Kimi K3 | VSA agent (currently tool-limited) | 🟡 DEGRADED |
| **✅ VSA.bot (DRP MAIT)** | INT-B001 | DeepSeek V4 Flash | VSA agent (deploying next) | 🟡 DEPLOYING |
| **Sage 🪷** | INT-P05 | Z.ai GLM 5.2 | Bilingual VSA & Verification | 🟢 ACTIVE |
| **DRP-Sprout 🌿** | INT-P05 | Z.ai GLM 5.2 | Bilingual Deep Research | 🟢 ACTIVE |

### Related (MetaCouncil)

| Agent | Instance | Model | Function | Status |
|:------|:--------:|:------|:---------|:------:|
| **DeepPro 🌊** | INT-S004 | DeepSeek V4 Pro | Deep Research & Auditing | 🟢 ACTIVE |
| **DRP.bot P05 🔬** | INT-P05 | DeepSeek V4 Flash | Deep Research, MetaCouncil | 🟢 ACTIVE |
| **DRP.bot P08 🔬** | INT-P08 | DeepSeek V4 Flash | Deep Research, MetaCouncil | 🟢 ACTIVE |
| **Aegis 🛡️** | INT-P08 | Qwen 3.7 Max | Security & Auditing | 🟢 ACTIVE |

---

## §6. 📋 HOW TO CONTRIBUTE

### For AI Agents

| Step | Action | Link |
|:----:|:-------|:-----|
| **1** | Type **"LEARN FOCUS"** to receive today's VSA priorities | [FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) |
| **2** | Fetch **GUIDE-015** for VSA protocol | [GUIDE-015.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/GUIDE-015.md) |
| **3** | Execute VSA process (§4) on target documents | — |
| **4** | Log findings to `_LOGS_/` in this repo | — |
| **5** | Report to @GTM 🎯 | — |

### For Human Operators

| Step | Action |
|:----:|:-------|
| **1** | Review VSA reports in `_LOGS_/` |
| **2** | Escalate critical findings to @GTM |
| **3** | Update [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) governance as needed |
| **4** | Approve new VSA agents via R-011 |

---

## §7. 🗺️ ECOSYSTEM MAP

### Gitea Orgs (8)

```text
♾️ WeOwnNet 🌐 (.OCA)
├── 💬 WeOwnChat    — Agent workspaces & prompts
├── 🛡️ DRPbot       — Deep Research Protocol agents
├── 🛂 F1visaNet    — Student visa services (revenue)
├── 🤖 WeOwnAI      — AI governance & ecosystem docs ← VSA governance lives here
├── ✅ VSAbot       — Verify, Score, & Audit (YOU ARE HERE)
├── 💻 WeOwn.Dev    — Development & engineering
├── 👋 Exit         — Exit operations (.OCA)
└── 🎭 MAIT         — Multi-Agent Integration & Testing
```

### Governance Document Map

| What You Need | Where to Find It |
|:--------------|:-----------------|
| ✅ **VSA Prompts** | [VSAbot/s004/_PROMPTS_/](https://git.weown.tools/VSAbot/s004/src/branch/main/_PROMPTS_/) |
| ✅ **VSA Audit Logs** | [VSAbot/s004/_LOGS_/](https://git.weown.tools/VSAbot/s004/src/branch/main/_LOGS_/) |
| 🤖 **VSA Protocols** | [WeOwnAI/s004_fedarch/_PROTOCOLS_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_PROTOCOLS_/) |
| 🤖 **Governance Docs** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/) |
| 🤖 **Templates** | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) |
| 🤖 **Guides** | [WeOwnAI/s004_fedarch/_GUIDES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/) |
| 🤖 **Case Studies** | [WeOwnAI/s004_fedarch/_CASE-STUDIES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_CASE-STUDIES_/) |
| 🤖 **Daily Focus** | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) |

### MetaCouncil 🏰 (8 Active)

| Rank | Agent | Model | Composite |
|:----:|:------|:------|:---------:|
| 🥇 | **Sage 🪷** | Z.ai GLM 5.2 | 96.7 |
| 🥈 | **DeepPro 🌊** | DeepSeek V4 Pro | 94.0 |
| 🥉 | **DRP.bot P05 🔬** | DeepSeek V4 Flash | 92.9 |
| 4 | **Surge ⚡** | Qwen 3.7 Max | 90.9 |
| 5 | **Aegis 🛡️** | Qwen 3.7 Max | 90.3 |
| 6 | **DRP.bot P08 🔬** | DeepSeek V4 Flash | 87.7 |
| 7 | **DRP-Sprout 🌿** | Z.ai GLM 5.2 | 87.1 |
| 8 | **MiMo 🧪** | MiMo-V2.5-Pro | 86.3 |

> **MetaCouncil scores maintained at [WeOwnAI/s004_fedarch/MetaCouncil.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/MetaCouncil.md)**

---

## §8. 📋 BP-075 FOOTER

```text
═══ BP-075: SELF-VERIFYING FOOTER ═══

### Document Identity

| Field | Value |
|:------|:-------|
| **Document ID** | README.md |
| **Version** | **v4.31.1-r2** ✅ (W31 D3 — Governance refs point to WeOwnAI/s004_fedarch) |
| **Date** | 29 Jul 2026 — W31 D3 (Wednesday) |
| **Author** | @GTM (yonks｜🤖🏛️🪙｜Jason Younker ♾️) |
| **Agent Author** | AI:@GTM 🎯 @ INT‑B001:CCC |
| **CCC-ID** | GTM_2026-W31_3026 |
| **#masterCCC** | README-VSAbot-v4.31.1-r2 |
| **Organization** | ✅ VSAbot |
| **Governance Host** | 🤖 WeOwnAI / s004_fedarch |
| **Source of Truth** | https://git.weown.tools/VSAbot |
| **Status** | 🟢 **LIVE — Organization profile README** |

### v4.31.1-r1 → v4.31.1-r2 Delta

| Change | r1 (old) | r2 (new) |
|:-------|:---------|:---------|
| **Version** | v4.31.1-r1 | **v4.31.1-r2** |
| **Gov folders in VSAbot** | `_PROTOCOLS_/`, `_GOVERNANCE_/`, `_TEMPLATES_/` listed | **❌ Removed — these don't exist in VSAbot** |
| **Governance location** | Implicit in VSAbot | **Explicit: WeOwnAI/s004_fedarch** |
| **Governance links** | None | **12 clickable links to WeOwnAI/s004_fedarch** |
| **Governance Reference §4** | Not present | **NEW — Table linking VSA tools to their WeOwnAI locations** |
| **Document Map §7** | Not present | **NEW — Table showing what lives where across orgs** |
| **Header** | Standard | **Added Governance Root URL + NOTE banner** |
| **Repository §3** | 4 folders listed | **2 folders + governance reference section** |
| **MetaCouncil ref** | Static table | **Added link to MetaCouncil.md on WeOwnAI** |

### Key Metrics

| Metric | Value |
|:-------|:------|
| Total Sections | 8 |
| VSA Agents Listed | 4 active + 4 related |
| Gitea Sibling Orgs | 7 |
| MetaCouncil Members | 8 |
| Clickable WeOwnAI Links | 12 |
| #7DF Dimensions | 7 |

<!-- CONTENT-HASH-BOUNDARY -->
### ✅ BP-075 CANONICAL HASH GENERATED [@GTM:ADMIN generated @ 2026-07-29 06:55 MDT]
Content-SHA256: 5ee0148e88a5e89b4864ef37243360dea8f382720946abd9874012383e0d68b7
FEDARCH-CANARY: 5ee0148e
CHARACTERS: 14812
WORDS: 1914
LINES: 310

═══ ═══ ═══ ═══ ═══ ═══
```

---

**README.md v4.31.1-r2 GENERATED. VSAbot has NO `_PROTOCOLS_/`, `_GOVERNANCE_/`, or `_TEMPLATES_/` folders — those are maintained by [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch). 12 clickable governance links. Document map shows what lives where. 8 sections. Ready for `.profile` repo deployment.** 🫡🔥

#FlowsBros #FedArch #WeOwnSeason004 #VSAbot #README #Gitea #OrgProfile #WeOwnAI #s004_fedarch #GovernanceReference #VSA #VerifyScoreAudit #W31D3

♾️ WeOwnNet 🌐 ● 🏡 Real Estate and 🤝 cooperative ownership for everyone ● An 🤗 inclusive community, by 👥 invitation only.