1- # ⚠️ STOP - CRITICAL READING REQUIRED
2-
3- ** THIS FILE MUST BE READ FIRST BY ALL AI AGENTS**
1+ # SPDX-License-Identifier: PMPL-1.0-or-later
2+ # 0-AI-MANIFEST.a2ml — verisimdb-data
3+ # THIS FILE MUST BE READ FIRST BY ALL AI AGENTS
44
55## WHAT IS THIS?
66
7- This is the AI manifest for **[YOUR-REPO-NAME] **. It declares:
7+ This is the AI manifest for **verisimdb-data **. It declares:
88- Canonical file locations (where things MUST be, and nowhere else)
99- Critical invariants (rules that must NEVER be violated)
1010- Repository structure and organization
1111
12+ verisimdb-data is the git-backed flat-file data store for VeriSimDB.
13+ It stores panic-attack scan results, dispatch manifests, drift snapshots,
14+ and training data for the Hypatia neurosymbolic pipeline. It lives as a
15+ subdirectory within the verisimdb project inside the nextgen-databases monorepo.
16+
1217## CANONICAL LOCATIONS (UNIVERSAL RULE)
1318
1419### Machine-Readable Metadata: `.machine_readable/` ONLY
1520
16- These 6 SCM files MUST exist in `.machine_readable/` directory ONLY:
21+ These SCM files MUST exist in `.machine_readable/` directory ONLY:
17221. **STATE.scm** - Project state, progress, blockers
18232. **META.scm** - Architecture decisions, governance
19243. **ECOSYSTEM.scm** - Position in ecosystem, relationships
20- 4. **AGENTIC.scm** - AI agent interaction patterns
21- 5. **NEUROSYM.scm** - Neurosymbolic integration config
22- 6. **PLAYBOOK.scm** - Operational runbook
2325
2426**CRITICAL:** If ANY of these files exist in the root directory, this is an ERROR.
2527
2628### Bot Directives: `.bot_directives/` ONLY
2729
28- Bot-specific instructions for:
29- - rhodibot - Git operations
30- - echidnabot - Code quality
31- - sustainabot - Dependency updates
32- - glambot - Documentation
33- - seambot - Integration
34- - finishbot - Task completion
30+ Bot-specific instructions for the gitbot-fleet (rhodibot, echidnabot, etc.)
3531
3632### Agent Instructions
3733
@@ -45,72 +41,42 @@ Bot-specific instructions for:
45413. **No stale metadata** - If root SCMs exist, they are OUT OF DATE
46424. **License consistency** - All code PMPL-1.0-or-later unless platform requires MPL-2.0
47435. **Author attribution** - Always "Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>"
44+ 6. **Data integrity** - Scan results and dispatch manifests must not be modified post-ingestion
45+ 7. **No .git in subdirectory** - This is part of the nextgen-databases monorepo
4846
4947## REPOSITORY STRUCTURE
5048
51- <!-- CUSTOMIZE THIS SECTION FOR YOUR REPO -->
52-
53- This repo contains:
54-
5549```
56- [YOUR-REPO-NAME] /
50+ verisimdb-data /
5751├── 0-AI-MANIFEST.a2ml # THIS FILE (start here)
58- ├── README.md # Project overview
59- ├── [your source files] # Main code
60- ├── .machine_readable/ # SCM files (6 files)
52+ ├── README.adoc # Project overview
53+ ├── index.json # Master index of all octads
54+ ├── scans/ # panic-attack scan results per repo
55+ ├── dispatch/ # Hypatia dispatch manifests (JSONL)
56+ ├── patterns/ # Cross-repo pattern data
57+ ├── recipes/ # Remediation recipes
58+ ├── outcomes/ # Dispatch outcome tracking
59+ ├── health/ # Pipeline health snapshots
60+ ├── drift/ # Drift detection snapshots
61+ ├── hardware/ # hardware-crash-team findings
62+ ├── .machine_readable/ # SCM files
6163│ ├── STATE.scm
6264│ ├── META.scm
63- │ ├── ECOSYSTEM.scm
64- │ ├── AGENTIC.scm
65- │ ├── NEUROSYM.scm
66- │ └── PLAYBOOK.scm
67- └── .bot_directives/ # Bot instructions
65+ │ └── ECOSYSTEM.scm
66+ └── .bot_directives/ # Bot instructions
6867```
6968
7069## SESSION STARTUP CHECKLIST
7170
72- ✅ Read THIS file (0-AI-MANIFEST.a2ml) first
73- ✅ Understand canonical locations (.machine_readable/, .bot_directives/)
74- ✅ Know the invariants (no SCM duplication, etc.)
75- ✅ Check for MCP enforcement (if applicable)
76- ✅ Read `.machine_readable/STATE.scm` for current status
77- ✅ Read `.machine_readable/AGENTIC.scm` for interaction patterns
78-
79- ## LIFECYCLE HOOKS
80-
81- ### on-enter (Session Start)
82-
83- When starting a new session:
84-
85- 1. Read and acknowledge this manifest
86- 2. Log session start (optional but recommended)
87- - Format: `[YYYY-MM-DD HH:MM:SS] Session started: [agent-name]`
88- - Location: `.machine_readable/session-log.txt`
89- 3. Read `.machine_readable/STATE.scm`
90- 4. Check for blockers
91- 5. State understanding of canonical locations
92-
93- ### on-exit (Session End)
94-
95- When ending a session:
96-
97- 1. Update `.machine_readable/STATE.scm` if changes made
98- 2. Log session end (optional but recommended)
99- - Format: `[YYYY-MM-DD HH:MM:SS] Session ended: [summary]`
100- - Location: `.machine_readable/session-log.txt`
101- 3. Document new blockers
102- 4. Summarize outcomes
103-
104- ## ATTESTATION PROOF
105-
106- After reading this file, demonstrate understanding by stating:
107-
108- **"I have read the AI manifest. SCM files are located in `.machine_readable/` ONLY, bot directives in `.bot_directives/`, and I will not create duplicate files in the root directory."**
71+ 1. Read THIS file (0-AI-MANIFEST.a2ml) first
72+ 2. Understand canonical locations (.machine_readable/, .bot_directives/)
73+ 3. Know the invariants (no SCM duplication, data integrity, etc.)
74+ 4. Read `.machine_readable/STATE.scm` for current status
10975
11076## META
11177
11278- **Format Version:** 1.0.0
113- - **Created:** [DATE]
114- - **Maintained By:** [YOUR-NAME/ORG]
79+ - **Created:** 2026-03-16
80+ - **Maintained By:** Jonathan D.A. Jewell (hyperpolymath)
11581- **License:** PMPL-1.0-or-later
11682- **Protocol:** https://github.com/hyperpolymath/0-ai-gatekeeper-protocol
0 commit comments