Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .agents/workflows/implement-feature.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
description: Implement a new feature using subsystem guidance
---
1. Ask the user which subsystem or feature they want to implement if it's not clear from the context.
2. Read the `skills/implement/SKILL.md` file and any corresponding subsystem `.md` files in that directory using the `view_file` tool.
3. Apply the guidelines and constraints from the skill files while implementing the feature.
6 changes: 6 additions & 0 deletions .agents/workflows/map.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
description: Discover codebase structure and subsystem ownership
---
1. Read the `skills/map/SKILL.md` file using the `view_file` tool to orient yourself with the repository structure.
2. If the user asked a specific question about where something lives, use the knowledge from the map to answer them.
3. If they need to understand a specific subsystem, follow the map's instructions to find the relevant crates or directories.
6 changes: 6 additions & 0 deletions .agents/workflows/review-pr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
description: Self-review a PR against SMG anti-patterns
---
1. Read the `skills/review-pr/SKILL.md` and `skills/review-pr/anti-patterns.md` files using the `view_file` tool.
2. Compare the current pending changes (or PR diff) against the documented anti-patterns.
3. Provide a structured review report highlighting any violations and suggesting fixes.
6 changes: 6 additions & 0 deletions .agents/workflows/verify-pr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
description: Verify a PR before submission
---
1. Read the `skills/contribute/SKILL.md` file using the `view_file` tool to understand the 5-step gate function.
2. Execute all 5 steps of the gate function exactly as described.
3. Report the result of each step to the user.
45 changes: 44 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,37 @@

AI-powered development guide for the [Shepherd Model Gateway](https://github.com/lightseekorg/smg) — 4 process-enforcing skills that change what your AI coding agent **does**, not just what it **knows**.

Works with **Claude Code**, **Codex**, and **Cursor**.
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:

```bash
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)**:
```bash
gemini skills install https://github.com/lightseekorg/smg-dev-guide.git
```

**Workspace Installation (Only in current project)**:
```bash
gemini skills install https://github.com/lightseekorg/smg-dev-guide.git --scope workspace
```

### Claude Code

```bash
Expand Down Expand Up @@ -38,6 +65,21 @@ Install as a Cursor plugin via `.cursor-plugin/plugin.json`.
| `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
Expand Down Expand Up @@ -83,6 +125,7 @@ Unlike passive reference docs, these skills **enforce workflows**:
## Directory Structure

```
.agents/workflows/ # Antigravity workflow definitions
.claude-plugin/ # Claude Code marketplace manifest
.cursor-plugin/ # Cursor plugin manifest
.agents/skills/ # Codex skill discovery (symlinks to skills/)
Expand Down