diff --git a/.agents/skills/docs-voice/SKILL.md b/.agents/skills/docs-voice/SKILL.md index d02f4f8..521b7f9 100644 --- a/.agents/skills/docs-voice/SKILL.md +++ b/.agents/skills/docs-voice/SKILL.md @@ -77,6 +77,12 @@ was rejected) and the "when **not** to use it" anti-pitch — keep both. a `.codemap/index.db` rebuild are the trigger for `minor`; everything else (additive CLI, public types, docs) is `patch`. - **Brand one-liner** (memorable beat, not hype): "Query your codebase." + Home title / OG: `Codemap — Query your codebase.` +- **Site / OG / npm description** (never lead with the brand one-liner): + "Local codebase intelligence for AI agents — a SQLite index of symbols, + imports, and calls. SQL and recipes instead of scanning the tree." + Same string in `blume.config.ts`, `package.json`, and the homepage Hero sub; + README may expand after the bold one-liner. - **Category label** (what it is — pair with the brand beat, then the mechanism): "local codebase intelligence" / "codebase intelligence tool". Same breath as SQLite / SQL / recipes — never as a standalone slogan. diff --git a/.changeset/og-meta-copy.md b/.changeset/og-meta-copy.md new file mode 100644 index 0000000..35ee124 --- /dev/null +++ b/.changeset/og-meta-copy.md @@ -0,0 +1,5 @@ +--- +"@stainless-code/codemap": patch +--- + +Stop repeating the brand one-liner in site, OG, and npm descriptions. diff --git a/README.md b/README.md index 6c26c75..56cf0c0 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Codemap -**Query your codebase.** Local codebase intelligence for AI agents — a SQLite index of structural metadata (symbols, imports, exports, components, dependencies, CSS tokens, markers, and more) so agents and tools answer “where / what / who” with **SQL** instead of scanning the tree. +**Query your codebase.** Local codebase intelligence for AI agents — a SQLite index of symbols, imports, calls, and more structural metadata so agents answer “where / what / who” with **SQL** and recipes instead of scanning the tree. - **Not** grep by default — use ripgrep / your IDE for raw text. Opt-in FTS5 (`--with-fts` / `fts5: true`) when body matches need to JOIN with structure. - **Is** a fast, token-efficient way to navigate **structure**. diff --git a/apps/docs/blume.config.ts b/apps/docs/blume.config.ts index daa9a40..8f0fd7e 100644 --- a/apps/docs/blume.config.ts +++ b/apps/docs/blume.config.ts @@ -6,11 +6,13 @@ const title = "Codemap"; /** Custom `.astro` pages have no frontmatter — name OG cards (else humanized segment). */ const homeTitle = `${title} — Query your codebase.`; const notFoundTitle = "Page not found"; +/** Capacity pitch — do not lead with the brand one-liner (docs-voice). */ +const description = + "Local codebase intelligence for AI agents — a SQLite index of symbols, imports, and calls. SQL and recipes instead of scanning the tree."; export default defineConfig({ title, - description: - "Query your codebase — local codebase intelligence for AI agents", + description, logo: { image: "/logo.svg", text: "Codemap" }, diff --git a/apps/docs/pages/_home/Hero.astro b/apps/docs/pages/_home/Hero.astro index 005f83b..71cfd59 100644 --- a/apps/docs/pages/_home/Hero.astro +++ b/apps/docs/pages/_home/Hero.astro @@ -14,8 +14,8 @@ import { cliSnippet } from "./source-snippets.ts";
- Local codebase intelligence: a SQLite index of symbols, imports, and calls — - SQL and recipes for agents, not another grep pass. + Local codebase intelligence for AI agents — a SQLite index of symbols, + imports, and calls. SQL and recipes instead of scanning the tree.
{/* Blume CodeBlock fills the column — shrink-wrap like InstallBox. */} diff --git a/package.json b/package.json index c71c8e2..d9df2a8 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@stainless-code/codemap", "version": "0.11.3", - "description": "Query your codebase — local codebase intelligence for AI agents", + "description": "Local codebase intelligence for AI agents — a SQLite index of symbols, imports, and calls. SQL and recipes instead of scanning the tree.", "keywords": [ "agents", "ai",