feat: update-readme-installation - npm installation instructions

Author: cephalization

README.md

@@ -16,8 +16,19 @@ The harness consists of a simple for-loop, executing a new coding agent with a m
 
 ## Installation
 
+### From npm (recommended)
+
+```bash
+# One-off usage (recommended)
+bunx @cephalization/math <command>
+
+# Global install
+bun install -g @cephalization/math
+```
+
+### From source (for development)
+
 ```bash
-# Clone and link globally
 git clone https://github.com/cephalization/math.git
 cd math
 bun install

todo/LEARNINGS.md

@@ -55,3 +55,11 @@ Use this knowledge to avoid repeating mistakes and build on what works.
 - The workflow triggers on both `push` to main and all `pull_request` events (any branch)
 - Steps are sequential (typecheck then test) since we want to fail fast on type errors before running tests
 - Pre-existing test failure (1 fail, 86 pass) still present - the "dry-run mode skips git operations" test expects a "Skipping git branch creation" message that isn't being logged
+
+## update-readme-installation
+
+- Split the Installation section into "From npm (recommended)" and "From source (for development)" subsections
+- Put npm installation first since most users will want to install from npm, not clone the repo
+- 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

todo/TASKS.md

@@ -69,7 +69,7 @@ Each agent picks the next pending task, implements it, and marks it complete.
 ### update-readme-installation
 
 - content: Update README.md installation section to show npm installation methods: 1) `bunx @cephalization/math <command>` (recommended for one-off usage), 2) `bun install -g @cephalization/math` (global install). Keep the existing clone/link instructions for development.
-- status: pending
+- status: complete
 - dependencies: update-package-name
 
 ### update-readme-bun-requirement