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>
This commit is contained in:
Garry Tan
2026-06-07 19:50:20 -07:00
parent e722c5bf89
commit f74f274253
10 changed files with 27 additions and 20 deletions
+1 -1
View File
@@ -457,4 +457,4 @@ Documentation generated:
- **Voice: friendly, concrete, user-forward.** Write like you're explaining to a smart person
who hasn't seen the code. Never corporate, never academic.
- **Completeness over minimalism.** AI makes comprehensive documentation cheap. Don't write
"minimal viable docs" — write complete docs. Boil the lake.
"minimal viable docs" — write complete docs. Boil the ocean.