agent_guide/.planning/codebase/ARCHITECTURE.md

Codebase Architecture (ARCHITECTURE.md)

Conceptual Core

The project employs a Master-Satellite Zero-Pollution Orchestration Model. The architecture is designed to host local environments mapped centrally for LLM / Developer agents so that their capabilities and tracking modules do not leak into the developer's global OS environment.

Design Patterns & Layers

1. Master Repository Role (new_gene): Synchronizes third-party Submodules, flattens them via .agent/scripts/extract_skills.js and .agent/scripts/sync_vendors.bat, and seeds localized GSD skills via local bin instantiation.
2. Satellite Project Consumption: Satellite repositories pull the tracked objects (like .agent/get-shit-done/ binaries and .agent/skills/gsd-*/ files), run bootstrap.bat, and safely isolate all code environments.

Execution Entry Points

• Master Sync: .agent/scripts/sync_vendors.bat/.sh initializes NPM bounds, installs uipro/get-shit-done-cc strictly inside .agent/env/node_modules/, and runs them from the root via .agent/env/node_modules/.bin/... to safely isolate state.
• Satellite Install: bootstrap.bat/.sh executes the runtime scripts sequentially (Git modules -> node env -> Python .requirements instantiation using a developer-provided $AGENT_PYTHON_PATH).

Data Flow

The data flow travels exclusively via file IO (File reading -> Markdown modification) controlled by the Antigravity Agent framework executing Task() components or user IDE plugins. Git actions (add/commit/push) ensure cross-device immutability.