From af83be0a32f09c6e185ae86ba93520aa644feb0e Mon Sep 17 00:00:00 2001 From: Offending Commit Date: Fri, 29 May 2026 11:39:38 -0500 Subject: [PATCH] docs(claude): make CLAUDE.md a shim that imports AGENTS.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CLAUDE.md was a full, drifting duplicate of AGENTS.md. Replace it with a one-line @AGENTS.md import so AGENTS.md is the single source of truth for agent context. Removed content was a stale subset (old openconcho:config key, older rules description) — AGENTS.md already has the current version. Type docs → no version bump. --- CLAUDE.md | 63 +------------------------------------------------------ 1 file changed, 1 insertion(+), 62 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 0ea8d5f..43c994c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,62 +1 @@ -# openconcho - -Frontend UI for self-hosted Honcho instances — browse memories, peers, sessions, conclusions, and chat with memory context. Ships as a web app (`@openconcho/web`) and a Tauri desktop wrapper (`@openconcho/desktop`). - -## Commands - -`make` is the canonical interface; it shells out to pnpm scripts which shell out to turborepo. CI calls the same targets — `make help` lists everything. - -| Command | Purpose | -|---------|---------| -| `make bootstrap` | Install deps + Playwright Chromium (run once after clone) | -| `make dev-web` | Vite dev server on http://localhost:5173 | -| `make dev-desktop` (or `make dev`) | Tauri desktop app | -| `make build` | Turbo: build web + desktop | -| `make lint` | Biome check | -| `make typecheck` | tsc --noEmit | -| `make test` | Vitest (unit + integration), excludes `e2e/` | -| `make test-e2e` | Playwright e2e (uncached) | -| `make check` | lint + typecheck + test | -| `pnpm --filter @openconcho/desktop cargo-check` | Local Rust/Tauri compile check before pushing desktop changes | -| `pnpm --filter @openconcho/web generate:api` | Regen `src/api/schema.d.ts` from `openapi.json` | - -## Structure - -| Path | Purpose | -|------|---------| -| `packages/web/` | Vite + React 19 + TanStack Router/Query SPA | -| `packages/web/src/routes/` | TanStack Router file-based routes (flat-route syntax) | -| `packages/web/src/components/` | Feature components grouped by domain | -| `packages/web/src/api/` | openapi-fetch client + TanStack Query hooks | -| `packages/web/src/lib/` | Config (localStorage) + theme utilities | -| `packages/web/src/hooks/` | Custom React hooks | -| `packages/web/src/test/` | Vitest unit/integration tests + setup | -| `packages/web/e2e/` | Playwright e2e specs | -| `packages/desktop/` | Tauri shell that bundles the built web app | -| `.claude/rules/` | Coding conventions (auto-loaded) | -| `docs/` | Architecture and references | - -## Code Style - -Read `.claude/rules/coding-standards.md` when writing or reviewing any code file. - -## Workflows - -Read `.claude/rules/workflows.md` for recurring task patterns. - -## Architecture - -Read `docs/architecture.md` for component overview, data flow, and design decisions. - -## Key Constraints - -- **No hardcoded URLs** — all connection config lives in `localStorage` under `openconcho:config` -- **TanStack Router flat-route params** — always cast `params` as `as never` at `navigate()` and `` callsites -- **`framer-motion` Variants typing** — import `type Variants` and annotate objects; never use `as const` on variant objects -- **Auth is optional** — token header only sent when non-empty; `checkConnection()` detects if auth is required -- **CSS variables only** — no Tailwind color utilities for theme-aware colors; use `var(--text-1)` etc. -- **Shared deps via pnpm catalog** — version-pinned in `pnpm-workspace.yaml`; reference as `"catalog:"` in package.json -- **Conventional commits enforced** — commitlint runs in husky `commit-msg`; body lines must be ≤100 chars -- **Releases via semantic-release** — `.releaserc.json`; commits land on `main`, no manual version bumps -- **GitHub account** — push under `offendingcommit` (`gh auth switch` if needed) -- **Desktop preflight is local** — Rust/Tauri compile-check no longer runs in PR CI; run `pnpm --filter @openconcho/desktop cargo-check` before pushing any `packages/desktop/**` or `packages/desktop/src-tauri/**` change +@AGENTS.md