[roottool]

Description

Refactor documentation files to enforce strict separation of concerns, eliminate cross-file duplication, and add missing development information.

Type of Change

• Documentation (changes to documentation only)

Boundary Checklist (Required for Implementation Changes)

• This is a non-implementation change (Documentation, Tooling, or CI only)
  • Reason: Documentation-only changes across CLAUDE.md, AGENTS.md, and skills/README.md. No implementation code affected.

Changes

CLAUDE.md (Claude Code working guide)

• Remove content duplicated with AGENTS.md/README.md (coverage lists, API docs, type definitions, JSDoc details, architecture notes)
• Remove redundant project overview line
• Add Toolchain table (bun, tsup, vitest, oxlint, biome, prettier, etc.)
• Add Linting & Formatting commands (lint, format, fix, check)
• Add Quality Checks commands (check:type, check:package)
• Add Publishing command (prepare:publish)
• Add CI/CD section (workflow locations, PR template, Renovate)
• Fix fenced code block without language specifier (MD040)
• Fix broken reference to deleted AGENTS.md "Agent Skills" section

AGENTS.md (implementation rules)

• Remove pointer-only sections with zero original content (Security guarantees, Versioning)
• Remove frozen historical info (v0.1.0 scope)
• Remove Agent Skills infrastructure section (not implementation rules)
• Remove tool compatibility table (Using Skills in Other Tools)
• Fix duplicate heading (MD024)

skills/README.md (skills directory guide)

• Remove Supported Tools section (staleness-prone, each tool's docs are authoritative)
• Remove Relationship to AGENTS.md section (redundant with Maintenance Policy)
• Upgrade Maintenance Policy with detailed steps moved from AGENTS.md

Motivation

CLAUDE.md had significant duplication with AGENTS.md while missing practical development commands. AGENTS.md contained non-rule sections (pointers, historical info, infrastructure docs) that diluted its purpose as an implementation rules document. This PR enforces each file's stated purpose.

Testing

• Verified zero content duplication between CLAUDE.md and AGENTS.md
• Verified all file paths referenced in CLAUDE.md exist
• Verified all package.json scripts are documented in CLAUDE.md
• Pre-commit hooks pass on all commits

Related

• All changes are documentation-only with no impact on runtime behavior

---

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (aafe97c) to head (3beb602).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main       #51   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            3         3           
  Lines           22        22           
  Branches         6         6           
=========================================
  Hits            22        22           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.