Skip to content

Commit 25032b0

Browse files
committed
docs: soften POSITIONING verbatim claim + add token-frugal to PyPI summary
Cross-AI review (Codex P3) caught that .planning/POSITIONING.md claimed 'Use verbatim in: glama.json / server.json' while the actual descriptions deliberately vary by surface (long marketing form vs medium vs PyPI-short). Fix: split into two lists — surfaces that use the sentence verbatim (README hero, GitHub About, launch post, talk bio) vs surfaces that adapt for length but preserve the three key phrases. Also: add 'token-frugal' to pyproject.toml description so all four machine-read positioning surfaces carry the full anchor consistently. Prior Claude reviewer had flagged this as deferrable to PR #3; folding it in here makes POSITIONING.md's new 'preserve all three key phrases' contract internally consistent. Char count: pyproject.toml description = 154 chars (under PyPI's 512 limit). Key-phrase coverage verified: 3 phrases x 4 surfaces = 12/12 present.
1 parent 14adf1c commit 25032b0

2 files changed

Lines changed: 10 additions & 4 deletions

File tree

.planning/POSITIONING.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,17 @@
44

55
> For AI coding agents writing Python, python-docs-mcp-server is the canonical Python stdlib oracle: exact symbols, exact sections, exact versions — offline, **always free, always MIT**, token-frugal.
66
7-
**Use verbatim in:**
7+
**Use verbatim (no rewording) in:**
88

99
- `README.md` hero
10-
- `glama.json` `description`
11-
- `server.json` `description`
1210
- GitHub repo `About` text
1311
- `LAUNCH-POST.md` lede
1412
- Talk bio
13+
14+
**Adapt for length and grammar in (preserve key phrases: `canonical Python stdlib oracle`, `always free, always MIT`, `token-frugal`):**
15+
16+
- `glama.json` `description` — long marketing form (Glama directory display)
17+
- `server.json` `description` — medium form (MCP Registry display)
18+
- `pyproject.toml` `description` — short form (PyPI summary, ≤512 chars)
19+
20+
The locked sentence is the anchor; adapted forms must keep the three key phrases and the wedge claim (canonical / version-aware / offline). They may drop "exact symbols, exact sections, exact versions" for brevity if needed, but never the three anchors above.

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
55
[project]
66
name = "python-docs-mcp-server"
77
version = "0.1.4"
8-
description = "The canonical Python stdlib oracle for AI coding agents — exact symbols, exact sections, exact versions, offline, always free, always MIT."
8+
description = "The canonical Python stdlib oracle for AI coding agents — exact symbols, exact sections, exact versions, offline, always free, always MIT, token-frugal."
99
readme = "README.md"
1010
license = "MIT"
1111
requires-python = ">=3.12"

0 commit comments

Comments
 (0)