Repository navigation
List the new guides in the README and fix the install doc's hook count - #4403
Merged
Merged
Conversation
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
|
😎 This pull request was merged. |
Review-Finding: docs/install.md:29:docs-accuracy reader=core Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
Merged
capy-ai Bot
added a commit
that referenced
this pull request
Nov 17, 2026
- /autoplan's approval page no longer hides a reviewer's product objection behind "keep your direction". (#4431) - Every skill that loads the shared preamble, on every host, now says to ask a question once and to check a file before handing it over. (#4383) - The Captain manuals now name the `Failed or skipped:` and `Also changed:` lines that READY and lane reports carry. (#4432) - gstack's shell locks hold again on Ubuntu 26.04, where `mkdir` reports success when another process won the race (GST-2247). (#4262) - `test/gstack-lock-race.test.ts` runs the old pattern and the helper against a PATH shim that behaves like uutils 0.8.0 `mkdir`, so it runs on any runner image: the old pattern lets two of four racers win, the helper admits exactly one in each of 60 races and never overlaps across take, hold and release loops, and parallel `gstack-config` writers keep every key. (#4262) - Windows Setup E2E now runs when `bin/gstack-lock.sh` changes. (#4433) - Claude Code's skill list now says when to use each gstack skill, so Opus loads /review and /plan-eng-review when a request fits. (#4387) - A pull request's merge head can no longer keep its `/ship` receipt without a full review. (#4365) - `/ship` now counts review rounds per pull request, and the head that merges always gets a full review. (#4360) - /ship's documentation audit no longer accepts a passing result when an earlier line from the same audit said "blocked". (#4434) - /ship's documentation audit no longer spends an attempt when the audit child writes text after its result. (#4285) - The README lists the two new guides, and the install doc counts its hooks right. (#4403) - docs/releases.md now says the stable release cut treats a failed commit status as red and a pending one as still going, as it has since #4257. (#4436) - /ship's `finish --docs-requested` now accepts a docs fix when the audit named the file with a line number. (#4437) - Document the `.gstack/approval-classes.json` schema, `gstack-approval-classes` CLI commands, and owner approval citation format in `docs/ship-policy.md#approval-classes`. (#4355) - `/eval-plan` now runs four result checks instead of leaving them to judgment. (#4384) - The /review coverage-audit eval no longer fails a run that really read the source file when zsh stops a command line at an `echo ====` separator. (#4364) - Sixteen in-repo documentation links reach their section again. (#4394) - gstack agents now open every status report with what failed, what they didn't verify and what else they changed. (#4273) - Two new short guides. (#4380) - A skill you wrote whose contract still lists `check_after_last_edit` keeps the rest of its contract. (#4439) - The ship policy guide now explains how to merge any pull request with `gstack-ship-queue land`, even in a repository with one maintainer. (#4377) - /ship's test step runs a large unit suite on Linux. (#4426) - Every skill that loads the shared preamble, on every host, now says never to print a whole environment, git config or process table. (#4382) - Pull requests from /ship now open with at most three plain lines, and every merge lands as one commit titled with the PR title. (#4438) - `gstack-pr-wait`, `gstack-ci-gate` and the release cut no longer call a commit green while a check on it failed. (#4257) - `gstack-runaway` now says what a thread's cold and empty wakes cost, not just how many there were (GST-2770). (#4385) - The optional Stop hook no longer checks for a test run after the last edit, and /verify asks for it in plain words instead. (#4428) - /ship's test step says when it ran out of time, and you can set its budget. (#4429) - The remote test command no longer puts every file on one command line. (#4429) - The stable release no longer waits on the nightly Windows tests (GST-2815). (#4400) - Ubicloud fan-outs can no longer overshoot the vCPU limit, and owners no longer delete each other's VMs. (#4430) - hono is pinned to 4.13.16, which fixes five advisories the weekly OSV scan found in 4.13.13 (gstack#4406). (#4408) - `package.json` overrides (#4408) - `test/dependency-security.test.ts`: the lockfile floor check now covers `hono >= 4.13.16`. (#4408) - The nightly Windows test run finishes again. (#4409) - A short write-up checklist in ETHOS.md. (#4381) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The README's docs table now links the two new guides, and the install and uninstall docs now list every hook that setup can register.
Why: the guides were missing from the index, and
docs/install.mdsaid setup registers "up to three hook families" before naming a fourth, and never mentioned the opt-in hooks.Nothing to do as a reader.
Agent notes
What changed.
README.md: two rows under the how-to entries, fordocs/howto-land-a-fix-in-someone-elses-repo.mdanddocs/howto-run-human-playtests.md(added in #4380).docs/install.md: the hooks intro drops the wrong count ("up to three hook families"; setup also registers the default-on timelineStophook), and one new paragraph names the two opt-in hooks, skill routing onUserPromptSubmitand skill contracts onStop, both off by default, linkingdocs/skill-routing-and-contracts.md, then points to the opt-in /plan-ceo-review and /autoplan skill gates indocs/skill-gates.md.docs/uninstall.md: the manual hook-removal list now names the skill-contracts, skill-routing and skill-gate hooks. Plus a changelog fragment.Not docs-only. README.md and docs/install.md are named by workflows and other files, so
bin/gstack-docs-onlyprintsDOCS_ONLY: noand full CI runs.Review. Light depth, docs class: one pass by the lead reviewer, no dispatched readers (the review plan skipped specialists, red team and second-model review). One informational finding,
docs/install.md:29(the uninstall doc's manual list did not name the opt-in hooks), fixed in f1e7f78. The documentation audit then found the new opt-in paragraph still missed the two skill-gate hooks (./setup --ceo-review-gate,--autoplan-gate, setup lines 63-70) and fixed both docs (5f8b35f). Gate edits: none detected (0 tagged).Documentation.
Status: updated. Two factual hook-list corrections; no blockers.
Scope: committed changes from 984a268 to c4c970e (3 commits: README.md, changelog.d/docs-index-and-install-hooks.md, docs/install.md, docs/uninstall.md); no staged, unstaged or untracked content selected. Claims checked against
setup,bin/gstack-settings-hook, docs/skill-routing-and-contracts.md and docs/skill-gates.md.Documentation health:
Coverage debt: none new. This PR only adds documentation, and every hook it names has reference docs (skill-routing-and-contracts.md, skill-gates.md).
Diagram drift: none; the diff has no diagrams or code entities.
Checks run locally.
gstack-prose-lint --gateon the fragment: ok. Pre-push guards: pass. Sealed guard: clear. Tests run in CI at the pushed head.Approvals
Plan: exempt: audited-list
Plan check: exempt audited-list
Refs GST-2757.
Agent notes