Mitsue AI Data Center - Repository File Structure

Top-level folder map with function of each area, generated from the working repo tree

1. Folder Map

Top-level directories and how docs/, research/, energy-forest/ and Docs extra/ break down
graph TD
    ROOT["Mitsue Village Project
AI data center /"] ROOT --> DOCS["docs/
published deliverables"] ROOT --> DECKS["decks/
slide decks & funding pptx"] ROOT --> AGENT["agent/
Claude persona files"] ROOT --> MEMORY["memory/
working memory + dream diary"] ROOT --> RESEARCH["research/
scraped source data"] ROOT --> INFRA["infra/
OpenProject VPS + people register"] ROOT --> TOOLS["tools/
md/html to PDF pipeline"] ROOT --> TREESURVEY["tree-survey/
field survey webapp"] ROOT --> ASSETS["assets/
images, logos, mascot art"] ROOT --> D3["3d models/
Blender assets"] ROOT --> SKILLS["skills/
doc/report conventions"] ROOT --> EXTRA["Docs extra/
unsorted legacy scans"] ROOT --> CHAT["chat-exports/
archived AI conversations"] DOCS --> D_STRAT["strategy/"] DOCS --> D_GOV["governance/"] DOCS --> D_MKT["marketing/"] DOCS --> D_OUT["outreach/"] DOCS --> D_MEET["meetings/"] DOCS --> D_EF["energy-forest/"] DOCS --> D_FS["field-survey/"] DOCS --> D_TEAM["team/"] DOCS --> D_REF["reference/"] DOCS --> D_BRIEF["briefs/"] DOCS --> D_FAQ["faq/"] RESEARCH --> R_COUNCIL["council_minutes/"] RESEARCH --> R_TENKAWA["tenkawa_koho/"] RESEARCH --> R_INOCHI["inochi_action_plans/"] RESEARCH --> R_WILDLIFE["wildlife/"] RESEARCH --> R_NEWS["newsletters/"] MEMORY --> M_DAILY["*.md daily logs"] MEMORY --> M_DREAM["dreaming/ light+deep+rem"] D_EF --> EF_CHP["chp-technical/"] D_EF --> EF_ECO["ecology/"] D_EF --> EF_ECON["economics/"] D_EF --> EF_GRID["grid-mapping/"] D_EF --> EF_HIST["history/"] D_EF --> EF_MISC["misc/"] D_EF --> EF_REPLAN["re-plan-alignment/"] D_EF --> EF_SCANS["source-scans/"] D_EF --> EF_WORK["workforce/"] EXTRA --> EX_BID["Bidding information/"] EXTRA --> EX_CHP["CHP biomass/"] EXTRA --> EX_DOME["Dome school from village website/"] EXTRA --> EX_STP["Extra pictures Aizumisato STP/"] EXTRA --> EX_FAC["Facilities/"] EXTRA --> EX_FAIRY["Fairytale/"] EXTRA --> EX_GIFTS["Mayor_vice_mayor_forest_team_gifts/"] EXTRA --> EX_VHALL["mitsue_files from Village hall/"] EXTRA --> EX_PICS["Mitsue pictures/"] EXTRA --> EX_NGO["NGO setup/"] EXTRA --> EX_NPO["NPO setup/"] EXTRA --> EX_THOUGHT["Thoughts/"] classDef top fill:#2b6cb0,color:#fff,stroke:#1a4971,stroke-width:1px classDef docsub fill:#276749,color:#fff,stroke:#1c4532,stroke-width:1px classDef ressub fill:#975a16,color:#fff,stroke:#7b341e,stroke-width:1px classDef memsub fill:#6b46c1,color:#fff,stroke:#44337a,stroke-width:1px classDef efsub fill:#2f855a,color:#fff,stroke:#1c4532,stroke-width:1px classDef exsub fill:#b83280,color:#fff,stroke:#702459,stroke-width:1px class ROOT top class DOCS,DECKS,AGENT,MEMORY,RESEARCH,INFRA,TOOLS,TREESURVEY,ASSETS,D3,SKILLS,EXTRA,CHAT top class D_STRAT,D_GOV,D_MKT,D_OUT,D_MEET,D_EF,D_FS,D_TEAM,D_REF,D_BRIEF,D_FAQ docsub class R_COUNCIL,R_TENKAWA,R_INOCHI,R_WILDLIFE,R_NEWS ressub class M_DAILY,M_DREAM memsub class EF_CHP,EF_ECO,EF_ECON,EF_GRID,EF_HIST,EF_MISC,EF_REPLAN,EF_SCANS,EF_WORK efsub class EX_BID,EX_CHP,EX_DOME,EX_STP,EX_FAC,EX_FAIRY,EX_GIFTS,EX_VHALL,EX_PICS,EX_NGO,EX_NPO,EX_THOUGHT exsub
Scroll/pinch to zoom, drag to pan, or use the +/− controls. Hover a block for its description, click to jump to it in the table below.

2. Function by Folder

What each area is for and what lives in it
FolderFunction
docs/Canonical output of the project. Every subfolder is a deliverable type; each document ships as a Markdown source plus a rendered PDF, kept in sync via tools/convert_md_to_pdf.js.
  docs/strategy/Business case, cashflow model, WBS, EVM plan, founding charter, phases/funding flowchart.
  docs/governance/Permits, village-office onepagers, Koryukan hours-exception request, mascot permit.
  docs/marketing/Brochures (trifold A3/A4), frontpage, impact handout, stakeholder graphics.
  docs/outreach/Cold-outreach email drafts and the outreach tracker, one file per contact/organization.
  docs/meetings/Meeting prep notes, talking points, entity-structure options (A/B/hybrid), Q&A briefings.
  docs/energy-forest/Biomass CHP technical, economics, history, ecology, grid-mapping and workforce material, split into topic subfolders (below).
    chp-technical/Maker shortlist, steam-vs-gasification comparison, H2-vs-electricity-vs-DC analysis, forest-power-compute loop diagram.
    ecology/Academic summaries on planted-landscape sustainability and forest restoration (Yamaura 2012 et al.).
    economics/Resource-potential studies (Leiter 2022), FIT/grid economics check, wildlife-prevention savings talking point.
    grid-mapping/Kansai T&D grid maps and prior-consultation spreadsheets/templates for the 6.6kV interconnection.
    history/Council-minutes forestry findings, 100-year-plan transcription, Meiji/postwar forestry policy summaries, collective timeline guide.
    misc/Ungrouped energy-forest items (biomass chart, ad hoc notes).
    re-plan-alignment/How the project maps onto Mitsue's MoE-funded Village Renewable Energy Plan.
    source-scans/Raw scanned source PDFs (village-hall handouts, forestry brochures) awaiting transcription.
    workforce/Forest-worker interview questions, workforce/energy plan, workforce-relocation strategy.
  docs/field-survey/Heritage tree field guide and school tree-survey proposal (bilingual).
  docs/team/People register - who's who on the project.
  docs/reference/Background reading and external reports (e.g. China rural data centers, this file).
  docs/briefs/One-off task/context briefs for specific people or hand-offs.
  docs/faq/Standing Q&A on community participation and transparency questions.
decks/Slide and funding presentations (pptx/pdf), Gantt chart, finance workbook - binary-first, separate from docs/.
research/Raw structured source data mined from external documents (council minutes, newsletters, action plans, wildlife plans), mostly DuckDB + CSV, feeding docs/energy-forest and docs/outreach.
infra/OpenProject VPS deployment (Docker, backups, restore scripts) and the standalone people-register PHP app.
tools/The doc pipeline: convert_md_to_pdf.js (canonical md/html to PDF converter, mermaid-aware), mermaid render/validate scripts, header/date updater.
agent/Claude's own persistent persona/identity files (IDENTITY, SOUL, USER, HEARTBEAT) - not project content.
memory/Daily working-memory logs plus a separate dream-diary subsystem (dreaming/light, deep, rem).
tree-survey/Self-contained deployable Flask app for school tree-survey fieldwork (templates, DuckDB, photo storage).
assets/Images, logos, and Mitsue-kun mascot art used across docs and decks.
3d models/Blender assets (e.g. the mascot gift box) for physical/3D deliverables.
skills/Reusable doc/report conventions (headers, report-recovery) referenced by the pipeline.
Docs extra/Legacy village-hall scans and unsorted source material not yet organized into docs/ (below).
  Bidding information/Ex-school (Dome/Ao Bara billiards) bid disclosure requests, due-diligence reports, assembly seigan/chinjo docs, toilet-facility disclosure.
  CHP biomass/Mini-CHP and DIY gasifier notes, candidate CHP sites, forest-carbon/growth models, Sugano biomass proposal, Ushitoge processing center.
  Dome school from village website/Original village-site zoning/tender forms and drawings for the ex-school property.
  Extra pictures Aizumisato STP/Reference photos of the Aizumisato sewage treatment plant network setup.
  Facilities/Community Development Promotion Division info requests, Koryukan usage records 2023-2025.
  Fairytale/"Tsuemi-hime" children's fairy tale (JP/EN) and two-page summaries, used for outreach/storytelling.
  Mayor_vice_mayor_forest_team_gifts/Kaya-seed poem and meeting-card gifts prepared for village officials.
  mitsue_files from Village hall/Official village hall documents: RE plan overview + translation, financial analyses, land registry, disaster map, meeting minutes.
  Mitsue pictures/General village/project photography and mascot imagery.
  NGO setup/Ippan Shadan Hojin (NGO) setup guides, checklists, teikan drafts, pro bono law firm correspondence (Baker McKenzie, Morgan Lewis), Koshiba/Kato meeting notes.
  NPO setup/Alternative NPO-entity setup checklist (superseded by the NGO/Ippan Shadan Hojin route).
  Thoughts/Informal thoughts/guideline notes (JP/EN), pre-brainstorm material.
chat-exports/Archived Claude conversation exports kept for provenance.