diff --git a/CLAUDE.md b/CLAUDE.md
index 992a01d..cd33463 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 `@code-first-agents/tool` — the TypeScript implementation of the **Code-First Agents** pattern. This library provides the `Tool` base class that enforces the tool contract from the spec: deterministic CLI tools with Zod input/output schemas, JSON envelope output, self-describing `schema`/`help` introspection, and always-exit-0 semantics.
 
-**Spec:** https://github.com/beogip/code-first-agents/blob/main/specs/code-first-agents.md — the authoritative reference for the pattern. Key concepts this library implements:
+**Spec:** https://code-first-agents.com/patterns/deterministic-tools.html — the authoritative reference for the pattern. Key concepts this library implements:
 - **Tool contract:** named input params, JSON-only output, no LLM calls inside tools, deterministic results, `--schema` for self-description, loud failure modes.
 - **Output spectrum:** L1 (data — raw signals for LLM interpretation), L2 (classification — discrete categories with branching), L3 (instructions — complete procedures the LLM executes verbatim).
 - **Separation principle:** deterministic work lives in code (Tools), the LLM orchestrates judgment (Skills). This repo is the Tool side.
diff --git a/README.md b/README.md
index 999f3df..78b5d4d 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 ![CI](https://github.com/beogip/code-first-agents-tool/actions/workflows/ci.yml/badge.svg)
 [![npm](https://img.shields.io/npm/v/@code-first-agents/tool)](https://www.npmjs.com/package/@code-first-agents/tool)
 
-TypeScript implementation of the [Code-First Agents](https://github.com/beogip/code-first-agents/blob/main/specs/code-first-agents.md) pattern. Provides a `Tool` base class that enforces the tool contract: deterministic CLI tools with Zod input/output schemas, JSON envelope output, self-describing introspection (`--schema`, `--help`), and always-exit-0 semantics.
+TypeScript implementation of the [Code-First Agents](https://code-first-agents.com/patterns/deterministic-tools.html) pattern. Provides a `Tool` base class that enforces the tool contract: deterministic CLI tools with Zod input/output schemas, JSON envelope output, self-describing introspection (`--schema`, `--help`), and always-exit-0 semantics.
 
 **Key idea:** deterministic work lives in code (Tools), the LLM orchestrates judgment (Skills). This library is the Tool side.
 
@@ -208,7 +208,7 @@ The CI workflow handles changelog generation, npm publishing, GitHub releases, a
 
 ## The Code-First Agents Pattern
 
-This library implements the tool contract from the [Code-First Agents spec](https://github.com/beogip/code-first-agents/blob/main/specs/code-first-agents.md). The spec defines a separation principle:
+This library implements the tool contract from the [Code-First Agents spec](https://code-first-agents.com/patterns/deterministic-tools.html). The spec defines a separation principle:
 
 - **Tools** (this library) — deterministic, no LLM calls, Zod-validated I/O, JSON envelope output.
 - **Skills** — LLM-powered orchestrators that call tools and apply judgment.
diff --git a/package.json b/package.json
index 30bfce3..8c4084a 100644
--- a/package.json
+++ b/package.json
@@ -3,6 +3,7 @@
   "version": "0.1.2",
   "description": "Code-first agent tool definitions with Zod schemas",
   "license": "MIT",
+  "homepage": "https://code-first-agents.com",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
diff --git a/src/tool-class.ts b/src/tool-class.ts
index 7c597d3..95b16b9 100644
--- a/src/tool-class.ts
+++ b/src/tool-class.ts
@@ -9,7 +9,7 @@
  *   so LLM callers can self-correct
  * - Always exits with code 0; errors communicated via `ok: false` envelope
  *
- * Spec: https://beogip.github.io/code-first-agents/patterns/deterministic-tools.html
+ * Spec: https://code-first-agents.com/patterns/deterministic-tools.html
  *
  * ## Usage
  *