docs: unify canonical spec URL to code-first-agents.com

[claude]

Summary

Unifies the three coexisting spec URLs onto the dedicated brand domain code-first-agents.com, so anyone arriving from the announcement sees a consistent canonical reference.

Canonical URL decision

• Spec page (code + docs): https://code-first-agents.com/patterns/deterministic-tools.html — the direct 301 target of the old beogip.github.io link, now linked directly (no redirect).
• package.json homepage: https://code-first-agents.com — the brand root, conventional for the npm homepage field.

Changes

• src/tool-class.ts — beogip.github.io/.../deterministic-tools.html → code-first-agents.com/patterns/deterministic-tools.html
• README.md (2 spec links) — github.com/.../specs/code-first-agents.md → canonical spec page
• CLAUDE.md — same spec-link update
• package.json — added "homepage": "https://code-first-agents.com"

Repository links (clone URL, CI badge, the "spec repo" link in the README footer) intentionally still point at GitHub, since they reference the repository rather than the spec.

Validation

• bun test — 113 pass / 0 fail
• bunx tsc --noEmit — clean
• bunx biome check . — no errors (only a pre-existing, unrelated info about the Biome config schema version)

Closes #25

Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR unifies three different spec URL variants in use across the repository onto a single canonical domain (code-first-agents.com), eliminating the need to follow a redirect from beogip.github.io. The package.json homepage field is also added, pointing to the brand root as is conventional for npm packages.

• src/tool-class.ts, README.md, and CLAUDE.md all have their spec links updated from either beogip.github.io/... or github.com/beogip/code-first-agents/blob/main/specs/code-first-agents.md to https://code-first-agents.com/patterns/deterministic-tools.html. The domain is confirmed live.
• package.json gains a "homepage": "https://code-first-agents.com" field — the brand root, conventional for npm — keeping the spec-page link separate from the package homepage.

Confidence Score: 5/5

Pure documentation URL update with no logic changes; the target domain is confirmed live.

All four changed files contain only URL string updates in comments, markdown, and package metadata. The new domain resolves correctly, the redirect hop is eliminated, and repository/CI links are correctly left untouched. No code paths, types, or runtime behavior are affected.

No files require special attention.

Important Files Changed

Filename	Overview
src/tool-class.ts	JSDoc spec URL updated from beogip.github.io to code-first-agents.com; no logic changes.
README.md	Two spec hyperlinks updated to canonical domain; repository/CI links left on GitHub as intended.
CLAUDE.md	Single spec URL updated to canonical domain; no other changes.
package.json	Added homepage field pointing to brand root; placement and value are correct for npm convention.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User / LLM reads spec link] --> B{Before this PR}
    B --> C1[beogip.github.io/...\ndeterministic-tools.html]
    B --> C2[github.com/beogip/\ncode-first-agents/blob/main/\nspecs/code-first-agents.md]
    C1 -->|301 redirect| D[code-first-agents.com/\npatterns/deterministic-tools.html]
    C2 -->|separate resource| E[GitHub markdown render]

    A --> F{After this PR}
    F --> D
    F --> G[code-first-agents.com\nnpm homepage]

    style D fill:#90EE90
    style G fill:#90EE90

Loading

_{Reviews (1): Last reviewed commit: "docs: unify canonical spec URL to code-f..." | Re-trigger Greptile}

[github-actions]

🎉 This PR is included in version 0.1.4 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀