SCHEMA.md

Wiki Schema

Domain

AI in Education — research, products, policies, and pedagogical debates around the use of artificial intelligence (including LLMs, adaptive systems, tutoring agents, and analytics) in learning environments from K-12 to higher education and lifelong learning.

Conventions

• File names: lowercase, hyphens, no spaces (e.g., adaptive-learning-systems.md)
• Every wiki page starts with YAML frontmatter (see below)
• Use wikilinks to link between pages ([[page-slug]] or [[page-slug|display text]])
• Inline hyperlink rule (wiki-style, HARD GATE): hyperlink every concept mentioned by name in the BODY of a concept or article page to that concept's page, in addition to the Connected Concepts/Articles lists. Use piped links when display text differs from the slug (e.g. [[cognitive-offloading|doing the cognitive work]]), the most specific slug matching the mention's meaning, and the dedicated umbrella page for generic terms (e.g. [[feedback]], not [[feedback-loop]], for plain "feedback"). This pass is a BLOCKING PREREQUISITE before npm run build / commit / push / deploy on every newly created or enriched page — a green build does NOT substitute for it. Load the wiki-inline-links skill and run the pass + verification (0 self-links, 0 heading links, balanced brackets, 0 broken links) on every new page first.
• When updating a page, always bump the updated date+time (see Frontmatter above)
• Every new page must be added to index.md under the correct section
• Every action must be appended to log.md (local-only, gitignored like raw/ — not committed; persists on the local repo for scan-complete anchors)
• Two page types: articles/<slug>.md for individual papers, concepts/<slug>.md for broad topics that synthesize multiple papers. An article belongs on a concept page's Connected Articles list; a concept page explains the concept itself, not any single paper.
• Provenance markers: On pages that synthesize 3+ sources, append ^[raw/papers/source-file.md] at the end of paragraphs whose claims come from a specific source. This lets a reader trace each claim back without re-reading the whole raw file. Optional on single-source pages where the sources: frontmatter is enough.

Frontmatter

Only these fields are validated by the live schema (src/content.config.ts). Extra fields in frontmatter are ignored at build time, so keep to this list.

---
title: Page Title
created: "YYYY-MM-DDTHH:MM:SS±HH:MM"
updated: "YYYY-MM-DDTHH:MM:SS±HH:MM"
type: article | concept
tags: [from taxonomy below]
sources: [raw/papers/source-name.md]   # articles only
confidence: high | medium | low        # how well-supported the claims are
---

created / updated MUST store full quoted date+time timestamps (e.g. "2026-08-16T20:47:13-04:00"), never bare dates. Reasons:

• The right sidebar ("Recently Added Articles" / "Recently Updated Concepts") and RSS sort by these fields via string comparison — date-only values tie within a day and fall back to alphabetical order. Full timestamps give correct reverse-chronological ordering.
• YAML parses an unquoted ISO timestamp into a JS Date in UTC, shifting an Eastern-evening value to the next calendar day. Always quote the value so the schema preserves the original string.
• created should be the wiki ingestion date (with time), NOT the paper's publication date — Recent Articles and the journal sort by it.
• When you make a significant body edit to a page (not just frontmatter or Connected Articles/Concepts lists), bump updated to the current date+time and rebuild so the sidebar refreshes.

Pages display date-only everywhere (article/concept page headers, sidebar) via .split('T')[0]; the time is stored internally for sorting only.

confidence is optional (defaults to medium) but recommended for opinion-heavy or fast-moving topics. A confidence: low page signals weak or partial support so weak claims don't silently harden into accepted wiki fact. There is no contested or contradictions field — the schema does not validate them, so do not add them to frontmatter. Record unresolved disagreements in the page body instead (see Update Policy below).

Article page body structure

> **Synthesis:** 2-4 sentence summary of what the paper does and finds

## Key Findings
- 3-5 distinct bullet points with the most important results

## Connected Concepts
- [[concept-slug]]  (3-6 genuinely related concepts)

## Connected Articles
- [[article-slug]]  (2-4 genuinely related articles)

## Citation
Author, A. (2026). [*Full Title*](https://doi.org/...). Journal.

Exactly one ## Citation per article, as a single APA-style line (hyperlinked full title, first 6 authors + ", et al." for longer lists, source suffix per the wiki's citation rules).

Concept page body structure

> **Synthesis:** definition + overview of the concept

## Key research themes
Theme descriptions with [[wikilinks]] to related articles

## Connected Concepts
- [[concept-slug]]

## Connected Articles
- [[article-slug]]

(No citation section — concepts synthesize multiple sources.)

raw/ Frontmatter

Raw sources ALSO get a small frontmatter block so re-ingests can detect drift:

---
source_url: https://example.com/article   # original URL, if applicable
ingested: YYYY-MM-DD                       # or ingested_date
sha256: <hex digest of the raw content below the frontmatter>
---

raw/ is gitignored and never committed. Raw files may also carry an authors: list (used as the source of truth when a page's citation authors need verification). The sha256: lets a future re-ingest of the same URL skip processing when content is unchanged, and flag drift when it has changed. Compute over the body only (everything after the closing ---), not the frontmatter itself.

Tag Taxonomy

Canonical tag list (reconciled 2026-08-03: 23 near-duplicate tags consolidated; taxonomy now indexes all 122 tags in use).

Systems & Technology

• llm, generative-ai, adaptive-learning, intelligent-tutoring, edtech-platform, learning-analytics, automated-grading, ai-detection, agentic-ai, multi-agent
• reinforcement-learning, multimodal, prompt-engineering, knowledge-tracing, student-modeling, nlp-education, programming-its, architecture, interpretability, ai-generated-content, content-quality, dot-framework, validate-then-generate, verification

Pedagogy & Practice

• personalized-learning, formative-assessment, feedback-loop, scaffolding, active-learning, blended-learning, mastery-learning, educational-theory
• pedagogy, instructional-design, curriculum-design, assessment, authentic-assessment, portfolio-assessment, socratic-method, project-based-learning, problem-based-learning, collaborative-learning, collaborative-ai-tutoring, design-thinking, training-methodology, simulation, oral-defense, pair-programming

Learning & Cognition

• metacognition, self-regulated-learning, self-directed-learning, cognitive-offloading, critical-thinking, creative-thinking, computational-thinking, skill-decay, confidence, student-ai-interaction

Stakeholders

• k-12, higher-ed, lifelong-learning, teacher-role, student-experience, administrator, policy-maker
• faculty-development, public-sector, practitioner-beliefs, educator-guide

Domain Areas

• stem-education, language-learning, writing-education, special-education, professional-training
• ai-education, cs-education, math-education, physics-education, health-education, mooc, multilingual-learning, neurodiversity, inclusive-learning, informal-learning, independent-learning, software-engineering, business-education, economics-education, management-education

Research & Evaluation

• rct, efficacy-study, benchmark, learning-gains, engagement-metrics, dropout-reduction, scoping-review, systematic-review
• ai-ed-evaluation, assessment-validity, literature-review, meta-analysis, survey, qualitative-research, research-methods, evidence, ground-truth-reliability-aied

Ethics & Policy

• academic-integrity, bias-mitigation, privacy, equity, regulation, plagiarism-detection, hallucination-risk, over-reliance, remote-proctoring, automated-proctoring
• ethics, pedagogical-safety, misinformation, global-south, culturally-sustaining-pedagogy, institutional-change

Affective & Social

• affective-computing, ai-literacy, human-in-the-loop, boundary-object, posthumanist, trust-calibration

Meta

• comparison, timeline, controversy, prediction, market-analysis, open-source, stub

Rule: every tag on a page must appear in this taxonomy. If a new tag is needed, add it here first, then use it. This prevents tag sprawl.

Page Thresholds

• Create a page when an entity/concept appears in 2+ sources OR is central to one source
• Add to existing page when a source mentions something already covered
• DON'T create a page for passing mentions, minor details, or things outside the domain
• Split a page when it exceeds ~200 lines — break into sub-topics with cross-links
• Archive a page when its content is fully superseded — remove it from index.md and the live site

Concept Pages

One page per concept or topic. Include:

• Definition / explanation
• Current state of knowledge
• Open questions or debates
• Related concepts (wikilinks)

Ingestion enrichment rule: when a new article makes a significant contribution to a connected concept (a novel framing, distinctive finding, or a dimension the concept page lacks), integrate that insight into the concept page's body narrative — a research bullet, subsection, or synthesis paragraph — not merely add it to the Connected Articles list. Evaluate each article's substantive contribution and incorporate it where the concept is missing that dimension. When such a significant edit is made, bump the concept's updated timestamp and rebuild so the right sidebar reflects it.

Update Policy

When new information conflicts with existing content:

1. Check the dates — newer sources generally supersede older ones
2. If genuinely contradictory, note both positions with dates and sources in the page body
3. If the contradiction is significant, lower the page's confidence to medium or low
4. Flag for user review in the lint report

Journal (journal.md)

• Reverse chronological index of all ingested articles/papers.
• Automatically regenerated: sorted by created date in article frontmatter, newest first.
• Shows: confidence icon (●/◐/○), wikilink to article page, source reference, full title, and tags.
• Excludes low-confidence stubs with no sources.
• Regenerate after every ingestion batch to keep current.