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 |