Skip to content

v1.57.4.0 refactor(ethos): rename Boil the Lake principle to Boil the Ocean#1912

Merged
garrytan merged 6 commits into
mainfrom
garrytan/algiers-v4
Jun 8, 2026
Merged

v1.57.4.0 refactor(ethos): rename Boil the Lake principle to Boil the Ocean#1912
garrytan merged 6 commits into
mainfrom
garrytan/algiers-v4

Conversation

@garrytan
Copy link
Copy Markdown
Owner

@garrytan garrytan commented Jun 8, 2026

Summary

Renames the completeness principle from Boil the Lake to Boil the Ocean
across the whole repo, matching Garry's "Boil the Oceans" post. The metaphor is
reframed so the ocean is the complete destination and lakes are the boilable units
you ship on the way there. Guidance is identical, text only, no runtime behavior change.

This resolves an existing split: the scope_appetite psychographic, the archetypes,
and the completeness intro link already used "boil the ocean" as the good
complete-implementation pole, while the named principle still said "lake."

Incorporates the rename proposed in #1865 by @mvanhorn, with my own edits to the
framing, the resolver sources, tests, and golden fixtures.

What changed

  • ETHOS.md §1 renamed + reframed; CLAUDE.md and README.md references updated.
  • Preamble resolver sources updated (generate-completeness-section.ts, the
    composition.ts skip-list, generate-lake-intro.ts); every SKILL.md regenerated.
  • Unit assertions (skill-validation, terse-build) and the three ship golden
    fixtures updated to the new header.
  • Net diff vs base is purely the rename (verified: no non-rename, non-prose lines).

Tests

  • Free gate (bun test): PASS (exit 0, 0 failures), re-run after each merge and
    after the version bump.
  • Full paid suite (E2E + LLM-judge), per request: 145/147 selected tests PASS.
  • 2 failures, both proven pre-existing on main (not this change):
    • document-release/SKILL.md workflow (LLM-judge) — fails identically on main's
      content (scores c:3 c:2 a:3). LLM-judge threshold on the document-release skill.
    • context-save-list-current-branch (E2E) — fails identically on main's content
      (hidesAlpha: gstack-context list shows other branches' saves instead of
      filtering to current). Pre-existing branch-filter bug, unrelated to the rename.
    • Receipts: both were re-run against origin/main's version of the relevant files
      and failed the same way.

Pre-existing issues worth a separate fix (flagging, not fixing here)

  • gstack-context list does not filter to the current branch by default
    (context-save-list-current-branch). Real functional bug, out of scope for a rename.
  • document-release/SKILL.md workflow scores below the judge threshold.

Version: v1.57.4.0

garrytan and others added 6 commits June 7, 2026 19:50
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>
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>
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>
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>
@trunk-io
Copy link
Copy Markdown

trunk-io Bot commented Jun 8, 2026

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 8, 2026

E2E Evals: ❌ FAIL

65/68 tests passed | $11.92 total cost | 12 parallel runners

Suite Result Status Cost
e2e-browse 4/4 $0.19
e2e-deploy 6/6 $1.35
e2e-design 4/4 $0.72
e2e-plan 8/8 $2.55
e2e-qa-workflow 3/3 $1.28
e2e-review 6/6 $2.24
e2e-workflow 3/3 $0.52
llm-judge 23/26 $0.52
e2e-plan 8/8 $2.55

12x ubicloud-standard-8 (Docker: pre-baked toolchain + deps) | wall clock ≈ slowest suite

Failures

  • ❌ document-release/SKILL.md workflow: unknown
  • ❌ document-release/SKILL.md workflow: unknown
  • ❌ document-release/SKILL.md workflow: unknown

@garrytan garrytan merged commit 41c6d3e into main Jun 8, 2026
23 of 24 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant