A) Proposed Folder Structure

earnOS/
  docs/
    entity-interfaces/
    shared-services/
    provider-governance/
    group-finance/
    wiki/
    templates/

Folder Purposes

• docs/entity-interfaces/: per-entity contracts defining how each entity consumes shared services.
• docs/shared-services/: HR, ICT, and bookkeeping group service models with execution-vs-authority boundaries.
• docs/provider-governance/: provider scope, ownership, and access control patterns.
• docs/group-finance/: group policy on accounts, payment channels, settlement controls, reconciliations.
• docs/wiki/: navigation, indexing, and wiki UI generation rules.
• docs/templates/: reusable markdown templates for key governance pages.

B) Required Top-Level Markdown Files

• README.md: mission, principles, and quick links.
• VERSION.md: current architecture version marker.
• CHANGELOG.md: versioned governance and structure changes.
• SYSTEM-SPINE.md: core architecture and boundary map.
• ENTITY-INDEX.md: master list of entities, canonical links, and interface docs.
• SHARED-AUTHORITY-MODEL.md: group authority and execution boundaries.
• PROVIDER-REGISTRY.md: provider inventory with scope and control patterns.
• METADATA-AND-LINKING-STANDARD.md: required frontmatter and link rules.
• WIKI-MVP-SPEC.md: Cloudflare wiki behavior and generation model.
• GLOSSARY-ACRONYMS.md: shared terminology and acronym dictionary.
• INITIAL-COMMIT-PLAN.md: initial git sequencing and commit messages.