From e68ab96ceb42bf3db0c064ce853b3ad4e84ffd14 Mon Sep 17 00:00:00 2001
From: CoderDeltaLAN <CoderDeltaLAN@users.noreply.github.com>
Date: Sat, 20 Jun 2026 01:42:11 +0100
Subject: [PATCH] docs: sync readme repository layout

---
 CHANGELOG.md |  1 +
 README.md    | 34 +++++++++++++++++++++++++++++-----
 2 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5f24f1a..038d3de 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,7 @@ This project has a published GitHub Release line, but no stable support or API g
 
 ### Changed
 
+- Synced the README repository layout with the current workflows, evidence documents, scripts, package modules, and test files.
 - Synced README wording with current main truth for post-v0.3.0 `dedupe` and `conflicts`, published v0.3.0/PyPI boundaries, and functional evidence traceability.
 - Hardened the local post-release audit script to verify package metadata, version parity, source CLI smoke behavior, workflow action inventory, workflow trigger and permission posture, PyPI Trusted Publishing boundaries, Dependabot configuration, forbidden local artifacts, and public-claim guardrails.
 - Expanded CI, wheel, and post-release audit smoke coverage for the current `dedupe` and `conflicts` command contract.
diff --git a/README.md b/README.md
index 9cfb0c9..f9548d9 100644
--- a/README.md
+++ b/README.md
@@ -443,28 +443,39 @@ See:
     .
     ├── .github/
     │   ├── ISSUE_TEMPLATE/
+    │   │   ├── bug_report.yml
+    │   │   └── feature_request.yml
+    │   ├── dependabot.yml
     │   ├── pull_request_template.md
     │   └── workflows/
     │       ├── ci.yml
+    │       ├── codeql.yml
     │       └── publish-pypi.yml
     ├── docs/
     │   ├── BUILD-PLAN.md
+    │   ├── DEPENDABOT-DEPENDENCY-GRAPH.md
     │   ├── EXIT-CODES.md
+    │   ├── OPENSSF-SCORECARD-EVALUATION.md
     │   ├── OUTPUTS.md
+    │   ├── POST-V0.3.0-FUNCTIONAL-CONTRACT-EVIDENCE.md
+    │   ├── PRIVATE-VULNERABILITY-REPORTING.md
     │   ├── PRODUCT-STRATEGY.md
     │   ├── RULES.md
+    │   ├── SECURITY-SUPPLY-CHAIN-EVALUATION.md
     │   ├── THREAT-MODEL.md
+    │   ├── V0.2.0-RELEASE-NOTES.md
+    │   ├── V0.2-GOVERNANCE-BOUNDARIES.md
     │   ├── V0.2-GOVERNANCE-RULES-SPEC.md
+    │   ├── V0.2-PACKAGING-DRY-RUN.md
+    │   ├── V0.2-RELEASE-READINESS.md
     │   ├── V0.3-ARCHITECTURE-ROADMAP.md
+    │   ├── V0.3.0-POST-RELEASE-AUDIT.md
     │   ├── V0.3.0-RELEASE-NOTES.md
     │   └── screenshots/
     │       └── readme/
-    │           ├── agent-rules-kit-governance-findings.png
-    │           ├── agent-rules-kit-help-check.png
-    │           ├── agent-rules-kit-init-safety.png
-    │           └── agent-rules-kit-output-formats.png
     ├── scripts/
-    │   └── check.sh
+    │   ├── check.sh
+    │   └── post-release-audit.sh
     ├── src/
     │   └── agent_rules_kit/
     │       ├── __init__.py
@@ -480,6 +491,19 @@ See:
     │       ├── init_write.py
     │       └── redaction.py
     ├── tests/
+    │   ├── test_cli.py
+    │   ├── test_conflicts.py
+    │   ├── test_dedupe.py
+    │   ├── test_diagnostic_fixtures.py
+    │   ├── test_discovery.py
+    │   ├── test_findings.py
+    │   ├── test_golden_outputs.py
+    │   ├── test_governance.py
+    │   ├── test_init_plan.py
+    │   ├── test_init_write.py
+    │   ├── test_path_boundaries.py
+    │   └── test_redaction.py
+    ├── .gitignore
     ├── AGENTS.md
     ├── CHANGELOG.md
     ├── CONTRIBUTING.md