openworm · slarson · Feb 19, 2026 · Feb 19, 2026 · Feb 19, 2026 · Feb 19, 2026
diff --git a/.gitignore b/.gitignore
@@ -2,3 +2,4 @@ _build/*
 .DS_Store
 site
 /github.auth
+CLAUDE.md
diff --git a/docs/Community/ai_agents.md b/docs/Community/ai_agents.md
diff --git a/docs/Community/github.md b/docs/Community/github.md
@@ -10,7 +10,7 @@ This page contains a list of repositories maintained by the OpenWorm project on
 Repositories
 ------------
 
-View the full current list [repositories](../Community/repositories/) of repositories on GitHub.
+View the full current list of [OpenWorm repositories on GitHub](https://github.com/openworm).
 
 Accessing GitHub
 ----------------
@@ -47,11 +47,11 @@ Opening a New Issue
 
 After logging into GitHub, select the OpenWorm organization and then click on the repository in which the issue is located/relevant to. Click on the Issues tab on the menu to the right.
 
-![image](../../images/gh_issue1.png)
+![image](../images/gh_issue1.png)
 
 Next, click on the New Image button in the upper right corner of the screen.
 
-![image](../../images/gh_issue2.png)
+![image](../images/gh_issue2.png)
 
 This will open the interface to create a new issue. You will need to add the following information:
 
@@ -61,7 +61,7 @@ This will open the interface to create a new issue. You will need to add the fol
 -   Add a milestone if appropriate
 -   Add labels to categorize the issue such as what language is being used, issue status (not started, working, etc.) and what function the issue is related to.
 
-![image](../../images/gh_issue3.png)
+![image](../images/gh_issue3.png)
 
 Finally, click on Submit New Issue.
 
@@ -93,10 +93,32 @@ Creating or Adding New Repositories
 
 Already existing repositories can be transferred into the OpenWorm GitHub organization via the ["transfer" mechanism provided by GitHub](https://help.github.com/articles/how-to-transfer-a-repository). New repositories [can be created](https://help.github.com/articles/create-a-repo) under the OpenWorm GitHub organization by request.
 
+Contributing to Design Document Implementation
+-----------------------------------------------
+
+**[Design Documents](../design_documents/) specify what to build.** GitHub issues (generated from DD Integration Contracts) specify the work breakdown.
+
+### DD Contribution Workflow
+
+1. **Browse [Design Documents](../design_documents/)** — find a DD matching your interest (neural modeling -> DD002, visualization -> DD012, etc.)
+2. **Read the DD** — understand the goal, deliverables, and quality criteria
+3. **Read "How to Build & Test" section** — copy-pasteable commands to get started
+4. **Check for GitHub issues** labeled `dd###` (e.g., `dd005` for DD005)
+5. **Claim an issue** — comment: "I'll work on this, ETA: X days"
+6. **Implement according to DD spec** — Quality Criteria define acceptance
+7. **Run tests:** `docker compose run quick-test` (per-PR), `docker compose run validate` (pre-merge)
+8. **Open PR** referencing the DD and issue
+9. **[Mind-of-a-Worm](ai_agents.md#mind-of-a-worm-active-contributor-guide) pre-review** — AI checks DD compliance automatically
+10. **Human L3+ review** — Final approval gate
+
+### Contributor Levels
+
+OpenWorm is evolving toward a structured L0–L5 contributor ladder. See **[Contributor Progression Model](../contributing/contributor-progression.md)** for the full table and progression criteria.
+
 Licenses on repositories
 ------------------------
 
-In historical practice, OpenWorm members have chosen to use the [MIT open source license](http://opensource.org/licenses/MIT) for their repositories. The ultimate choice of license is up to the the authors of a given repository, but we would ask that all OpenWorm repository authors [choose some open source license for your repository](http://choosealicense.com/) and display a LICENSE file in the root of the repository to make it clear how to use it.
+In historical practice, OpenWorm members have chosen to use the [MIT open source license](https://opensource.org/licenses/MIT) for their repositories. The ultimate choice of license is up to the the authors of a given repository, but we would ask that all OpenWorm repository authors [choose some open source license for your repository](https://choosealicense.com/) and display a LICENSE file in the root of the repository to make it clear how to use it.
 
 An example of using the MIT license for OpenWorm code follows:
 

diff --git a/docs/Community/membership.md b/docs/Community/membership.md
@@ -1,7 +1,7 @@
 Membership
 ==========
 
-Our website has a [list of the contributors](http://www.openworm.org/people.html) to the OpenWorm project. Contributors who make regular contributions to the project are considered core members. This page explains the process by which a person becomes a contributor and how a contributor becomes a core member.
+Our website has a [list of the contributors](https://www.openworm.org/people.html) to the OpenWorm project. Contributors who make regular contributions to the project are considered core members. This page explains the process by which a person becomes a contributor and how a contributor becomes a core member.
 
 Privileges of core members
 --------------------------
@@ -42,3 +42,19 @@ Hangouts invite criteria
 ------------------------
 
 - Everybody who is a contributor gains the privilege to join the hangouts so that they can gain core team membership if they want
+
+Relationship to the L0–L5 contributor model
+-------------------------------------------
+
+This page describes OpenWorm's **historical, currently-operational** membership model: anyone with at least one meaningful contribution is a Contributor; sustained activity for 3+ months earns Core Member status.
+
+OpenWorm is evolving toward a more granular [L0–L5 contributor framework](../contributing/contributor-progression.md) with explicit progression criteria and subsystem ownership. Rough mapping between the two models:
+
+| Historical term | Approximate L0–L5 equivalent |
+|---|---|
+| (interested observer, no PRs yet) | L0 Observer |
+| Contributor (one meaningful contribution) | L1 Apprentice / L2 Junior Contributor |
+| Core Member (3+ months regular contribution, attends hangouts) | L3 Contributor / L4 Senior Contributor |
+| (steering, sets project direction) | L5 Founder |
+
+The historical Contributor / Core Member terms remain valid; the L0–L5 framework adds finer-grained levels and explicit advancement criteria as the project scales.
diff --git a/docs/Live-Video-Protocol.md b/docs/Live-Video-Protocol.md
@@ -1,3 +1,11 @@
+---
+search:
+  exclude: true
+---
+
+!!! warning "Historical Content"
+    This page describes an older protocol for setting up live video streams for OpenWorm community meetings. It is retained for archival purposes. For current information about participating in OpenWorm meetings, see the [Community page](community.md#meetings).
+
 **How to set up a live video stream:**
 
 1) download the video encoder [Xsplit Broadcaster](https://www.xsplit.com/broadcaster/download).

diff --git a/docs/Projects/DevoWorm.md b/docs/Projects/DevoWorm.md
@@ -1,8 +1,8 @@
 
 # DevoWorm
 
-The DevoWorm website is located at [devoworm.weebly.com](http://devoworm.weebly.com/). The website features links to 
-educational, academic, media-related and collaborative opportunities associated with the project. DevoWorm is affiliated with the [OpenWorm Foundation](http://www.openworm.org/) and the [Orthogonal Research Laboratory](http://orthogonal-research.weebly.com/). We engage in Open Science, an encourage the use of Jupyter Notebooks, short video descriptions of research, and demos.
+The DevoWorm website is located at [devoworm.weebly.com](https://devoworm.weebly.com/). The website features links to 
+educational, academic, media-related and collaborative opportunities associated with the project. DevoWorm is affiliated with the [OpenWorm Foundation](https://www.openworm.org/) and the [Orthogonal Research Laboratory](https://orthogonal-research.weebly.com/). We engage in Open Science, an encourage the use of Jupyter Notebooks, short video descriptions of research, and demos.
 
 ## Roadmap
 
@@ -16,15 +16,15 @@ DevoWorm is currently divided into three loosely-knit interest areas: developmen
 
 Objective                                        | Examples                    
 ---                                              | ---
-Developmental Dynamics (DD)                      | [Comparative Quantitative Embryogenesis](http://www.mdpi.com/2079-7737/5/3/33)
-DD                                               | [Differentiation Trees and Maps](http://www.biorxiv.org/content/early/2016/07/07/062539)
+Developmental Dynamics (DD)                      | [Comparative Quantitative Embryogenesis](https://www.mdpi.com/2079-7737/5/3/33)
+DD                                               | [Differentiation Trees and Maps](https://www.biorxiv.org/content/early/2016/07/07/062539)
 DD                                               | [Embryo Networks and Developmental Connectomes](https://doi.org/10.1101/146035)
 DD                                               | Time-series of Terminal Differentiation
 Cybernetics and Digital Morphogenesis (C-DM)     | [Morphozoic (Cellular Automata)](https://www.researchgate.net/publication/311738597_Morphozoic_Cellular_Automata_with_Nested_Neighborhoods_as_a_Metamorphic_Representation_of_Morphogenesis)
 C-DM                                             | [Cybernetic Embryo](https://www.academia.edu/33002276/Origins_of_the_Embryo_self-organization_through_cybernetic_regulation)
 C-DM                                             | CompuCell 3D
-Reproduction and Developmental Plasticity (R-DP) | [Experimental Evolution](http://rsos.royalsocietypublishing.org/content/3/11/160496)
-R-DP                                             | [Life-history Plasticity](http://www.biorxiv.org/content/early/2016/03/24/045609)
+Reproduction and Developmental Plasticity (R-DP) | [Experimental Evolution](https://rsos.royalsocietypublishing.org/content/3/11/160496)
+R-DP                                             | [Life-history Plasticity](https://www.biorxiv.org/content/early/2016/03/24/045609)
 
 ## Repos in DevoWorm Github
 
@@ -37,3 +37,21 @@ Repo Name
 [Graphical Visualization](https://github.com/devoworm/Graph-Code)               | Code for Graph Creation
 [Datasets and Analysis](https://github.com/devoworm/DevoWorm)                   | Tools for Developmental Data Science
 [Morphozoic](https://github.com/devoworm/Morphozoic)                            | Morphozoic Models
+
+---
+
+## Related Design Documents
+
+DevoWorm's developmental dynamics work connects to several aspects of the OpenWorm simulation:
+
+- **[Phase 8: Developmental Modeling](../design_documents/DD_PHASE_ROADMAP.md#phase-8-developmental-modeling)** — DevoWorm is the primary existing project for Phase 8 ("Worm That Grows"), which targets multi-stage simulation from L1 larva to adult
+- **DD005: Cell-Type Specialization** — DevoWorm's differentiation trees add temporal dynamics to DD005's CeNGEN-based cell-type specification
+- **DD004: Mechanical Cell Identity** — DevoWorm's CompuCell3D morphogenesis models inform body-scaling mechanics across developmental stages
+
+---
+
+## Continue Reading
+
+- **[Design Documents](../design_documents/index.md)** — The complete technical roadmap
+- **[How It Works: Modeling](../modeling.md)** — Multi-scale architecture overview
+- **[Projects Overview](../projects.md)** — All active projects and their governing DDs
diff --git a/docs/Projects/browser.md b/docs/Projects/browser.md
@@ -3,10 +3,21 @@ OpenWorm Browser
 
 A WebGL based _C. elegans_ body browser implemented as part of the OpenWorm project. 
 
-The 3D _C. elegans_ neurons are provided by the [VirtualWorm project](http://caltech.wormbase.org/virtualworm). We are using the [open-3d-viewer](http://code.google.com/p/open-3d-viewer/) as WebGl engine.
+The 3D _C. elegans_ neurons are provided by the [VirtualWorm project](https://caltech.wormbase.org/virtualworm). We are using the [open-3d-viewer](https://code.google.com/p/open-3d-viewer/) as WebGl engine.
 
-![Worm Browser](../../images/OpenWormBrowser.png)
+![Worm Browser](../images/OpenWormBrowser.png)
 
-The OpenWorm Browser can be accessed [here](http://browser.openworm.org/).
+The OpenWorm Browser can be accessed [here](https://browser.openworm.org/).
 
-The source code for this project can be found [here](https://github.com/openworm/wormbrowser). 
+The source code for this project can be found [here](https://github.com/openworm/wormbrowser).
+
+!!! note "Future Visualization"
+    The next-generation visualization is specified by DD012: Dynamic Visualization Architecture, which plans a Trame-based viewer evolving toward **WormSim 2.0** — a public Three.js + WebGPU site at wormsim.openworm.org. The WormBrowser at browser.openworm.org will continue to be maintained until WormSim 2.0 achieves full feature parity (see DD012 deployment timeline).
+
+---
+
+## Continue Reading
+
+- **DD012: Dynamic Visualization** — The next-generation viewer architecture
+- **[Archived Projects](../archived_projects.md)** — Historical context for Geppetto and other visualization efforts
+- **[Projects Overview](../projects.md)** — All active projects and their governing DDs
diff --git a/docs/Projects/c-elegans-robot.md b/docs/Projects/c-elegans-robot.md
@@ -19,6 +19,7 @@ Repository
 [OpenWorm robots](https://github.com/openworm/robots) repository on GitHub.
 
 Folders:
+
 1. WormHost: PC code to communicate with the onboard Raspberry Pi.
 2. WormRPi: Raspberry Pi onboard code.
 3. WormESP32: ESP32 onboard code.
@@ -32,3 +33,19 @@ Boyle, Berri and Cohen, "Gait modulation in C. elegans: an integrated neuromecha
 
 Eduardo J. Izquierdo and Randall D. Beer, "An Integrated Neuromechanical Model of Steering in C. elegans", ECAL15
 
+---
+
+## Related Design Documents
+
+The robot project embodies the same neuromechanical coupling that the full simulation formalizes:
+
+- **DD002: Neural Circuit Architecture** — The 302-neuron model that drives the robot's simplified connectome
+- **DD015: Closed-Loop Touch Response** — Bidirectional sensorimotor coupling (the simulation equivalent of the robot's sensor-motor loop)
+
+---
+
+## Continue Reading
+
+- **[Archived Projects](../archived_projects.md#connectome-engine-lego-robot)** — Historical context for the Lego robot demonstration
+- **[How It Works: Modeling](../modeling.md)** — The full multi-scale simulation architecture
+- **[Projects Overview](../projects.md)** — All active projects and their governing DDs
diff --git a/docs/Projects/c302.md b/docs/Projects/c302.md
@@ -1,8 +1,61 @@
-c302 modelling framework for C. elegans
-==========================
+c302: Multi-Scale Neural Modeling Framework
+===========================================
 
-c302 is a framework for generating network models in NeuroML 2 based on _C. elegans_ connectivity data. It is primarily intended as a way to generate neuronal networks at multiple levels of detail for the OpenWorm project. 
+c302 is OpenWorm's neural circuit modeling framework, implementing **DD002 (Neural Circuit Architecture)** and serving as the foundation for DD005-DD009, DD014-DD015.
+
+## What It Does
+
+Generates NeuroML2 networks at multiple levels of biophysical detail:
+
+| Level | Cell Type | Synapses | Use Case | DD Reference |
+|-------|-----------|----------|----------|--------------|
+| A | Integrate-and-Fire | Event-driven | Topology testing only | DD002 (Level A) |
+| B | IAF + Activity | Event-driven | Community extensions | DD002 (Level B) |
+| C | HH conductance-based | Event-driven | Default working | DD002 (Level C) |
+| **C1** | **HH + graded synapses** | **Graded** | **Recommended** (Sibernetic coupling) | DD002 (Level C1) |
+| D | Multicompartmental HH | Event-driven | Specialized studies | DD002 (Level D) |
+
+**Level C1 is the default** — graded synapses match _C. elegans_ biology (no action potentials) and enable coupling with Sibernetic body physics.
 
 ![c302](https://raw.githubusercontent.com/openworm/CElegansNeuroML/master/CElegans/pythonScripts/c302/images/c302.png)
 
-For full details see [here](https://github.com/openworm/c302).
+## Current Status (Phase 0)
+
+**Accepted and working:**
+
+- 302-neuron network generation from [Cook2019](https://doi.org/10.1038/s41586-019-1352-7) connectome (DD016)
+- Multi-level framework (Levels A-D) with HH channels
+- Validated against Schafer lab kinematics (DD010 Tier 3)
+
+## Roadmap
+
+**Phase 3 (DD005):** Cell-type specialization
+
+- Generate 128 distinct `.cell.nml` files (one per CeNGEN neuron class)
+- Calibrate conductances from expression-to-electrophysiology regression
+- Validate: Functional connectivity improves 20%+ vs. generic model
+
+**Phase 4 (DD006):** Neuropeptide modulation
+
+- Add 31,479 peptide-receptor interactions ([Ripoll-Sanchez 2023](https://doi.org/10.1016/j.neuron.2023.09.043))
+- GPCR-mediated conductance modulation (seconds timescale)
+
+**Phase 5 (DD007, DD009, DD014):** Organ circuits
+
+- Pharyngeal network (20 neurons + 20 muscles, 3-4 Hz pumping)
+- Intestinal network (20 cells with IP3R oscillator, 50s defecation)
+- Egg-laying network (2 HSN + 6 VC + 16 sex muscles, two-state pattern)
+
+## Repository
+
+[https://github.com/openworm/c302](https://github.com/openworm/c302)
+
+---
+
+## Continue Reading
+
+- **DD002: Neural Circuit Architecture** — The governing specification for c302
+- **[Sibernetic](sibernetic.md)** — The body physics engine that c302 couples with
+- **[Muscle / Neuron / Channel](muscle-neuron-integration.md)** — The ion channel pipeline feeding c302
+- **[Validation Framework](../validation.md)** — How c302 outputs are validated
+- **[Projects Overview](../projects.md)** — All active projects and their governing DDs
diff --git a/docs/Projects/community-proj.md b/docs/Projects/community-proj.md
@@ -1,15 +1,15 @@
 Community Outreach subproject
 =============================
 
-The effort to build the OpenWorm open science community is always ongoing. You can find out more about our OpenWorm community on [another page](../../community/).
+The effort to build the OpenWorm open science community is always ongoing. You can find out more about our OpenWorm community on [another page](../community/).
 
 Previous accomplishments
 ------------------------
 
 -   [Past Journal clubs](https://www.youtube.com/watch?v=JHSqkZ2sFDA&list=PL8ACJC0fGE7D-EkkR7EFgQESpHONC_kcI)
--   [Media attention](http://www.openworm.org/media.html)
--   [Attracting contributors](http://www.openworm.org/people.html)
--   [Attracting supporters](http://www.openworm.org/supporters.html)
+-   [Media attention](https://www.openworm.org/media.html)
+-   [Attracting contributors](https://www.openworm.org/people.html)
+-   [Attracting supporters](https://www.openworm.org/supporters.html)
 -   [Successful crowdfunding](https://www.kickstarter.com/projects/openworm/openworm-a-digital-organism-in-your-browser)
 
 
@@ -48,3 +48,19 @@ Associated Repositories
 </tr>
 </tbody>
 </table>
+
+---
+
+## Related Design Documents
+
+- **[Contributor Progression Model](../contributing/contributor-progression.md)** — The L0-L5 contributor progression framework (Observer → Senior Contributor)
+- **[DD012: RFC Process](../contributing/decision-process.md)** — How Design Documents are proposed, reviewed, and accepted
+- **[AI Contributor Model](../contributing/ai-contributors.md)** — How AI contributors participate in the project
+
+---
+
+## Continue Reading
+
+- **[Community Overview](../community.md)** — How to get involved with OpenWorm
+- **[GitHub Workflow](../Community/github.md)** — Contributing to Design Document implementation
+- **[Design Documents](../design_documents/index.md)** — The complete technical roadmap