feat: update-readme-bun-requirement - add Requirements section

Author: cephalization

README.md

@@ -14,6 +14,20 @@ The primary responsibility of this harness is to **reduce context bloat** by dig
 
 The harness consists of a simple for-loop, executing a new coding agent with a mandate from `PROMPT.md` to complete a *single* task from `TASKS.md`, while reading and recording any insight gained during the work into `LEARNINGS.md`.
 
+## Requirements
+
+**[Bun](https://bun.sh) is required** to run this tool. Node.js is not supported.
+
+```bash
+# Install Bun (macOS, Linux, WSL)
+curl -fsSL https://bun.sh/install | bash
+```
+
+Why Bun?
+- This tool is written in TypeScript and uses Bun's native TypeScript execution (no compilation step)
+- The CLI uses a `#!/usr/bin/env bun` shebang for direct execution
+- Bun's speed makes the agent loop faster and more responsive
+
 ## Installation
 
 ### From npm (recommended)

todo/LEARNINGS.md

@@ -63,3 +63,11 @@ Use this knowledge to avoid repeating mistakes and build on what works.
 - Kept `bunx` as the recommended method for one-off usage since it doesn't require global installation
 - Documentation-only changes don't require tests - verified existing tests still pass (with same pre-existing failure)
 - Pre-existing test failure (1 fail, 86 pass) confirmed to exist before changes via git stash verification
+
+## update-readme-bun-requirement
+
+- Placed the Requirements section between "Core Concept" and "Installation" - logical flow for users (understand tool -> check requirements -> install)
+- Used bold markdown + inline link for emphasis: `**[Bun](https://bun.sh) is required**` draws attention while making it easy to find install instructions
+- Included the one-liner install command since most users will need it - reduces friction
+- Listed three concrete reasons why Bun is needed: native TypeScript execution, shebang support, and speed
+- Pre-existing test failure (1 fail, 86 pass) still present - confirmed via git stash that it predates this change

todo/TASKS.md

@@ -75,7 +75,7 @@ Each agent picks the next pending task, implements it, and marks it complete.
 ### update-readme-bun-requirement
 
 - content: Add a prominent "Requirements" section near the top of README.md stating that Bun is required to run this tool (not Node.js). Link to bun.sh for installation instructions. Explain why Bun is needed (TypeScript execution, shebang).
-- status: pending
+- status: complete
 - dependencies: update-readme-installation
 
 ---