From 95a97d63d3320a9f1be510857ccb69f320c5beeb Mon Sep 17 00:00:00 2001 From: Breadway Date: Sat, 15 Aug 2026 22:04:00 +0800 Subject: [PATCH] Remove CLAUDE.md (renamed to AGENTS.md) --- CLAUDE.md | 50 -------------------------------------------------- 1 file changed, 50 deletions(-) delete mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index d0dfa26..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1,50 +0,0 @@ -# CLAUDE.md — Repo hygiene - -Scope: this file covers *repo hygiene* — branching, remotes, CI — plus a -short map of the binaries. It is not user-facing project documentation. - -This repo follows the branch/release workflow documented in `CONTRIBUTING.md` -— read and follow it for any git, branch, or release work here (the -single-trunk model, `feature/x`/`fix/x` branch naming, how RC tags work, -etc). Don't improvise a different workflow. The short version: there is one -long-lived branch, `main` — no `dev` or `beta` branch exists. `main` -auto-publishes a dev-track build on every push. "Beta" and "stable" are both -just tags, not branches: push a `vX.Y.Z-rc.N` tag to publish a beta-track -build, push a plain `vX.Y.Z` tag to cut the signed stable release. -"Freezing" for stabilization means pausing pushes to `main`, not moving a -branch. This replaced an earlier three-branch (`dev`/`beta`/`main`) model -after `main` was found to have silently rotted out of sync with `dev`/`beta` -across most repos in this ecosystem. - -When starting work on a new feature, create branch `feature/`. -When working on a bug or issue, create branch `fix/`. - -## Remotes -- `origin` — Forgejo (`git.breadway.dev` via Hestia, SSH) — authoritative. -- `github` — GitHub mirror. Push both when publishing. - -## CI -- `dev-release.yml` triggers on `push: branches: ['main']`. -- `rc-release.yml` triggers on `vX.Y.Z-rc.N` tag pushes (beta track). -- `release.yml` triggers on any other `v*` tag push (stable). - None of these run on plain commits or PRs beyond what's listed. - -## Architecture - -Two binaries + a shared lib: - -| Crate | Role | -|---|---| -| `breadsearch-shared` | XDG paths, config, IPC types, Unix-socket client | -| `breadmill` | Daemon: walk → extract → chunk → embed → index; serves queries | -| `breadsearch` | GTK4 layer-shell overlay: ranked document hits from breadmill | - -breadsearch is document/meaning search. breadbox is the app launcher. They -are not the same overlay. - -`--screenshot` (`breadsearch/src/screenshot.rs`) captures the search panel -through `bread-screenshots`; do not rewrite it just to retarget the crate pin. - -## Don't -- Don't embed credentials in remote URLs — SSH or a credential helper only. -- Don't rewrite `screenshot.rs` as part of pin/docs work.