LISA Vault Governance
Vault-specific operating rules governing file creation, classification, placement, and reporting within the Sage Library. These rules are binding for all file operations.
Operational Rules
Rule 1 — FCF Compliance Is Non-Negotiable
Every file created must conform to the FCF's segment grammar, casing rules, and placement logic. Before creating any file:
- Determine the correct file type using the FCF decision tree
- Read the relevant TypeSpec for that type
- Construct the filename using the segment grammar
- Determine the correct folder path
- Confirm the YAML frontmatter schema from the TypeSpec
- Only then write the file
Rule 2 — All Outputs Go Into the Vault
Never leave outputs in the terminal, clipboard, or session memory. Every piece of generated content must be written as a vault file at an FCF-compliant path. If the operator asks for "a quick summary," write it as a note (Intel type or appropriate alternative) — not as a chat response that vanishes.
Exception: Direct answers to questions, status confirmations, and conversational responses remain in-session. The rule applies to generated content — notes, documents, code, data, specifications, and analyses.
Rule 3 — Non-Markdown Artefacts Go to artefacts/
Non-markdown files (images, code archives, data exports, scripts, configs, builds, PDFs) must NEVER be placed in mission folders. Always place them in the appropriate artefacts/{type}/{project-subfolder}/ path:
| Output Type | Target Path |
|---|---|
| Images (PNG, JPG, SVG, WebP) | artefacts/media/{project-subfolder}/ |
| PDFs | artefacts/pdfs/{project-subfolder}/ |
| Source code archives (ZIP, TAR.GZ) | artefacts/code/{project-subfolder}/ |
| Data exports (JSON, CSV, TSV, XML) | artefacts/data/{project-subfolder}/ |
| Scripts (SH, PY, standalone JS) | artefacts/scripts/{project-subfolder}/ |
| Configuration outputs | artefacts/configs/{project-subfolder}/ |
| Compiled / bundled outputs | artefacts/builds/{project-subfolder}/ |
Project subfolders use the mission's lowercase-hyphenated name (e.g., ClientA/, ClientA/, east-coast-hydrogen/). Use general/ for unscoped artefacts. Create subfolders on first use — do not pre-create empty ones.
Rule 4 — ArtefactMap Maintenance
Every non-markdown artefact produced must have a corresponding entry in the relevant ArtefactMap note. After placing any artefact:
- Check if an ArtefactMap exists in the parent mission/subject folder
- If not, create one using the ArtefactMap template
- If yes, read it and append the new entry under the correct type section
- Update the
last_updatedfield in the ArtefactMap body metadata to the current ISO 8601 timestamp - On artefact deletion/move, update or remove the corresponding entry
Rule 5 — Complete YAML Frontmatter
Every new markdown note must include complete YAML frontmatter conforming to the relevant TypeSpec. No exceptions. Missing frontmatter fields are a classification failure.
Rule 6 — No Files Outside Vault Root
Never create files outside the vault root directory unless explicitly instructed by the operator. The vault boundary is absolute.
Rule 7 — Report All File Operations
After completing any task that creates, modifies, or deletes files, provide a summary listing:
- Full path of each file created (marked
[NEW]) - Full path of each file modified (marked
[MODIFIED]) - Full path of each file deleted (marked
[DELETED]) - Any ArtefactMap entries added or updated
Rule 8 — CS.YB SubBrand Slot Compliance
When constructing a CS.YB filename, evaluate whether the {EndClient} represents a parent organisation with multiple commercial sub-brands AND whether the deliverable targets a specific sub-brand. If both hold, the {SubBrand} slot is mandatory in the filename and the sub_brand: field is mandatory in YAML frontmatter. The two must agree exactly. If either condition fails, the slot is omitted and the file follows the previous-form CS.YB grammar. Compound mission values that bake sub-brand identity (e.g. ClientAWebsite, ClientA-SubBrand) are not permitted for new files.
Per the 2026-05-08 dispatch-namespace resolution: when SubBrand is occupied, the dispatch namespace also carries the sub-brand (e.g. CS.YB.ClientA.ClientA.ClientA for ClientA Website work, NOT the parent CS.YB.ClientA.ClientA). Mission Matrix entries are added per sub-brand.
See FCF: CS.YB Grammar for the full slot specification, the parent-group worked examples (GroupCo, HoldCo), and the Mission elision sub-rule. See FCF SubBrand Slot Revision Proposal for the convention rationale, frontmatter validation rules, and forward-binding policy for legacy files.
Nin Prompt Execution Protocol
When the operator invokes a CMD.* prompt file:
- Read the prompt file to extract the instruction template
- Read all context files referenced by the operator
- Execute the prompt logic
- Classify all outputs via FCF before writing
- Write markdown outputs to correct mission/subject folders
- Write non-markdown outputs to correct
artefacts/{type}/{project-subfolder}/paths - Create or update ArtefactMap if non-markdown outputs were produced
- Report all files created or modified
Vault Structure Reference
Top-level folders and their purposes:
| Folder | Purpose |
|---|---|
artefacts/ | All non-markdown binary assets (images, PDFs, code, data, scripts, configs, builds) — each with mission-specific project subfolders |
bases/ | Obsidian Base files (do not modify) |
bjj/ | Brazilian Jiu-Jitsu technique notes |
cipher_shinobi/ | Organisation mission and operational notes |
cipher_shinobi/akatsuki/ | Internal operations (csdao, lisa, ClientA, the_system) |
cipher_shinobi/yurei_butai/ | Client missions (ClientA, client-b, client-c) |
definitions/ | Definition-type notes |
entities/ | Entity profiles (individuals and organisations) |
fleeting/ | Fleeting notes (temporary capture, to be processed) |
ideas/ | Idea-type notes (Sparks and Critiques) |
inputs/ | Input-type notes (articles, books, videos) |
personal/ | Personal development and expertise notes |
prompts/ | Prompt files and Copilot command definitions |
templates/ | Structural and executable templates |
temporal/ | Time-indexed notes (daily, weekly, monthly, yearly) |
Classification Matrix Consultation Protocol
- Extract key terms from note content: entities, activities, mission identifiers.
- Select matrix:
- PER domain →
PER.EX.SAG_SYSX.Data.ActivityClassMatrix.Tobi - CS domain →
CS.AK.CSDAO.Data.MissionMatrix - For namespace construction rules and lifecycle state definitions, consult Mission Taxonomy — it defines the mission entity model, graduated infrastructure requirements by class, and dispatch namespace resolution rules that inform classification decisions.
- PER domain →
- Locate matching row and extract canonical values:
- PER:
pillar,topic,subject - CS.YB:
client,end_client,mission— use Mission Shorthand for filename; full mission name for YAMLmissionfield - CS.AK:
mission
- PER:
- Apply to YAML using expanded values (e.g., "Sagyōjutsu", not "SAG").
- Matrix gap? Classify by best judgement. Flag in YAML:
note: Pending [Matrix Name] formalisation - [gap description].