Setup

GBrain-inspired setup for Codex. Use when establishing the local package, file conventions, identity files, or a future substrate for the GBrain layer.

mphaxise 3b6e6b8 1.3 KB Updated

File contents

Setup

Use this skill when the user wants to initialize or normalize the Codex-side GBrain package setup.

This port is adapted from garrytan/gbrain at commit 0b47afbf402a4e27a648bb9d131ce584461461ea.

Workflow

  1. Inspect what already exists in the repo.
  2. Decide which setup layer is needed:
    • docs and registries
    • identity files
    • task/report directories
    • future memory-substrate placeholders
  3. Create only the minimal durable structure needed.
  4. Verify the package still validates after setup changes.

Current Upstream Coverage

Choose the topology explicitly: one local brain, a cross-machine thin client, or split engines per worktree. Prefer the repo's file-backed substrate by default; when the real GBrain runtime is requested and available, support Supabase, bring-your-own Postgres, live sync, health verification, and a brain-first lookup policy without silently changing storage engines.

Guardrails

  • Do not bootstrap a fake backend just to mimic upstream GBrain setup.
  • Prefer explicit conventions over hidden magic.
  • Keep setup reversible and easy to understand from the repo itself.

mphaxise/gstack-port-for-codex/tree/main/skills/setup commit 3b6e6b85aa

Frequently asked questions

npx skillmds@latest add mphaxise/setup