A-IForgeEngineDocsGetting-started2. Folder Layout

Forge uses predictable folders for docs, examples, patches, exports, shapes, and repair history.

The exact locations are configurable, but the default structure is intentionally simple.

Simple folder layouts are easier to navigate, troubleshoot, backup, and trust over time.

Especially at 11:43 p.m. when something just renamed 400 notes.


Default Forge Structure

A-I/Forge/Engine/
├── Docs/
├── Examples/
├── Exports/
├── Shapes/
└── Patches/
    ├── vault-patch.md
    ├── Applied/
    ├── Backups/
    └── Reports/

Additional configured paths:

A-I/Forge/Schema/schema.md
A-I/Forge/Exports
A-I/Forge/Inbox
A-I/Forge/Shapes

Folder Meanings

FolderPurpose
A-I/Forge/Engine/DocsInstalled Forge documentation and walkthroughs
A-I/Forge/Engine/ExamplesStarter schemas, patches, shapes, and reusable workflow examples
A-I/Forge/Engine/PatchesActive patch note and patch execution history
A-I/Forge/Engine/Patches/AppliedArchived applied patch notes
A-I/Forge/Engine/Patches/BackupsFile backups created before patch operations
A-I/Forge/Engine/Patches/ReportsPatch reports, summaries, and restore manifests
A-I/Forge/ExportsLint reports, exports, relationship indexes, and generated summaries
A-I/Forge/ShapesShape definition notes and reusable structure templates

Installed Documentation

Forge installs documentation directly into your vault instead of opening external websites or hidden plugin panels.

That means the docs are:

  • searchable
  • linkable
  • editable
  • syncable
  • usable offline

The docs behave like normal Obsidian notes.

You can:

  • bookmark them
  • annotate them
  • link to them
  • customize them
  • move them
  • copy sections into your own systems

Installed Docs

Examples Are Meant to Be Copied

The Examples folder is intentionally practical.

These are not abstract demos.

They are meant to be:

  • copied
  • modified
  • adapted
  • reused

Examples include:

  • starter schemas
  • patch workflows
  • repair examples
  • export workflows
  • shape systems
  • maintenance routines

Most users should start by modifying examples instead of building everything from scratch.


Examples Folder

Why Forge Keeps Operational Files Visible

Forge stores operational data inside the vault on purpose.

That includes:

  • reports
  • exports
  • backups
  • repair manifests
  • patch history
  • dashboards

This keeps maintenance workflows transparent and reviewable.

Nothing disappears into hidden plugin storage.

You can inspect what Forge generated at any time.


Local Edits Are Respected

Forge does not overwrite installed documentation or examples automatically.

If you customize installed notes, your edits remain intact.

The installer skips files that already exist.

This allows the docs and examples to evolve into part of your own vault workflow over time.

Built with LogoFlowershow