From b3d02d0c145dddd6f2e5a05ac9250b3ff780168c Mon Sep 17 00:00:00 2001
From: Charles N Wyble <charles@ultix.knel.net>
Date: Tue, 17 Feb 2026 10:12:20 -0500
Subject: [PATCH] docs: update README.md and AGENTS.md for new files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update documentation to reflect new project structure
and files created for test coverage enhancement.

README.md:
- Add STATUS.md link to documentation table
- Add JOURNAL.md link to documentation table
- STATUS.md: Manager-facing status report
- JOURNAL.md: AI agent memory and ADRs

AGENTS.md:
- Document STATUS.md purpose and maintenance
- Document JOURNAL.md purpose (AI memory, ADRs)
- Add tests/system/ directory to project structure
- Clean up obsolete file references
- Update documentation structure section

These changes ensure all team members (human and AI)
understand the purpose and location of key files.

💘 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
---
 AGENTS.md | 38 +++++++++++++++++++++++++++++++-------
 README.md |  2 ++
 2 files changed, 33 insertions(+), 7 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 6ee4c47..8456b40 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -132,16 +132,36 @@
 ├── PRD.md                 # Product Requirements Document
 ├── README.md              # Project documentation
 ├── AGENTS.md              # THIS FILE - Agent guidelines
-├── RESUME.md              # Session resumption guide
-├── JOURNAL.md             # Append-only development journal
-├── BUILD-COMPLETE.md      # Build completion report
-├── BUILD-SUMMARY.md       # Build session summary
-├── VERIFICATION-REPORT.md # Comprehensive verification report
-├── QUICK_START.md         # Quick reference commands
-├── SESSION-CLOSED.md      # Session closure documentation
+├── STATUS.md              # Manager status report (quick-glance)
+├── JOURNAL.md             # AI memory - ADRs, insights, lessons (append-only)
 └── .gitignore             # Git ignore patterns
 ```
 
+### Documentation Files
+```
+├── STATUS.md              # Manager report - current status, blockers, next actions
+├── JOURNAL.md             # AI memory - ADRs, patterns, lessons learned
+├── PRD.md                 # Product requirements
+├── AGENTS.md              # Agent guidelines (START HERE)
+└── docs/                  # Detailed documentation
+    ├── TEST-COVERAGE.md   # Test suite coverage
+    ├── VERIFICATION-REPORT.md  # Compliance verification
+    ├── COMPLIANCE.md      # Compliance standards
+    └── security-model.md  # Security architecture
+```
+
+**STATUS.md Purpose**:
+- Quick-glance project status for managers
+- What's working, what's broken, current blockers
+- Next actions and metrics
+- Maintained by AI agent, read by humans
+
+**JOURNAL.md Purpose**:
+- Long-term memory for AI agents
+- Architectural Decision Records (ADRs)
+- Patterns observed, lessons learned
+- APPEND-ONLY - never modify existing entries
+
 ### Source Code
 ```
 src/
@@ -185,6 +205,10 @@ tests/
 │   └── config_test.bats
 ├── security/             # Security compliance tests
 │   └── compliance_test.bats
+├── system/               # System/runtime tests (VM boot, FDE, Secure Boot)
+│   ├── boot_test.bats
+│   ├── secureboot_test.bats
+│   └── fde_test.bats
 ├── test_helper/          # Test utilities
 │   └── common.bash
 └── simple_test.bats      # Basic bats test
diff --git a/README.md b/README.md
index 59f5651..169be62 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,8 @@
 ### 📋 Documentation Files
 | File | Purpose |
 |------|---------|
+| **STATUS.md** | 📊 Project status report (manager quick-glance) |
+| **JOURNAL.md** | 📝 AI memory, ADRs, lessons learned (append-only) |
 | **AGENTS.md** | ⚡ START HERE - Current status + requirements |
 | **PRD.md** | Complete product requirements |
 | **docs/TEST-COVERAGE.md** | Test suite details and coverage |