gbrain Advisor

Convention: See skills/conventions/brain-first.md. This skill is the proactive voice of the brain — it tells the owner how to run it better.

Contract

This skill guarantees:

• Read-only. gbrain advisor never mutates. It computes a ranked list of actions from existing brain state.
• Print, never execute. You SHOW the user the findings and ASK before running any fix. The user owns every decision.
• Bounded nagging. On a cadence, surface only what changed or what's critical; don't repeat an ignored low-severity item every run.

When to run

• On demand when the user asks "how do I get more out of this brain?"
• On a weekly cadence via the cron recipe below (even idle brains get a "here's how to run this better" ping).

How to run it

gbrain advisor --json

Exit code is the severity gate (E2): 0 clean, 1 warn, 2 critical. The JSON payload is { version, generated_at, worst, findings: [...] }. Each finding has:

• severity — critical | warn | info
• title — one-line why-it-matters
• fix.command_argv — the exact command to fix it (a structured argv)
• fix.dispatch_id — present when the fix is…