Atlas Folder Migration Plan
Purpose
This plan stabilizes the ECC Research Atlas folder taxonomy after the Sustainable / green ECC extension sources (ingested 2026-08-18) step created several off-taxonomy domain folders. No files are moved by this plan; it is a proposed migration map for approval.
Canonical phase-1 folder taxonomy
00_sources/
01_people/
02_concepts/
03_papers/
04_material_systems/
05_experiments/
06_lab_position/
07_visualization/
08_teaching/
09_ai_workflows/
Off-taxonomy folders found
| Folder | Files | Markdown refs | CSV refs | Interpretation |
|---|---|---|---|---|
03_durability/ |
3 | 107 | 115 | Durability property nodes created during lab/sustainable ingest; should mostly become concept/material-system nodes. |
03_micromechanics/ |
5 | 336 | 209 | Micromechanics subdomain duplicated existing concept/experiment nodes. |
06_sustainability/ |
10 | 604 | 533 | Sustainability subdomain duplicated concept/material-system layers and conflicts with 06_lab_position numbering. |
07_computational_design/ |
1 | 8 | 10 | Computational design duplicated 09_ai_workflows and conflicts with 07_visualization numbering. |
Recommended migration principle
- Use soft migration first: copy/merge content to canonical destination, leave old file as a redirect note, then patch links and CSV paths.
- Do not create new top-level folders for domains already represented by
02_concepts,04_material_systems,05_experiments, or09_ai_workflows. - Preserve source-grounded evidence hierarchy: source records and paper cards remain in
00_sourcesand03_papers; conceptual synthesis belongs in02_conceptsor04_material_systems.
File-level migration map
| Old path | Proposed canonical path | Action | Destination exists | MD refs | CSV refs | Referencing files | Reason |
|---|---|---|---|---|---|---|---|
02_concepts/transport_properties.md |
02_concepts/transport_properties.md |
move |
false | 15 | 13 | 15 | Durability resistance property belongs in concept layer. |
02_concepts/permeability.md |
02_concepts/permeability.md |
move |
false | 16 | 10 | 20 | Transport/durability property belongs in concept layer. |
04_material_systems/self_healing_ecc.md |
04_material_systems/self_healing_ecc.md |
merge_then_redirect |
true | 76 | 92 | 32 | Self-healing already has canonical material-system synthesis node. |
05_experiments/single_fiber_pullout.md |
05_experiments/single_fiber_pullout.md |
merge_then_redirect |
true | 141 | 87 | 100 | Single-fiber pullout is an experiment/test node. |
02_concepts/interface_properties.md |
02_concepts/interface_properties.md |
merge_then_redirect |
true | 16 | 11 | 16 | Interface is canonical under interface_properties. |
02_concepts/fiber_bridging_law.md |
02_concepts/fiber_bridging_law.md |
merge_then_redirect |
true | 83 | 38 | 67 | Bridging law is canonical under fiber_bridging_law. |
02_concepts/flaw_design.md |
02_concepts/flaw_design.md |
merge_then_redirect |
true | 81 | 53 | 58 | Matrix toughness effects belong under matrix tailoring. |
02_concepts/fiber_geometry_effects.md |
02_concepts/fiber_geometry_effects.md |
move_or_create |
false | 15 | 20 | 13 | Reusable fiber geometry concept; create only if not absorbed into fiber_bridging_law. |
02_concepts/life_cycle_analysis.md |
02_concepts/life_cycle_analysis.md |
merge_then_redirect |
true | 196 | 165 | 119 | Unify LCA naming with existing life_cycle_analysis. |
02_concepts/embodied_carbon.md |
02_concepts/embodied_carbon.md |
move |
false | 8 | 9 | 11 | Embodied-carbon calculation is a sustainability concept/method. |
02_concepts/embodied_carbon.md |
02_concepts/embodied_carbon.md |
move |
false | 8 | 9 | 11 | Carbon-footprint reduction is a concept. |
02_concepts/circular_economy_materials.md |
02_concepts/circular_economy_materials.md |
move |
false | 272 | 220 | 164 | Circular economy materials is a sustainability concept. |
02_concepts/supplementary_cementitious_materials.md |
02_concepts/supplementary_cementitious_materials.md |
move |
false | 8 | 9 | 11 | SCM availability/supply is a sustainability concept. |
02_concepts/supplementary_cementitious_materials.md |
02_concepts/supplementary_cementitious_materials.md |
move |
false | 8 | 9 | 11 | SCM is a concept/ingredient class supporting Green ECC. |
02_concepts/durability.md |
02_concepts/durability.md |
merge_then_redirect |
true | 55 | 57 | 35 | Absorb into existing durability concept. |
04_material_systems/low_carbon_binders.md |
04_material_systems/low_carbon_binders.md |
move |
false | 15 | 18 | 14 | Low-carbon binder family belongs in material-system layer. |
04_material_systems/cementless_composites.md |
04_material_systems/cementless_composites.md |
merge_then_redirect |
true | 26 | 28 | 23 | AAS binders fit canonical cementless/geopolymer material system. |
04_material_systems/industrial_waste_streams.md |
04_material_systems/industrial_waste_streams.md |
move_or_create |
true | 8 | 9 | 11 | Industrial waste streams are material-system inputs. |
02_concepts/machine_learning_models.md |
02_concepts/machine_learning_models.md |
move |
false | 8 | 10 | 10 | ML/computational design belongs under AI workflow layer. |
Proposed execution phases
Phase 0 — approval checkpoint
Do not move files until this plan is approved. The reference counts are high, so direct deletion would break many links.
Phase 1 — create or merge canonical destination nodes
For move actions, copy the full node to the canonical destination. For merge_then_redirect, append only unique source-grounded content to the existing canonical node under a section such as ## Migrated supporting notes. For move_or_create, create the destination only if the concept is not already covered by a stronger existing node.
Phase 2 — replace old files with redirect notes
Each old file should remain temporarily as a redirect note, e.g. This node has moved to ... Do not add new evidence here. This avoids breaking any unpatched links while the dashboard and graph are regenerated.
Phase 3 — patch references
Patch Markdown and CSV references from old paths to new paths in: claim-evidence matrices, source indexes, paper cards, source notes, graph edge files, lab positioning files, teaching files, and AI workflow files.
Phase 4 — regenerate graph and dashboard
Regenerate rendered Markdown pages, graph edge views, dashboard links, and validation reports.
Phase 5 — final cleanup
After at least one validation pass with zero missing links, either keep redirect notes permanently or remove empty old folders if no remaining references exist.
High-risk items
02_concepts/circular_economy_materials.mdand02_concepts/life_cycle_analysis.mdhave many references; migrate carefully.05_experiments/single_fiber_pullout.md,fiber_bridging_constitutive_law.md, andmatrix_toughness_effects.mdhave many sustainable-extension references; merge content into canonical nodes before patching.04_material_systems/self_healing_ecc.mdshould not compete with04_material_systems/self_healing_ecc.md; merge, then redirect.
Validation criteria after migration
- No references to off-taxonomy folders remain in final CSV/MD files except redirect notes and this plan.
graph_paper_to_node_edges.csv,graph_concept_to_concept_edges.csv, andgraph_lab_to_global_edges.csvhave zero missing target files.- Dashboard rendered Markdown pages regenerate without missing links.
index.mdand dashboard source cards reflect the canonical taxonomy.