Skip to content

Commit fbc1907

Browse files
hyperpolymathclaude
andcommitted
fix: replace template placeholders in verisimdb-data SECURITY.md and 0-AI-MANIFEST.a2ml
SECURITY.md was still the full RSR template referencing nextgen-databases instead of verisimdb-data. Replaced with a clean, concise security policy. 0-AI-MANIFEST.a2ml had [YOUR-REPO-NAME] placeholders unfilled. Replaced with verisimdb-data specific content describing its role as the git-backed flat-file data store for VeriSimDB. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 1ffd670 commit fbc1907

File tree

2 files changed

+43
-464
lines changed

2 files changed

+43
-464
lines changed
Lines changed: 33 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,33 @@
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:
1722
1. **STATE.scm** - Project state, progress, blockers
1823
2. **META.scm** - Architecture decisions, governance
1924
3. **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:
4541
3. **No stale metadata** - If root SCMs exist, they are OUT OF DATE
4642
4. **License consistency** - All code PMPL-1.0-or-later unless platform requires MPL-2.0
4743
5. **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

Comments
 (0)