diff --git a/packages/iterward/README.md b/packages/iterward/README.md
index 3bdadc6..03e43c9 100644
--- a/packages/iterward/README.md
+++ b/packages/iterward/README.md
@@ -122,7 +122,7 @@ Iterward needs Node.js 22.18 or later and has no npm dependencies. Install it as
 npm install --save-dev @push-based/iterward
 ```
 
-The package gives you the `iterward` command, which you run as `npx iterward`, the engine, which a test imports from `@push-based/iterward`, the MCP server, the default loop, and the build-loop skill. To work on Iterward itself, see the [repository README](../../README.md).
+The package gives you the `iterward` command, which you run as `npx iterward`, the engine, which a test imports from `@push-based/iterward`, the MCP server, the default loop, and the build-loop skill. To work on Iterward itself, see the [repository README](https://github.com/push-based/iterward#readme).
 
 To try Iterward without an install, run each command as `npx @push-based/iterward`, such as `npx @push-based/iterward init`. An install pins the version your runs use, and lets a test import the engine.
 
diff --git a/packages/iterward/package.json b/packages/iterward/package.json
index 50458d7..27eb392 100644
--- a/packages/iterward/package.json
+++ b/packages/iterward/package.json
@@ -6,7 +6,7 @@
   "type": "module",
   "exports": { ".": { "types": "./dist/engine.d.ts", "default": "./dist/engine.js" } },
   "bin": { "iterward": "./dist/bin.js" },
-  "files": ["dist", "examples", "skills", "!skills/*/evals"],
+  "files": ["dist", "docs", "examples", "skills", "!skills/*/evals"],
   "engines": { "node": ">=22.18" },
   "repository": { "type": "git", "url": "git+https://github.com/push-based/iterward.git", "directory": "packages/iterward" },
   "publishConfig": { "access": "public" },