Vault Graph Schema

Every entry in this vault MUST conform to this schema. If a resource genuinely requires a term not listed here, do not invent vocabulary silently — flag it in _gaps.md under schema_exceptions.

Node Types

Permitted values for the type: field:

Type	Meaning
`Hardware`	Physical systems, kits, devices, controllers
`Software`	Code, firmware, apps, monitoring stacks
`Curriculum`	Courses, textbooks, lesson plans, teaching guides
`Policy`	Laws, government plans, official directives
`Framework`	Standards, competency frameworks, design frameworks
`Program`	Organized initiatives, trainings, outreach projects
`Organization`	Institutions, NGOs, companies, labs
`Dataset`	Data resources, monitoring datasets
`Component`	Printable/fabricable parts (net cups, fittings, mounts)
`Principle`	Guiding principle notes (first-class notes, in `/principles`)
`MOC`	Maps of Content hub notes (in `/mocs`)
`Person`	Individual contributors, authors, researchers

Edge Types

Permitted relationship fields (all values are arrays of wikilinks [[Title]]):

Edge	Meaning	Inverse
`embodies`	Entry instantiates this principle	listed in principle note backlinks
`builds_on`	Entry extends/depends on this resource	`prerequisite_for`
`prerequisite_for`	Entry is required groundwork for these	`builds_on`
`contrasts_with`	Meaningful alternative/trade-off	(self-inverse)
`located_in`	Geography (entry → region concept or entry)	—
`aligned_with`	Conforms to this policy/framework	—
`authored_by`	Entry → Person/Organization	—
`part_of`	Entry is a component of a larger whole	—
`mocs`	MOCs that index this entry	MOC body lists entry

Required Frontmatter Fields (entries)

slug            # lowercase, hyphenated, ASCII; equals filename
title
type            # node type enum
primary_source  # direct URL to resource itself, not news coverage
source_type     # free list, e.g. [GitHub Repository, Training Manual, Program Website]
last_verified   # YYYY-MM-DD
status          # Active | Dormant | Archived
archive_url     # Wayback Machine URL when available, else null
language        # ISO 639-1 codes
translation_available  # true | false
region          # region enum
audience        # audience enum
cost            # Free | Low | Medium | High
skill_level     # Beginner | Intermediate | Advanced
space           # space enum (may be empty for software/policy)
climate         # climate enum (may be empty where irrelevant)
maintenance     # Low | Moderate | High
learning_outcomes  # outcomes enum
embodies        # [[principle]] wikilinks, min 1
builds_on
prerequisite_for
contrasts_with
prerequisites   # free wikilinks to foundational notes
mocs            # [[MOC]] wikilinks, min 1
summary_short   # one sentence

Undeterminable fields use unknown and are logged in _gaps.md.

Controlled Vocabularies

Field	Permitted Values
`region`	China, South Africa, USA, Guam, EU, Oceania, Southeast Asia, Latin America, Africa, Indigenous, Global
`audience`	K-12, Secondary, University, Vocational, Community, Household, Adult Learners, Educators, Researchers
`cost`	Free, Low, Medium, High
`skill_level`	Beginner, Intermediate, Advanced
`space`	Indoor, Outdoor, Backyard, Classroom, Rooftop, Greenhouse, Public Space
`climate`	Tropical, Temperate, Arid, Cold, Versatile
`maintenance`	Low, Moderate, High
`status`	Active, Dormant, Archived
`learning_outcomes`	Systems Thinking, Coding, CAD, 3D Printing, Water Chemistry, Biology, Electronics, Project Management, Entrepreneurship, Food Production, Community Organizing, Data Literacy, Sustainability Literacy
`language`	ISO 639-1 codes (en, zh, es, pt, de, fr, etc.)

One Other: <term> escape hatch is permitted per field, but prefer a controlled term whenever one fits.

Required Note Body Sections (entries, exact order)

## Summary — 100–250 words
## Guiding Principles
## Learning Outcomes & Transferable Skills
## How to Replicate or Build On It
## Considerations & Constraints (Cost / Skill Level / Space-Climate / Tools Required / Ongoing Maintenance / Access Barriers)
## Prerequisites
## Primary Source

Required Principle Notes (minimum set)

Food Sovereignty · Community Self-Sufficiency · Modularity · Circular Economy · STEM Integration · Open Source · Transferable Skills · Youth Empowerment · Rural Revitalization · Decolonizing Education

Required MOCs

Start Here · Build It Yourself · Classroom-Ready · Food Sovereignty & Community · Policy & Frameworks · Principles Index · By Region · Contribute Here

Directory Layout

/vault
  _schema.md
  _gaps.md
  /entries      # one .md per resource
  /principles   # one .md per principle
  /mocs         # one .md per Map of Content