From c229efd51898243a243f526288131c472fc09045 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Sun, 7 Jun 2026 16:05:02 +0000 Subject: [PATCH] docs: unify canonical spec URL to code-first-agents.com Point all spec references at the dedicated brand domain instead of the three coexisting URLs: - src/tool-class.ts: beogip.github.io/.../deterministic-tools.html (was a 301 redirect) -> direct https://code-first-agents.com/patterns/deterministic-tools.html - README.md + CLAUDE.md: github.com/.../specs/code-first-agents.md -> https://code-first-agents.com/patterns/deterministic-tools.html - package.json: add homepage https://code-first-agents.com Repository links (clone URL, CI badge, 'spec repo' link) intentionally keep pointing at GitHub since they reference the repo, not the spec. Closes #25 Co-authored-by: Juan Ignacio Gipponi --- CLAUDE.md | 2 +- README.md | 4 ++-- package.json | 1 + src/tool-class.ts | 2 +- 4 files changed, 5 insertions(+), 4 deletions(-) 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 *