From 7fca75c3c7814ce4174aa72bc55f24ad122b4d5f Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 27 Sep 2026 22:59:48 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20install=20profiles=20=E2=80=94=20full?= =?UTF-8?q?=20/=20leaf=20/=20careful-only=20(#42)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Name three Grok Bot install subsets in INSTALL.md and point to them from the README and playbook so buyers need not load the full skill set. Co-authored-by: Code Solutions LLC --- README.md | 1 + docs/INSTALL.md | 17 ++++++++++++++--- docs/PLAYBOOK-V0.md | 1 + 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 18e5b0a..4d6df42 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,7 @@ upstream source files are vendored. End-to-end buyer path: [docs/INSTALL.md](docs/INSTALL.md) (clone → setup-cs-stack → load skills → verify/review loop). +Named install profiles (full, leaf, careful-only): [Install profiles](docs/INSTALL.md#install-profiles). First-run configure skill: [skills/setup-cs-stack/SKILL.md](skills/setup-cs-stack/SKILL.md). Idempotent. Grok Bot only. Optional models/roles fail open if absent. diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 1734e4f..0d49cca 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -48,7 +48,18 @@ Your coding front-door bot may offer a skippable Install once after GitHub is connected. You can skip that offer. This guide does not require a marketplace package. -## 3. Which skills to load +## 3. Install profiles + +Named profiles so you need not load the full set. Still for **Grok Bot** +skill libraries only. Still no marketplace package. + +| Profile | Skills | Typical use | +| --- | --- | --- | +| full | [setup-cs-stack](../skills/setup-cs-stack/SKILL.md) + [careful-mode](../skills/careful-mode/SKILL.md) + [investigate](../skills/investigate/SKILL.md) + [fix-bug](../skills/fix-bug/SKILL.md) + [ship-change](../skills/ship-change/SKILL.md) + [verify](../skills/verify/SKILL.md) + [review-pr](../skills/review-pr/SKILL.md) | coding front door | +| leaf | [investigate](../skills/investigate/SKILL.md) + [fix-bug](../skills/fix-bug/SKILL.md) + [verify](../skills/verify/SKILL.md) (+ [careful-mode](../skills/careful-mode/SKILL.md) optional) | single-leaf implementers | +| careful-only | [careful-mode](../skills/careful-mode/SKILL.md) (+ [verify](../skills/verify/SKILL.md) optional) | high-stakes one-offs | + +## 4. Which skills to load v0 ships a verification + shipping subset. Load what you need: @@ -64,7 +75,7 @@ v0 ships a verification + shipping subset. Load what you need: Index: [skills/README.md](../skills/README.md). Scope: [PLAYBOOK-V0.md](PLAYBOOK-V0.md). -## 4. Verify / review loop (before merge) +## 5. Verify / review loop (before merge) 1. Agent implements behind a PR (never force-push to `main`). 2. Run **verify** on the change — attach evidence to the PR. @@ -75,7 +86,7 @@ Binding principles: [human-gate](../principles/human-gate.md), [no-self-merge](../principles/no-self-merge.md), [verify](../principles/verify.md). -## 5. Smoke check +## 6. Smoke check - Host skill library lists the packages you installed (at least `setup-cs-stack`; full v0 also includes `careful-mode`, `investigate`, `fix-bug`, `ship-change`, `verify`, `review-pr`). - Relative links from a skill into `playbooks/` and `principles/` resolve. diff --git a/docs/PLAYBOOK-V0.md b/docs/PLAYBOOK-V0.md index fe58475..a617b7c 100644 --- a/docs/PLAYBOOK-V0.md +++ b/docs/PLAYBOOK-V0.md @@ -12,6 +12,7 @@ plugin source files are vendored. Verification + shipping packages on `main`: `setup-cs-stack`, `investigate`, `fix-bug`, `ship-change`, `verify`, `review-pr`, `careful-mode`. Index: [skills/README.md](../skills/README.md). +Named install profiles (full, leaf, careful-only): [Install profiles](INSTALL.md#install-profiles). ## Scope table