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
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
17 changes: 14 additions & 3 deletions docs/INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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.
Expand All @@ -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.
Expand Down
1 change: 1 addition & 0 deletions docs/PLAYBOOK-V0.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading