The guide has always been the first thing to read here and the last thing that actually gets read. It lived in AGENTS.md, with CLAUDE.md holding a single line pointing at it, and a pointer is a step somebody has to decide to take. What is skipped along with it are the rules that cannot be derived from the code: finished work is committed and pushed to main rather than offered, a commit message on the default branch is published on a page anyone can load, and the two Live Activity extensions must never share a derived data path. So the guide is CLAUDE.md now, which loads by itself, and AGENTS.md is the pointer for whoever looks for that name instead. The text is unchanged apart from the paragraph that described the old arrangement. Nothing is duplicated: a second copy drifts from the first, which is the whole reason the pointer existed. The two nested guides move the same way, and every link, README line, source comment and hook message naming the old path follows. One of those links was also aimed at an anchor that had been renamed out from under it.
643 B
643 B
FTStore — project guide for AI agents
The guide lives in CLAUDE.md, next to this file. Read it before
making changes: it is the canonical guide for any agent working here, not a
Claude-specific one, and it covers the monorepo layout, the brand constants, the
release tags, the fact that every commit message on main is published, and the
GPL-3.0 obligations.
It sits under that name because Claude Code loads it on its own, and a guide
nobody opens is a guide nobody follows. This file is the pointer for the agents
that look for AGENTS.md instead. Keep every rule in CLAUDE.md, so there is
one source of truth.