gaia-architecture

Map Gaia subsystems and data flow to diagnose batchmode bake issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/onehungsolow303-png/forever-shared --skill gaia-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-architecture
Source: https://github.com/onehungsolow303-png/forever-shared/tree/main/skills/gaia-architecture
Command: npx skills add https://github.com/onehungsolow303-png/forever-shared --skill gaia-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gaia architecture provides a comprehensive map of Gaia's subsystems, data flow, and operational gotchas to help engineers diagnose and fix batchmode bake and runtime issues in the Forever engine.

Core Features & Use Cases

  • Subsystem map and reference: detailed layout of Gaia components (Biomes, Spawner, Stamper, WorldMap, GaiaSessionManager) to guide debugging.
  • End-to-end workflow guidance: step-by-step understanding of Gaia's batchmode bake, from headless pipeline to props.bin generation.
  • Real-world scenario: when a bake stalls in batchmode, use the architecture map to locate the driver coroutine and recovery steps.

Quick Start

Run the headless Gaia build to generate a GaiaWorld scene and inspect the Gaia subsystem map.

Frequently Asked Questions about gaia-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does Gaia world generation work in Unity batchmode?

Gaia world generation in Unity batchmode operates through the GaiaHeadlessPipeline, driving coroutines to process Biome presets and output props.bin. Mapping this data flow helps diagnose stalls and verify that the headless bake completes successfully.

Why does my Gaia batchmode bake stall or fail to finish?

A Gaia batchmode bake stall typically occurs within a driver coroutine during the headless pipeline execution. You can locate the exact stall point by inspecting the Gaia subsystem map and following the recovery steps for the affected Spawner or Stamper components.

How do I map Gaia subsystems to debug world-building issues?

To map Gaia subsystems for debugging, reference the architectural layout of Biomes, Spawner, Stamper, WorldMap, and GaiaSessionManager. This explicit subsystem mapping identifies data flow dependencies and operational gotchas to isolate world-building issues.

Can I use Gaia with the Forever engine for procedural world generation?

Yes, Gaia architecture is specifically applied to Forever engine projects to guide procedural world generation. It covers end-to-end workflows from headless pipeline execution to props.bin generation for comprehensive world-building tasks.

What is the data flow between the Gaia Stamper and Spawner components?

The data flow between the Gaia Stamper and Spawner components involves passing WorldMap terrain data through Biome presets to populate environments. Understanding this relationship is critical for diagnosing behavior issues and debugging procedural generation pipelines.