diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..ed16576
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,15 @@
+## What does this change?
+
+<!-- Briefly describe the change and which layer it touches: research, framework, or prototype. -->
+
+## Why?
+
+<!-- Link the related issue, if any. -->
+
+## Checklist
+
+- [ ] Contains **no real student data** — synthetic or de-identified examples only
+- [ ] Follows the trust-first safety boundary (human validation stays final, no financial/token speculation)
+- [ ] Markdown/JSON changes pass the repo's automated checks
+- [ ] Folder-level README updated if this adds/renames files in a documented folder
+- [ ] ROADMAP.md updated if this completes or changes a roadmap item
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..ac5ad9f
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  python-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Compile-check all Python prototypes
+        run: |
+          find . -name "*.py" -print0 | xargs -0 -n1 python -m py_compile
+
+  validate-badge-schemas:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install jsonschema
+        run: pip install jsonschema
+      - name: Validate example badges against the schema
+        run: |
+          python - <<'PY'
+          import json
+          import sys
+          from pathlib import Path
+
+          from jsonschema import Draft202012Validator
+
+          schema = json.loads(Path("badges/badge-metadata-schema.json").read_text())
+          validator = Draft202012Validator(schema)
+
+          examples = sorted(Path("badges").glob("*-example.json"))
+          if not examples:
+              sys.exit("No badge example files found under badges/")
+
+          failed = False
+          for example in examples:
+              instance = json.loads(example.read_text())
+              errors = sorted(validator.iter_errors(instance), key=str)
+              if errors:
+                  failed = True
+                  print(f"::error file={example}::{len(errors)} schema violation(s)")
+                  for error in errors:
+                      print(f"  - {error.message}")
+              else:
+                  print(f"OK: {example}")
+
+          sys.exit(1 if failed else 0)
+          PY
diff --git a/CITATION.cff b/CITATION.cff
index 7cad238..52072c9 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -2,12 +2,21 @@ cff-version: 1.2.0
 title: "OpenLab Agentic Education"
 message: "If you use this framework, please cite it as below."
 type: software
+version: "0.1.0"
+date-released: "2026-07-08"
 authors:
   - family-names: Vargas
     given-names: Roger
 abstract: "A research and prototype framework for preserving human agency, evidence, and teacher judgment in AI-supported learning."
-license: "LicenseRef-TBD"
-repository-code: "https://github.com/porroto/openlab-agentic-education"
+license: "MIT"
+repository-code: "https://github.com/porroto/Agentic-Education"
+preferred-citation:
+  type: article
+  title: "From Co-Intelligence to Proof-of-Learning"
+  authors:
+    - family-names: Vargas
+      given-names: Roger
+  year: 2026
 keywords:
   - agentic education
   - proof-of-learning
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..78a5131
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,61 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community — one that reflects the trust-first,
+human-governed values of this project.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Focusing on what is best for learners, educators, and the community, not
+  just individual contributors
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Uploading or requesting real, identifiable student data in violation of this
+  project's [safety boundary](README.md#safety--ethics-boundary)
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards
+of acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior deemed inappropriate, threatening, offensive, or
+harmful.
+
+## Scope
+
+This Code of Conduct applies within all project spaces (issues, pull requests,
+discussions) and when an individual is officially representing the project in
+public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainer listed in [SECURITY.md](SECURITY.md). All
+complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..50061b3
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,29 @@
+# Contributing
+
+Thanks for your interest in OpenLab Agentic Education. This is a research and prototype project — contributions from educators, researchers, and builders are welcome.
+
+## Ways to contribute
+
+- **Educators & researchers** — open an issue with feedback on the concept paper, rubrics, or governance documents. Use the "Research Note" or "Idea" issue templates.
+- **Builders** — improve or extend prototypes in `agents/` and `prototypes/`. Open an issue first for anything beyond a small fix.
+- **Everyone** — report unclear docs, broken links, or gaps between the framework and real classroom practice.
+
+## The synthetic-data rule
+
+This is the one rule that overrides everything else:
+
+> **No real student data, ever.** No real names, identifiable student work, school records, private conversations, or any personally identifiable information from a minor.
+
+All examples, sample evidence packages, and prototype inputs/outputs must be synthetic or fully de-identified. Pull requests that add real student data will be closed, not merged with edits. See [`governance/student-data-rules.md`](governance/student-data-rules.md) and [`data/README.md`](data/README.md).
+
+## Workflow
+
+1. Open an issue describing the change (see [`gh600/github-workflow-lab.md`](gh600/github-workflow-lab.md) for the suggested pattern).
+2. Create a branch and draft or revise the file(s).
+3. Make sure any markdown changes pass the repo's markdown check.
+4. Review your change against the [OLA trust rules](docs/05-ola-trust-layer.md) and the safety boundary in the [README](README.md#safety--ethics-boundary).
+5. Open a pull request using the PR template. A human maintainer reviews and merges — AI-assisted contributions are welcome but final merge decisions are made by a person.
+
+## Code of Conduct
+
+Participation in this project is governed by our [Code of Conduct](CODE_OF_CONDUCT.md).
diff --git a/LICENSE.md b/LICENSE.md
deleted file mode 100644
index 3be58cb..0000000
--- a/LICENSE.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# License
-
-License selection is pending.
-
-Suggested path:
-
-- Research papers and educational framework: consider **CC BY-NC 4.0** or **CC BY 4.0**.
-- Code prototypes: consider **MIT** or **Apache-2.0**.
-- Student-facing classroom materials: keep privacy-safe and do not include identifiable student work.
-
-Do not assume reuse rights until the final license is selected by the project owner.
diff --git a/README.md b/README.md
index 5d1e371..bf1a766 100644
--- a/README.md
+++ b/README.md
@@ -1,51 +1,124 @@
-# OpenLab Agentic Education
+# 🌐 OpenLab Agentic Education
 
-**OpenLab Agentic Education** is a research and prototype framework for preserving human agency in AI-supported learning.
+**Preserving human agency in AI-supported learning.**
 
-It explores how students, teachers, families, communities, institutions, and AI agents can co-create learning evidence while keeping human judgment, ethics, privacy, and proof-of-learning at the center.
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Markdown Check](https://github.com/porroto/Agentic-Education/actions/workflows/markdown-check.yml/badge.svg)](https://github.com/porroto/Agentic-Education/actions/workflows/markdown-check.yml)
+[![Data Policy: Synthetic Only](https://img.shields.io/badge/data-synthetic--only-critical.svg)](data/README.md)
+[![Status: Research Prototype](https://img.shields.io/badge/status-research--prototype-yellow.svg)](ROADMAP.md)
 
-> **AI assists. Humans govern. Evidence speaks. Communities validate.**
+**AI assists. Humans govern. Evidence speaks. Communities validate.**
 
-## Why this exists
+*Not robot-first. Trust-first.*
 
-Generative AI is changing how learners create, research, communicate, design, and demonstrate understanding. If AI can generate polished artifacts, education needs better ways to validate the human learning journey behind those artifacts.
+## What is this?
 
-OpenLab shifts the question from:
+**OpenLab Agentic Education** is a research and prototype framework exploring how students, teachers, families, communities, institutions, and AI agents can **co-create learning evidence** — without surrendering human judgment to automation.
 
-> Did the learner use AI?
+It is the public home of the OpenLab / S.A.T. Labs research line on:
 
-To:
+- 📜 **Proof-of-learning** — verifiable evidence of real learning, owned by the learner
+- 🤝 **Human-governed AI agents** — AI that assists review; humans validate meaning
+- 🎖 **Learner-owned credentials** — portable, community-validated recognition
+- 🛡 **Trust-first governance** — ethics, consent, and accountability by design
 
-> What happened to the learner's thinking, agency, evidence, and growth while working with AI?
+> **Anchor paper:** [*From Co-Intelligence to Proof-of-Learning*](papers/from-co-intelligence-to-proof-of-learning.md) — the conceptual foundation for everything in this repo.
 
-## Core idea
+## How the repo is organized
 
-OpenLab proposes **Agentic Education**: a learning model where students use AI responsibly to build real-world projects, document process evidence, reflect on decisions, and receive human validation for growth.
+The project moves through three connected layers, with a human-governance loop running through all of them:
 
-The final artifact is not the only proof.
+```mermaid
+flowchart LR
+    subgraph Research["🔬 Research"]
+        A[papers/]
+        B[proposals/]
+        C[docs/]
+    end
+    subgraph Framework["🧭 Framework"]
+        D[framework/]
+        E[governance/]
+        F[missions/]
+    end
+    subgraph Prototype["⚙️ Prototype"]
+        G[agents/]
+        H[badges/]
+        I[prototypes/]
+        J[data/]
+    end
 
-**The transformation process becomes the proof.**
+    Research --> Framework --> Prototype
+    Prototype -. human validation .-> Framework
+    Framework -. human validation .-> Research
+```
+
+| Layer | What lives here | Folders |
+|---|---|---|
+| 🔬 **Research** | Concept papers, proposals, references | `papers/` · `proposals/` · `docs/` |
+| 🧭 **Framework** | Rubrics, learning loops, governance, ethics | `framework/` · `governance/` · `missions/` |
+| ⚙️ **Prototype** | Agent specs, badge schemas, synthetic evidence review | `agents/` · `badges/` · `prototypes/` · `data/` |
+
+`gh600/` bridges an external agentic-AI certification track to the OpenLab framework — see [`gh600/certification-to-openlab-map.md`](gh600/certification-to-openlab-map.md).
+
+Start here:
 
-## Repository layers
+1. [`VISION.md`](VISION.md) — why this exists
+2. [`MANIFESTO.md`](MANIFESTO.md) — the principles we won't compromise
+3. [`ROADMAP.md`](ROADMAP.md) — where this is going
+4. [`papers/`](papers/) — the concept paper and research grounding
 
-```text
-Research Layer     -> papers, proposals, references
-Framework Layer    -> rubrics, learning loops, governance, ethics
-Prototype Layer    -> agents, badge schemas, synthetic evidence review
+## Quick start (researchers & educators)
+
+```bash
+git clone https://github.com/porroto/Agentic-Education.git
+cd Agentic-Education
 ```
 
-## Quick start
+- **Educators** → start with [`framework/`](framework/) for rubrics and learning-loop designs
+- **Researchers** → start with [`papers/`](papers/) and [`proposals/`](proposals/)
+- **Builders** → start with [`agents/`](agents/) and [`prototypes/`](prototypes/) (synthetic data only)
 
-Start here:
+## Safety & Ethics Boundary
+
+This project follows a strict trust-first boundary:
+
+- ✅ **Synthetic and de-identified examples only** — no real student data lives in this repo
+- ✅ **Human validation is final** — AI suggests; teachers and communities decide
+- ✅ **Classroom pilots require** school policy compliance, parent/guardian consent, and ethics review
+- ✅ **Recognition, not speculation** — tokens and badges represent learning evidence, never financial instruments in school contexts
+
+## Who is this for?
+
+- **Teachers** designing evidence-based, project-driven classrooms
+- **Researchers** studying human-AI co-intelligence in K–12 education
+- **EdTech builders** who believe student agency is non-negotiable
+- **Communities & families** who want a seat at the validation table
+
+## Roadmap (high level)
+
+- [x] Concept paper: *From Co-Intelligence to Proof-of-Learning*
+- [x] Three-layer architecture (Research → Framework → Prototype)
+- [ ] Evidence Review Agent v0 (synthetic artifacts, rubric alignment, audit trail)
+- [ ] Badge schema v1 + mock digital wallet workflow
+- [ ] Classroom-safe pilot kit (consent templates, teacher guide, rubrics)
+- [ ] Community validation protocol
+- [ ] Public research brief + call for collaborators
+
+See [ROADMAP.md](ROADMAP.md) for details.
+
+## Contributing
+
+Contributions, critiques, and classroom perspectives are welcome — especially from educators and researchers. Please read [CONTRIBUTING.md](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md) first.
+
+## Citing this work
+
+If you use this framework in research, please cite it via [CITATION.cff](CITATION.cff).
 
-1. Read [`VISION.md`](VISION.md)
-2. Read the concept paper: [`papers/from-co-intelligence-to-proof-of-learning.md`](papers/from-co-intelligence-to-proof-of-learning.md)
-3. Review the learning loop: [`framework/openlab-learning-loop.md`](framework/openlab-learning-loop.md)
-4. Try a mission template: [`missions/environmental-sensor-mission.md`](missions/environmental-sensor-mission.md)
-5. Review governance before using any student data: [`governance/student-data-rules.md`](governance/student-data-rules.md)
+## License
 
-## Safety boundary
+MIT — see [LICENSE](LICENSE).
 
-This repository uses **synthetic examples only**. Do not upload real student names, identifiable student work, school records, private conversations, or sensitive data.
+---
 
-Any future classroom pilot should follow school policy, parent/guardian consent requirements, and appropriate research ethics review.
+**Built by [Roger Vargas](https://github.com/porroto)** · STEM educator & founder, S.A.T. Labs / OpenLab
+*A Colombian heart with a global mind.* 🌎
diff --git a/REPO_TREE.md b/REPO_TREE.md
index 489aeaf..4d81532 100644
--- a/REPO_TREE.md
+++ b/REPO_TREE.md
@@ -7,7 +7,7 @@ openlab-agentic-education/
 ├── ROADMAP.md
 ├── MANIFESTO.md
 ├── CITATION.cff
-├── LICENSE.md
+├── LICENSE
 ├── papers/
 ├── proposals/
 ├── docs/
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 0000000..fe5224d
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,33 @@
+# Security & Data Safety Policy
+
+## Reporting a concern
+
+This is a research and prototype repository, not a production system. If you
+find a security issue in a prototype (for example, in
+[`prototypes/evidence-review-agent/`](prototypes/evidence-review-agent/)), or
+you spot real student data or other personally identifiable information
+anywhere in this repository, please open a private report:
+
+- Open a [GitHub security advisory](../../security/advisories/new) for this repository, or
+- Contact the maintainer, [Roger Vargas](https://github.com/porroto), directly.
+
+Please do not open a public issue for reports that involve real student data —
+report it privately so it can be removed before wider attention draws to it.
+
+## No real student data, ever
+
+This repository's governing rule: **no real student data lives here.** Every
+example, sample evidence package, badge, and prototype input/output must be
+synthetic or fully de-identified. See
+[`governance/student-data-rules.md`](governance/student-data-rules.md) and
+[`data/README.md`](data/README.md) for the full policy.
+
+If you discover real student data committed to this repository, please report
+it immediately using the private channel above so it can be removed and the
+history scrubbed.
+
+## Supported scope
+
+Prototypes in this repository are research demos, not hardened software. Do
+not connect them to real student information systems or production
+credential-issuing infrastructure without a full security and privacy review.
diff --git a/agents/README.md b/agents/README.md
new file mode 100644
index 0000000..42f7b02
--- /dev/null
+++ b/agents/README.md
@@ -0,0 +1,11 @@
+# agents/
+
+**State: draft.** Role specifications for the AI agents referenced throughout the framework — what each agent is responsible for, what it must never decide on its own, and how it hands off to a human. These are specs, not running code (see [`prototypes/`](../prototypes/) for the runnable Evidence Review Agent).
+
+- [`mr-v-orchestrator.md`](mr-v-orchestrator.md) — coordinates the other agents and routes work
+- [`ola-review-agent.md`](ola-review-agent.md) — applies OLA trust checks before anything reaches a human reviewer
+- [`portfolio-curator-agent.md`](portfolio-curator-agent.md) — assembles evidence into a learner portfolio
+- [`reflection-coach-agent.md`](reflection-coach-agent.md) — prompts student reflection, never scores it
+- [`validator-agent.md`](validator-agent.md) — checks evidence against rubric structure before human validation
+
+Every agent here assists a human decision-maker; none issues a final grade, badge, or credential on its own — see the [safety boundary](../README.md#safety--ethics-boundary).
diff --git a/assets/README.md b/assets/README.md
new file mode 100644
index 0000000..9762859
--- /dev/null
+++ b/assets/README.md
@@ -0,0 +1,7 @@
+# assets/
+
+Static images used for repo presentation, not for the framework itself.
+
+- [`social-preview.png`](social-preview.png) — 1280×640 banner for GitHub's social preview
+  (**Settings → General → Social preview** — upload this file there; GitHub can't be
+  configured from a commit, so this step is manual).
diff --git a/assets/social-preview.png b/assets/social-preview.png
new file mode 100644
index 0000000..e67a80a
Binary files /dev/null and b/assets/social-preview.png differ
diff --git a/badges/README.md b/badges/README.md
new file mode 100644
index 0000000..500fbba
--- /dev/null
+++ b/badges/README.md
@@ -0,0 +1,10 @@
+# badges/
+
+**State: draft schema, v1.** Digital badge format for proof-of-learning credentials — deliberately **recognition, not speculation**: badges represent validated learning evidence, never a financial instrument.
+
+- [`badge-metadata-schema.json`](badge-metadata-schema.json) — the JSON Schema every badge must validate against
+- [`proof-of-learning-badge-example.json`](proof-of-learning-badge-example.json) — example badge for a completed mission
+- [`ai-collaboration-badge-example.json`](ai-collaboration-badge-example.json) — example badge for documented human-AI collaboration
+- [`non-financial-badge-policy.md`](non-financial-badge-policy.md) — the policy that keeps badges non-financial and revocable
+
+Every badge requires a `human_validation` object and a `non_financial: true` flag — see the schema for the full contract.
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..98c87e9
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,13 @@
+# docs/
+
+**State: draft.** Numbered research briefs that walk through the framework component by component, from the core idea to governance and ethics.
+
+1. [`01-agentic-education.md`](01-agentic-education.md) — what Agentic Education means here
+2. [`02-human-agency-layer.md`](02-human-agency-layer.md) — preserving student agency alongside AI assistance
+3. [`03-proof-of-learning-framework.md`](03-proof-of-learning-framework.md) — the evidence and rubric model
+4. [`04-loop-design.md`](04-loop-design.md) — the act → document → reflect → validate loop
+5. [`05-ola-trust-layer.md`](05-ola-trust-layer.md) — the trust checks AI outputs must pass before reaching a human
+6. [`06-governance.md`](06-governance.md) — decision rights and human-in-the-loop policy
+7. [`07-ethics-and-privacy.md`](07-ethics-and-privacy.md) — privacy, consent, and ethical boundaries
+
+Read in order for the full arc, or jump to the number matching your question.
diff --git a/framework/README.md b/framework/README.md
new file mode 100644
index 0000000..d253788
--- /dev/null
+++ b/framework/README.md
@@ -0,0 +1,11 @@
+# framework/
+
+**State: stable draft.** The middle layer of the project — rubrics, the learning loop, and the templates teachers and students actually use to generate and validate evidence. This is where the concept paper turns into something classroom-usable.
+
+- [`openlab-learning-loop.md`](openlab-learning-loop.md) — the core repeatable cycle (act → document → reflect → validate)
+- [`proof-of-learning-rubric.md`](proof-of-learning-rubric.md) — how evidence of real learning is assessed
+- [`human-ai-collaboration-rubric.md`](human-ai-collaboration-rubric.md) — how AI-assisted process is assessed, separate from the final artifact
+- [`student-reflection-template.md`](student-reflection-template.md) — the reflection prompt structure students fill in
+- [`teacher-validation-template.md`](teacher-validation-template.md) — the sign-off structure teachers use to validate evidence
+
+See [`docs/03-proof-of-learning-framework.md`](../docs/03-proof-of-learning-framework.md) and [`docs/04-loop-design.md`](../docs/04-loop-design.md) for the reasoning behind these documents.
diff --git a/gh600/README.md b/gh600/README.md
new file mode 100644
index 0000000..8a1d4fb
--- /dev/null
+++ b/gh600/README.md
@@ -0,0 +1,10 @@
+# gh600/
+
+**State: draft.** Study notes bridging the external "GH-600: Developing in Agentic AI Systems" certification track to the OpenLab framework — how generic agentic-AI concepts (tools, memory, evaluation, governance) map onto this project's specific agents and rubrics.
+
+- [`study-notes.md`](study-notes.md) — what GH-600 covers and how it connects to OpenLab
+- [`agentic-ai-concepts.md`](agentic-ai-concepts.md) — key agentic-AI concepts in plain language
+- [`certification-to-openlab-map.md`](certification-to-openlab-map.md) — the concept-to-implementation mapping table
+- [`github-workflow-lab.md`](github-workflow-lab.md) — the suggested issue → branch → review → merge workflow used across this repo
+
+This folder is a learning log, not a course requirement — it exists so the reasoning behind the framework's agent/tool/memory/evaluation/governance split is traceable to its source material.
diff --git a/governance/README.md b/governance/README.md
new file mode 100644
index 0000000..fa9f488
--- /dev/null
+++ b/governance/README.md
@@ -0,0 +1,11 @@
+# governance/
+
+**State: draft, requires legal/policy review before real-world use.** The rules that keep this project trust-first: privacy, consent, and who has final say when an AI agent and a human disagree.
+
+- [`human-in-the-loop-policy.md`](human-in-the-loop-policy.md) — where human sign-off is mandatory and cannot be automated away
+- [`student-data-rules.md`](student-data-rules.md) — the synthetic/de-identified data rule in full
+- [`privacy-policy-draft.md`](privacy-policy-draft.md) — draft privacy policy for any future pilot
+- [`parent-consent-template.md`](parent-consent-template.md) — draft parent/guardian consent language
+- [`ai-use-disclosure.md`](ai-use-disclosure.md) — template disclosure of how AI was used in a learning artifact
+
+None of these documents are legal advice. Any real classroom pilot needs review by qualified school policy and legal counsel before use — see the [safety boundary](../README.md#safety--ethics-boundary).
diff --git a/missions/README.md b/missions/README.md
new file mode 100644
index 0000000..c5f95d1
--- /dev/null
+++ b/missions/README.md
@@ -0,0 +1,10 @@
+# missions/
+
+**State: draft.** Sample classroom mission templates — the project-based scenarios students would run through the OpenLab learning loop to generate proof-of-learning evidence.
+
+- [`ai-literacy-mission.md`](ai-literacy-mission.md)
+- [`environmental-sensor-mission.md`](environmental-sensor-mission.md)
+- [`microbit-stem-mission.md`](microbit-stem-mission.md)
+- [`recycling-impact-mission.md`](recycling-impact-mission.md)
+
+Each mission is a template, not a finished lesson plan — adapt it to your subject, grade level, and available materials, and pair it with the templates in [`framework/`](../framework/).
diff --git a/papers/README.md b/papers/README.md
new file mode 100644
index 0000000..93e1345
--- /dev/null
+++ b/papers/README.md
@@ -0,0 +1,9 @@
+# papers/
+
+**State: draft.** Research writing — the conceptual foundation this whole repo builds on.
+
+- [`from-co-intelligence-to-proof-of-learning.md`](from-co-intelligence-to-proof-of-learning.md) — the anchor concept paper (see [CITATION.cff](../CITATION.cff) to cite it)
+- [`apa-references.md`](apa-references.md) — reference list in APA format
+- [`figures/`](figures/) — figures and diagrams referenced by the paper
+
+The concept paper is the entry point for researchers evaluating this project. Everything in `framework/` and `prototypes/` is an attempt to operationalize the ideas here.
diff --git a/pilot-kit/README.md b/pilot-kit/README.md
new file mode 100644
index 0000000..55f1398
--- /dev/null
+++ b/pilot-kit/README.md
@@ -0,0 +1,12 @@
+# pilot-kit/
+
+**State: draft, not yet run in a real classroom.** This folder is the bridge from research repo to classroom-usable system — what a teacher or district actually needs in hand to try one OpenLab mission with real students, safely.
+
+A pilot kit is four things:
+
+1. **Consent** — [`../governance/parent-consent-template.md`](../governance/parent-consent-template.md), adapted per school policy before use
+2. **A teacher guide** — [`teacher-guide.md`](teacher-guide.md), a step-by-step walkthrough of running one mission through the OpenLab learning loop
+3. **A rubric pack** — [`../framework/proof-of-learning-rubric.md`](../framework/proof-of-learning-rubric.md) and [`../framework/human-ai-collaboration-rubric.md`](../framework/human-ai-collaboration-rubric.md), printed together as the scoring reference
+4. **Mock-wallet slides** — [`mock-wallet-slides.md`](mock-wallet-slides.md), an outline for explaining the badge/credential concept to students and families before any real badge is issued
+
+None of this is legal advice, and nothing here should be used with real student data until school policy compliance, parent/guardian consent, and an ethics review are in place — see the [safety boundary](../README.md#safety--ethics-boundary).
diff --git a/pilot-kit/mock-wallet-slides.md b/pilot-kit/mock-wallet-slides.md
new file mode 100644
index 0000000..142c876
--- /dev/null
+++ b/pilot-kit/mock-wallet-slides.md
@@ -0,0 +1,43 @@
+# Mock Digital Wallet: Slide Outline
+
+A short outline for introducing the badge/credential concept to students
+and families **before** any real badge is issued. Use mocked, synthetic
+examples only — this is an explainer, not a live demo of a real system.
+
+## Slide 1 — What is a badge here?
+
+A badge is **evidence of validated learning**, not a grade and not money.
+It records: what mission you did, what you made, how you used AI, and that
+a teacher reviewed and validated your evidence.
+
+## Slide 2 — What a badge is NOT
+
+- Not a cryptocurrency or financial asset
+- Not tradeable for money
+- Not issued by an algorithm alone — see
+  [`badges/non-financial-badge-policy.md`](../badges/non-financial-badge-policy.md)
+
+## Slide 3 — What's inside a badge (mock example)
+
+Walk through a synthetic example from
+[`badges/proof-of-learning-badge-example.json`](../badges/proof-of-learning-badge-example.json):
+mission, evidence list, AI-use disclosure, human validation record,
+`non_financial: true`.
+
+## Slide 4 — Who can see it
+
+Explain who holds the badge (the learner), who validated it (the teacher),
+and what privacy protections apply — no identifiable data goes into any
+public or shared record. See
+[`governance/privacy-policy-draft.md`](../governance/privacy-policy-draft.md).
+
+## Slide 5 — How a badge can be revoked or corrected
+
+Badges are revocable. Explain the process from
+[`badges/non-financial-badge-policy.md`](../badges/non-financial-badge-policy.md) —
+this builds trust that the system stays human-governed after issuance, too.
+
+## Slide 6 — Questions
+
+Leave time for student and family questions before running the pilot
+mission that leads to a badge.
diff --git a/pilot-kit/teacher-guide.md b/pilot-kit/teacher-guide.md
new file mode 100644
index 0000000..73efe26
--- /dev/null
+++ b/pilot-kit/teacher-guide.md
@@ -0,0 +1,43 @@
+# Teacher Guide: Running One Pilot Mission
+
+A step-by-step walkthrough for taking a single mission from
+[`missions/`](../missions/) through the [OpenLab Learning Loop](../framework/openlab-learning-loop.md)
+with one class, section, or small group.
+
+## Before you start
+
+- [ ] Confirm the mission fits your subject, grade level, and available time
+- [ ] Confirm you have parent/guardian consent using
+      [`governance/parent-consent-template.md`](../governance/parent-consent-template.md),
+      adapted to your school's required language
+- [ ] Confirm the pilot uses only synthetic or fully de-identified data until
+      an ethics review clears real student artifacts —
+      see [`governance/student-data-rules.md`](../governance/student-data-rules.md)
+- [ ] Print or share the rubric pack:
+      [`framework/proof-of-learning-rubric.md`](../framework/proof-of-learning-rubric.md) and
+      [`framework/human-ai-collaboration-rubric.md`](../framework/human-ai-collaboration-rubric.md)
+
+## Running the loop
+
+1. **Mission** — introduce the mission question and the evidence students will need to collect (see the mission file's "Evidence to collect" list).
+2. **AI Collaboration** — students use an AI assistant for brainstorming, research, or drafting support. Every use gets logged with
+   [`governance/ai-use-disclosure.md`](../governance/ai-use-disclosure.md).
+3. **Creation** — students build the artifact (a report, a prototype, a data set, a design).
+4. **Evidence Collection** — students gather the process evidence the mission calls for, not just the final artifact.
+5. **Reflection** — students complete
+   [`framework/student-reflection-template.md`](../framework/student-reflection-template.md).
+6. **Human Validation** — you (the teacher) review the evidence and reflection using
+   [`framework/teacher-validation-template.md`](../framework/teacher-validation-template.md).
+   This step is never automated — see the
+   [human-in-the-loop policy](../governance/human-in-the-loop-policy.md).
+7. **Recognition** — if validated, the student is eligible for the mission's badge candidate. Introduce the badge concept with
+   [`mock-wallet-slides.md`](mock-wallet-slides.md) before issuing anything.
+8. **Portfolio Growth** — the validated evidence is added to the student's portfolio (see
+   [`prototypes/portfolio-generator/`](../prototypes/portfolio-generator/) for a sample).
+
+## After the pilot
+
+- [ ] Document teacher workload (time spent per student on validation)
+- [ ] Document observed student reflection quality
+- [ ] Note anything that should change in the mission, rubric, or loop before the next pilot
+- [ ] Share feedback via a GitHub issue (see [CONTRIBUTING.md](../CONTRIBUTING.md)) — real classroom feedback, kept privacy-safe, is exactly what this project needs
diff --git a/proposals/README.md b/proposals/README.md
new file mode 100644
index 0000000..3eecb6d
--- /dev/null
+++ b/proposals/README.md
@@ -0,0 +1,9 @@
+# proposals/
+
+**State: draft.** Grant and outreach proposals built on the concept paper — included here for transparency about where this project is seeking partners and funding, and so collaborators can see the pitch in its own words.
+
+- [`wharton-gail-proposal.md`](wharton-gail-proposal.md)
+- [`lambda-research-grant.md`](lambda-research-grant.md)
+- [`penn-state-csats-outreach.md`](penn-state-csats-outreach.md)
+
+These are living drafts, not submitted-and-final documents; expect them to change as partnerships develop.
diff --git a/prototypes/README.md b/prototypes/README.md
new file mode 100644
index 0000000..a21babc
--- /dev/null
+++ b/prototypes/README.md
@@ -0,0 +1,8 @@
+# prototypes/
+
+**State: experimental.** Small, runnable demos that operationalize the framework — proof that the ideas in `papers/` and `framework/` are more than promises. Every prototype here runs only on synthetic or fully de-identified data.
+
+- [`evidence-review-agent/`](evidence-review-agent/) — reviews a synthetic student evidence package against the proof-of-learning rubric and produces a teacher review packet; every output is stamped `pending_teacher_review`
+- [`portfolio-generator/`](portfolio-generator/) — assembles evidence into a sample learner portfolio
+
+Following the project's "one prototype before one platform" principle: these are meant to be small and legible, not production systems.