mirror of
https://github.com/garrytan/gstack.git
synced 2026-06-10 12:03:59 +02:00
v1.57.4.0 refactor(ethos): rename Boil the Lake principle to Boil the Ocean (#1912)
* refactor(ethos): rename Boil the Lake principle to Boil the Ocean Reframes the completeness principle so the ocean (the complete thing) is the goal and lakes are the boilable units you ship on the way there. "Don't boil the ocean" was right when engineering time was the bottleneck; AI killed that bottleneck, so the ocean is now the destination. Resolves an existing split: the scope_appetite psychographic, archetypes, and the completeness intro flow already used "boil the ocean" as the complete-implementation pole while the named principle still said "lake". Sources only: ETHOS.md philosophy, CLAUDE.md, README.md, the preamble resolvers, and the plan/autoplan/document-generate templates. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * test: update assertions + golden fixtures for Boil the Ocean rename skill-validation and terse-build now assert "Boil the Ocean"; the three ship golden fixtures are regenerated to match the renamed Completeness Principle header and intro prose. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs: regenerate SKILL.md files for Boil the Ocean rename Mechanical `bun run gen:skill-docs` output: the Completeness Principle header and intro flow now read "Boil the Ocean" across every generated skill. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore: bump version and changelog (v1.57.4.0) Boil the Ocean rename: completeness principle renamed across ETHOS, every generated skill, CLAUDE.md, README, and the preamble resolvers. Text only, no runtime behavior change. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,5 +1,57 @@
|
||||
# Changelog
|
||||
|
||||
## [1.57.4.0] - 2026-06-08
|
||||
|
||||
## **The completeness principle is now Boil the Ocean, matching the post it came from.**
|
||||
## **One name across the ETHOS file, every skill, and the developer-profile dial.**
|
||||
|
||||
The principle that tells gstack to do the complete thing was called "Boil the Lake" in
|
||||
`ETHOS.md` and in every generated skill, with the ocean cast as the anti-pattern. The
|
||||
developer-profile system and the completeness intro link already used "boil the ocean"
|
||||
as the good, ship-the-whole-thing pole. So the same idea carried two opposite framings
|
||||
depending on where you read it. This renames the principle to Boil the Ocean everywhere
|
||||
and reframes the metaphor: the ocean is the complete destination, and lakes are the
|
||||
boilable units you ship on the way there. The guidance is identical. Only the name and
|
||||
the framing prose changed.
|
||||
|
||||
### The numbers that matter
|
||||
|
||||
Reproduce with `git diff v1.57.3.0..HEAD --stat`.
|
||||
|
||||
| Property | Before | After |
|
||||
|---|---|---|
|
||||
| Principle name in ETHOS + every skill | "Boil the Lake" | "Boil the Ocean" |
|
||||
| Name vs. the `scope_appetite` dial ("boil the ocean" = complete) | split | unified |
|
||||
| Files updated | — | 63 (ETHOS, CLAUDE, README, resolvers, templates, generated SKILL.md) |
|
||||
| Runtime behavior change | — | none, text only |
|
||||
|
||||
The one number that matters is zero: no behavior changed. A reviewer reading `ETHOS.md`
|
||||
no longer hits "ocean" as the thing to avoid in one section and the thing to aim for in
|
||||
the next.
|
||||
|
||||
### What this means for you
|
||||
|
||||
You get the same complete-the-work recommendations, now under the name from Garry's
|
||||
"Boil the Oceans" post. The metaphor reads straight through: the ocean is the goal,
|
||||
lakes are how you get there one boil at a time, and only genuinely unrelated
|
||||
multi-quarter migrations sit outside scope. Nothing to do on your end.
|
||||
|
||||
### Itemized changes
|
||||
|
||||
#### Changed
|
||||
- `ETHOS.md` section 1 is renamed to "Boil the Ocean" and reframed so the ocean is the
|
||||
complete destination and lakes are the boilable first units, not the ceiling.
|
||||
- The "Completeness Principle" header injected into every tier-2+ skill now reads
|
||||
"Boil the Ocean," with prose to match.
|
||||
- `CLAUDE.md` and `README.md` references updated to the new name.
|
||||
|
||||
#### For contributors
|
||||
- Source of the rename lives in the preamble resolvers
|
||||
(`generate-completeness-section.ts`, the `composition.ts` skip-list, and
|
||||
`generate-lake-intro.ts`); all SKILL.md files are regenerated from them.
|
||||
- Unit assertions (`skill-validation`, `terse-build`) and the three ship golden
|
||||
fixtures updated to the new header.
|
||||
|
||||
## [1.57.3.0] - 2026-06-07
|
||||
|
||||
## **Every PR `/ship` opens gets the version stamped into its title, fork and agent PRs included.**
|
||||
|
||||
Reference in New Issue
Block a user