new pattern 'follow-obvious-fix'

documents/patterns/follow-obvious-fix.md

@@ -0,0 +1,29 @@
+---
+authors: [emilybache]
+---
+
+# Follow Obvious Fix
+## Problem
+Build tools, package managers, linters, and compilers often provide an explicit next step to resolve a failure.
+
+Rather than wasting focus and tokens trying to assess options, follow the suggested fix. Especially if it is low-risk and purely "infrastructure" (deps, tooling, environment).
+
+## Pattern
+If the error message contains a suggested fix, do that first—*when it’s low-risk and tool/infrastructure-focused*.
+
+Guidelines:
+- Prefer suggestions that are **reversible** and **don’t touch core business logic**.
+- Be cautious with suggestions that are **destructive** (deleting lockfiles, wiping caches broadly, resetting environments).
+- After applying the suggestion, **re-run the original command**. Continue based on the new output.
+
+## Example
+Error message:
+
+> Could not find the proper version of rake (13.3.1) in any of the sources. 
+> Run 'bundle install' to install missing gems.
+
+Do the suggested fix first:
+
+    bundle install
+
+Then re-run the original command. If it still fails, you now have a more current error to act on—without unnecessary guesswork.

documents/relationships.mmd

@@ -50,6 +50,8 @@ graph LR
   patterns/active-partner -->|solves| anti-patterns/flying-blind
   patterns/feedback-loop -->|solves| anti-patterns/flying-blind
   patterns/constrained-tests -->|solves| anti-patterns/flying-blind
+  patterns/follow-obvious-fix -->|solves| obstacles/keeping-up
+  patterns/follow-obvious-fix -->|solves| obstacles/hallucinations
   patterns/habit-hooks -->|solves| obstacles/cannot-learn
   patterns/habit-hooks -->|solves| obstacles/context-rot
   patterns/hooks -->|solves| obstacles/selective-hearing
@@ -75,8 +77,11 @@ graph LR
   patterns/approved-logs -->|uses| patterns/constrained-tests
   patterns/habit-hooks -->|uses| patterns/hooks
   patterns/habit-hooks -->|uses| patterns/feedback-loop
+  patterns/follow-obvious-fix -->|uses| patterns/feedback-loop
   patterns/feedback-loop <-->|similar| patterns/playgrounds
   patterns/feedback-loop <-->|similar| patterns/chain-of-small-steps
+  patterns/follow-obvious-fix <-->|similar| patterns/active-partner
+  patterns/follow-obvious-fix <-->|similar| patterns/offload-deterministic
   patterns/chain-of-small-steps <-->|similar| patterns/offload-deterministic
   patterns/happy-to-delete <-->|similar| patterns/parallel-implementations
   patterns/happy-to-delete <-->|similar| patterns/playgrounds
@@ -106,4 +111,4 @@ graph LR
   obstacles/obedient-contractor -->|related| anti-patterns/silent-misalignment
   obstacles/compliance-bias -->|causes| anti-patterns/silent-misalignment
   obstacles/black-box-ai -->|causes| anti-patterns/silent-misalignment
-  obstacles/keeping-up -->|causes| anti-patterns/flying-blind
+  obstacles/keeping-up -->|causes| anti-patterns/flying-blind

website/config/authors.yaml

@@ -14,3 +14,7 @@ nitsan_avni:
 steve_kuo:
   name: Steve Kuo
   github: kuoman
+emilybache:
+  name: Emily Bache
+  github: emilybache
+  url: https://emilybache.com