smg

SMG Dev Guide

AI-powered development guide for the Shepherd Model Gateway — 4 process-enforcing skills that change what your AI coding agent does, not just what it knows.

Works with Google Antigravity, Gemini CLI, Claude Code, Codex, and Cursor.

Install

Google Antigravity

Project-level (Recommended): Antigravity natively supports the skills through its workflow system. Simply open this repository (or copy the .agents/ and skills/ directories into your SMG project root) in the Antigravity IDE and it will automatically discover them.

Global: To make these skills and workflows available across all projects, copy or symlink them into your global Antigravity ~/.gemini/antigravity/ directory:

git clone https://github.com/lightseekorg/smg-dev-guide.git ~/.gemini/antigravity/repos/smg-dev-guide
mkdir -p ~/.gemini/antigravity/workflows ~/.gemini/antigravity/skills
ln -s ~/.gemini/antigravity/repos/smg-dev-guide/.agents/workflows/* ~/.gemini/antigravity/workflows/
ln -s ~/.gemini/antigravity/repos/smg-dev-guide/skills/* ~/.gemini/antigravity/skills/

Gemini CLI

The Gemini CLI natively supports Agent Skills. You can install these skills directly from the repository using the CLI's built-in package manager.

Global Installation (Available in all projects):

gemini skills install https://github.com/lightseekorg/smg-dev-guide.git

Workspace Installation (Only in current project):

gemini skills install https://github.com/lightseekorg/smg-dev-guide.git --scope workspace

Claude Code

From the shell:

claude plugin marketplace add lightseekorg/smg-dev-guide
claude plugin install smg@smg-dev-guide

Or inside Claude Code:

/plugin marketplace add lightseekorg/smg-dev-guide
/plugin install smg@smg-dev-guide

Run /reload-plugins (or restart Claude Code) to load the skills.

Codex

Copy or symlink the skills into your user skills directory:

git clone https://github.com/lightseekorg/smg-dev-guide.git ~/.agents/repos/smg-dev-guide
ln -s ~/.agents/repos/smg-dev-guide/.agents/skills/* ~/.agents/skills/

Or clone into the SMG repo and skills are discovered automatically from .agents/skills/.

Cursor

Install as a Cursor plugin via .cursor-plugin/plugin.json.

Usage

4 skills, each enforcing a specific developer action:

Skill	Action	What It Does
map	Orient	Crate map, layering rules, config propagation, request flow, label pipeline
implement	Build	Detects subsystem, loads recipe, creates tasks, enforces step-by-step execution with verification
review-pr	Review	Maps changed files to checklist sections, creates review tasks per subsystem, cites file:line
contribute	Ship	5-step quality gate (fmt → clippy → test → bindings → commit format) with enforcement

Google Antigravity — invoke workflows using slash commands in the chat:

/map                         → discover codebase structure and ownership
/implement-feature           → guides you through building a feature
/review-pr                   → checks your work against anti-patterns
/verify-pr                   → runs the full 5-step quality gate

Gemini CLI — skills trigger automatically based on your prompt:

"Where does the label pipeline live?"      → Activates map skill
"Am I ready to submit?"                    → Activates contribute skill

Note: You can view installed skills by running gemini skills list.

Claude Code — use the /smg command:

/smg where does the label pipeline live     → smg:map
/smg add a --timeout flag                   → smg:implement
/smg review PR #562                         → smg:review-pr
/smg am I ready to submit                   → smg:contribute

Codex — skills trigger automatically based on your prompt, or invoke explicitly via $smg-implement, $smg-contribute, etc.

How It Works

Unlike passive reference docs, these skills enforce workflows:

• Iron Laws prevent skipping critical steps (e.g. "NO PR WITHOUT PASSING ALL QUALITY GATES")
• Hard Gates block progression without prerequisites (e.g. must identify touched subsystems before reviewing)
• Rationalization Tables counter common excuses for cutting corners
• Skill Chaining ensures implement → contribute → review-pr flow
• 19 Implementation Recipes provide step-by-step guidance with exact file paths, code patterns, and verification commands for every subsystem

Implementation Recipes

implement auto-detects what you're building and loads the right recipe: