| Folder | Function |
| 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. |