What this project has already learned the hard way, and where any new such fact belongs. Two jobs. (1) Routing: this project keeps NO per-project Claude memories — read this before writing anything down, and pick a durable home from the list here. (2) An index, by area, of non-obvious facts worth knowing before you guess: debugging rigs and measurements that lie, iOS/WebKit and the tethered iPhone, the Windows app, production and deployment, and general codebase traps. Use before setting up a browser- or server-driven debugging session, when a bug reproduces only on iPhone, in Safari or in the Windows app, before changing deployment configuration or reading store/crash data, when something behaves unexpectedly and you are about to guess why, and whenever you are tempted to record a fact for later.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
This project — and every ActualChat-* clone or sibling (C1, C2, Marketing, …) — keeps no
per-project Claude memories. Those memory/ directories stay empty. A fact learned here
belongs somewhere durable: checked in, visible to every clone, and readable by Alex.
Ask Alex where it should go, and offer the destinations:
| Destination | For |
|---|---|
areas/*.md here | A project quirk — a couple of sentences, full write-up in references/<area>/ |
docs/CODING_STYLE.md | Anything about how code in this repo should be written |
docs/** | How a subsystem actually behaves (live-video/, live-audio/, ui/, …) |
The owning .claude/commands/*.md or skill | When the fact is really "how to use this tool correctly" |
AGENTS-Source.md | A rule every agent must have in context in every session (then run ai update-md) |
| A GitHub issue | Open follow-up work — not a memory |
~/.claude/CLAUDE.md | Only if it is about Alex or his machine, not about this project |
| Nowhere | A one-off finding about a bug that is already fixed |
Why: Claude memories are per-project-directory and do not cross the Docker (-proj-…) and
Windows (D--Projects-…) views of the same repo, so anything written there is duplicated,
invisible from the other side, and lost to everyone else. Everything above is in git.
Before adding an entry, check it is still true. Several memories migrated here in September 2026 named symbols that no longer existed. An entry that describes code is worth only as much as its last verification.
| Area | What it covers |
|---|---|
| Debugging | Servers and builds, the browser rigs, measurements that lie, calling a running server |
| iOS / WebKit | Driving and profiling the tethered iPhone, channels that lie, Safari, builds and signing |
| Windows | Diagnosing the WinUI/WebView2 app, native stack sampling, echo cancellation |
| Infrastructure | Deployment and Flux, reaching the clusters, the external consoles |
| General | Performance traps and build-tool traps in the codebase itself |
Each area file is a short index; the long write-up for an entry lives in
references/<area>/<name>.md.
Related skills with their own depth: /server-loop, /debug-ui, /virtual-list-debug,
/gcloud-dev-logs, /gcloud-prod-logs, /soniox-sweep, and the user-level /macmini.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Delete the `-bak` backup branches that `/prepare-merge` leaves behind, local and on origin, once the work they back up has merged. Use when the user says "remove my bak branches", "clean up bak branches", "delete the backups", or "/clean-bak-branches".
The English summary is being prepared. Showing the original description.
Use when work on a branch is finished and the next step is a pull request — "create a PR", "open a PR", "push and PR this", "/create-pr" — when a draft PR should be marked ready for review — "mark the PR ready", "undraft it", "it's ready for review" — or right after either has happened and the team has not been told about it yet.
The English summary is being prepared. Showing the original description.
Design a new UI icon in Voxt's style as an SVG and add it to the icon font. Use whenever a new icon is needed and no existing glyph fits — "create an icon", "make an icon for X", "draw an icon", "design an icon", "we need an icon for …", "add an icon", "there is no icon for …", a request for an SVG glyph, or when a feature needs `<i class="icon-…">` and `src/nodejs/icons/` has nothing suitable. Covers matching the existing line width and contoured (not solid) style, the Figma "UI Icons" reference, and regenerating the font. Do not use it to pick an existing icon, or for multi-color art (that is a `.lit.ts` SVG component, see docs/ui/components.md).
The English summary is being prepared. Showing the original description.
Search Google Cloud (GKE) server logs of the DEV environment (dev.voxt.ai). Use when troubleshooting anything that needs the server side of the story — stream stalls, RPC peer changes / reconnects, watchdog closures, mesh/node churn, pod restarts — or when the user says "check GCP logs", "check server logs on dev", or gives a dev.voxt.ai timeline from a client console log.
The English summary is being prepared. Showing the original description.
Search Google Cloud (GKE) server logs of the PROD environment. Use when troubleshooting a production incident that needs the server side of the story — stream stalls, RPC peer changes / reconnects, watchdog closures, mesh/node churn, pod restarts — or when the user says "check PROD logs", "check production server logs", or gives a production timeline from a client console log.
The English summary is being prepared. Showing the original description.
Merge the current release branch forward into `dev` and push `dev`, so fixes committed straight to `release/vX.Y` reach `dev` and the issues their `Closes #N` lines name get closed. Use when the user says "merge release into dev", "merge the release forward", "bring my release fixes to dev", "are my release fixes on dev?", "/merge-release-to-dev", or right after a release fix lands on `release/*`. `--dry-run` only reports what is missing.
The English summary is being prepared. Showing the original description.