stacklok / toolhive-studio / 24084891114

61%

main: 61%

push

github

chore: add CLAUDE.md and AGENTS.md for AI coding assistants (#1930)

* chore: add CLAUDE.md and AGENTS.md for AI coding assistants

Add project-level instruction files for AI coding assistants:
- CLAUDE.md: Claude Code-specific guidance with project overview,
  build commands, architecture, conventions, and testing patterns
- AGENTS.md: Tool-agnostic equivalent for other AI assistants
  (Cursor, Copilot, Codex, etc.)

Both files document essential commands, pre-commit requirements,
Electron architecture, code conventions, and testing patterns to
reduce repetitive context-setting across conversations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: expand CLAUDE.md and AGENTS.md with missing sections

Add sections identified from best practices research:

CLAUDE.md (106 → 150 lines):
- Auto-generated code rules (never edit manually)
- IPC communication patterns (main ↔ renderer)
- External services (ToolHive API, Sentry, AI Chat)
- Database (SQLite in main process)
- Common gotchas (Docker, Node version, native modules)
- Deep links protocol

AGENTS.md (87 → 110 lines):
- Auto-generated code rules
- Boundaries section (standard AGENTS.md spec)
- Common gotchas
- Electron test runner note

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address PR review feedback on CLAUDE.md and AGENTS.md

Changes based on JAORMX and Copilot review:
- Fix wrong path: route-tree.gen.ts is at renderer/src/, not renderer/src/routes/
- Trim CLAUDE.md from 150 to 104 lines (remove Feature Organization tree,
  IPC Communication, External Services, Database, Key Documentation sections)
- Trim AGENTS.md from 110 to 62 lines (remove Architecture table, Key Libraries,
  Feature Structure — reduce overlap with CLAUDE.md)
- Move Common Gotchas up (right after Environment Requirements)
- Remove redundant headings (# CLAUDE.md, # AGENTS.md)
- Remove pinned versions from AGENTS.md (React 19, TypeScript 6, etc.)
- Fix lint d... (continued)

3068 of 5349 branches covered (57.36%)

Branch coverage included in aggregate %.

5001 of 7975 relevant lines covered (62.71%)

127.53 hits per line