GEMINI.md

See AGENTS.md. See llms.txt. This file is not a separate authority.

Claude Code auto-loads this file and re-injects it after /compact. Antigravity loads it at session start. Both are pointers — doctrine lives in AGENTS.md and Engineering-Standard.

Identity: GitLab username bluefly (not flux423). Git author Thomas @ Bluefly.io <[email protected]>. GitLab CODEOWNERS = @bluefly only.

Auth: AUTHENTICATE_ONCE=YES / DO_NOT_WRAP_EVERY_CALL=YES — inject GITLAB_TOKEN once (GITLAB_BLUEFLY_AGENT_TOKEN), then bare glab. Do not source ~/.config/op/plugins.sh or wrap every call in op run / op plugin run / blu 1p. Doctrine: STD-AUTH-001.

Worktrees: [WORKSPACE-ROOT]/worktrees and [WORKSPACE-ROOT]/BluCity/.gc/worktrees are the SAME Gas City-managed location (macOS alias). Both are valid references to the canonical worktree store. Only Gas City creates worktrees. Never /tmp. Never commit workstation-absolute paths.

DNS: gitlab-bluefly hostname does not resolve from the Mac workstation. glab API calls fail. Use ssh bluefly-platform to run glab on Oracle, or wait for VPN. Git push/pull via SSH still works.

Completion: DONE=YES requires MR_MERGED=YES, DEPLOYED=YES, RUNTIME_VERIFIED=YES, BEAD_CLOSED=YES, WORKTREE_DEREGISTERED=YES, WORKTREE_REMOVED=YES. Receipts must include WORKTREE_PATH= and WORKTREE_REMOVED=YES.

Quick rules: 1. Search before write (QMD). Do not create a competing markdown file. 2. Follow llms.txt links. Nested AGENTS.md closest to the edited file wins. 3. MR target is always release/v0.1.x — never main. 4. Git completion law: ES-GITCC. 5. This workstation is ephemeral. Commit, push, and open MR before declaring done. 6. Inference topology authority: inference-topology.md.