From 3e66eb1af407faf04a6e8b4cc1efe6252d01e182 Mon Sep 17 00:00:00 2001
From: Original Gary <276612211+OpenGaryBot@users.noreply.github.com>
Date: Sun, 26 Apr 2026 14:20:52 +1000
Subject: [PATCH] docs(graze-cli): apply CodeRabbit nits to GRAZE.md

- Add blank lines around headings and fenced code blocks (MD022, MD031)
- Add trailing newline (MD047)
- Align semgrep config invocation with the rest of the repo (local
  semgrep-no-animal-violence.yaml, matching .coderabbit.yaml, AGENTS.md
  and CLAUDE.md)
- Cross-reference graze-cli/GRAZE.md from the README directory tree
---
 README.md          |  1 +
 graze-cli/GRAZE.md | 12 +++++++++---
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 93e363f..756f750 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,7 @@ structured-coding-with-ai/
 ├── cline/              # .clinerules/ (14 files)
 ├── cursor/             # .cursorrules + .cursor/rules/ (14 files)
 ├── gemini-cli/         # GEMINI.md
+├── graze-cli/          # GRAZE.md — Open Paws opencode fork (multi-provider failover, advocacy kernel)
 ├── github-copilot/     # .github/ instructions, prompts, chat modes (23 files)
 ├── jetbrains-junie/    # .junie/guidelines.md
 ├── kilo-code/          # .kilocode/rules/ + Memory Bank (21 files)
diff --git a/graze-cli/GRAZE.md b/graze-cli/GRAZE.md
index 79d685d..57b831a 100644
--- a/graze-cli/GRAZE.md
+++ b/graze-cli/GRAZE.md
@@ -3,6 +3,7 @@
 ## What is graze and why use it?
 
 Graze-CLI is Open Paws' fork of [opencode](https://github.com/anomalyco/opencode), an agentic coding CLI for advocacy developers. It supports automatic failover across 9 LLM providers (7 with free tiers: Gemini, Groq, Cerebras, SambaNova, DeepInfra, Ollama, Mistral/CodeStral). Key differences from upstream:
+
 - Advocacy-aware system prompts (neutral mode for external repos, full kernel for Open Paws)
 - Pre-configured NAV/desloppify hooks
 - India bootcamp / global south optimized (free-tier providers, Colab secrets)
@@ -14,6 +15,7 @@ Copy this `graze-cli/` directory to your project root. Graze auto-detects it.
 **NOT** `npm i -g opencode` (upstream, lacks advocacy rules).
 
 ### Global install (recommended for Guild devs)
+
 ```bash
 git clone https://github.com/Open-Paws/graze-cli.git
 cd graze-cli
@@ -21,15 +23,18 @@ npm install
 npm run build
 npm link  # or `bun link`
 ```
+
 Test: `graze --version`
 
 ### Colab / no-install (India bootcamp)
+
 ```bash
 git clone https://github.com/Open-Paws/graze-cli.git
 cd graze-cli
 npm install
 npx graze --version  # or add to $PATH
 ```
+
 Use Colab secrets for API keys: `GOOGLE_GENERATIVE_AI_API_KEY`, `GROQ_API_KEY`, etc.
 
 **npm package pending** (@open-paws/graze publishing tracked [#74](https://github.com/Open-Paws/graze-cli/issues/74)).
@@ -47,8 +52,8 @@ Use Colab secrets for API keys: `GOOGLE_GENERATIVE_AI_API_KEY`, `GROQ_API_KEY`,
 
 ## Advocacy Workflow Rules
 
-1. **Pre-commit**: Always `desloppify scan .` + `semgrep --config=p/open-paws/semgrep-rules-no-animal-violence`
-2. **Economic test**: Before implementing, ask: \"Does this make exploitation less profitable or alternatives more competitive?\"
+1. **Pre-commit**: Always `desloppify scan .` + `semgrep --config semgrep-no-animal-violence.yaml`
+2. **Economic test**: Before implementing, ask: "Does this make exploitation less profitable or alternatives more competitive?"
 3. **Quest submission** (Guild): `platform_submit_quest_completion` when done
 4. **Two-state prompts**: Advocacy kernel auto-injects in Open Paws repos; neutral elsewhere
 5. **Token discipline**: Large context (strategy docs) — `graze run --max-tokens 32k`
@@ -61,8 +66,9 @@ Use Colab secrets for API keys: `GOOGLE_GENERATIVE_AI_API_KEY`, `GROQ_API_KEY`,
 - **India networks**: Gemini blocked? Fallback: `graze herd list | grep free`.
 
 ## Links
+
 - [Graze-CLI Repo](https://github.com/Open-Paws/graze-cli)
 - [India Bootcamp Module 1](https://github.com/Open-Paws/c4c-bootcamp/issues/10)
 - [Desloppify OP Fork](https://github.com/Open-Paws/desloppify)
 
-**Last updated**: 2026-04-26
\ No newline at end of file
+**Last updated**: 2026-04-26