Skip to content

Commit 9628e23

Browse files
mcp-tool-shopclaude
mcp-tool-shop
and
claude
committed
data: seed tool, audiences, campaign, and index
Adds zip-meta-map as the seed tool with: - 5 proven claims (deterministic output, 246 tests, CI gating, token budgets, schema validation) - 1 aspirational claim (sub-second builds) - 3 anti-claims (not code search, not vuln scanning, not LLM-specific) - 5 messages across web/readme/hn/x/linkedin, all tracing to claims - 2 audiences: CI maintainers and LLM toolchain devs - 1 campaign: zmm-launch with 3 phases Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent f588b2d commit 9628e23

5 files changed

Lines changed: 210 additions & 0 deletions

File tree

‎marketing/data/audiences/ci-maintainers.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
{
2+
"schemaVersion": "1.0.0",
3+
"id": "aud.ci-maintainers",
4+
"name": "CI/CD Maintainers",
5+
"description": "Engineers who own CI pipelines and care about build reproducibility, PR gating, and pipeline trust.",
6+
"painPoints": [
7+
"No confidence that repo metadata is fresh or accurate after merges",
8+
"PR reviews lack machine-readable context about what changed structurally",
9+
"Build artifacts drift silently — same repo, different metadata depending on when you run",
10+
"Hard to enforce metadata quality gates without custom scripting"
11+
]
12+
}

‎marketing/data/audiences/llm-toolchain-devs.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
{
2+
"schemaVersion": "1.0.0",
3+
"id": "aud.llm-toolchain-devs",
4+
"name": "LLM Toolchain Developers",
5+
"description": "Developers building AI agents and LLM-powered tools that need structured repo context under token budgets.",
6+
"painPoints": [
7+
"LLM agents waste tokens on irrelevant files when given raw directory listings",
8+
"No standard format for repo structure that LLMs can consume efficiently",
9+
"Token budget overruns when context windows are limited",
10+
"Manual curation of repo maps doesn't scale across projects"
11+
]
12+
}

‎marketing/data/campaigns/zmm-launch.json‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
{
2+
"schemaVersion": "1.0.0",
3+
"id": "camp.zip-meta-map.launch",
4+
"name": "zip-meta-map Launch",
5+
"toolRef": "tool.zip-meta-map",
6+
"audienceRefs": [
7+
"aud.ci-maintainers",
8+
"aud.llm-toolchain-devs"
9+
],
10+
"phases": [
11+
{
12+
"name": "Soft launch",
13+
"channels": ["readme", "web"],
14+
"messageRefs": [
15+
"msg.zip-meta-map.readme-snippet",
16+
"msg.zip-meta-map.web-blurb"
17+
],
18+
"notes": "Get the tool page and README polished before any external promotion."
19+
},
20+
{
21+
"name": "Community launch",
22+
"channels": ["hn", "x"],
23+
"messageRefs": [
24+
"msg.zip-meta-map.hn-post",
25+
"msg.zip-meta-map.x-post"
26+
],
27+
"notes": "HN Show + X post. Time for weekday morning US-East."
28+
},
29+
{
30+
"name": "Professional outreach",
31+
"channels": ["linkedin"],
32+
"messageRefs": [
33+
"msg.zip-meta-map.linkedin-post"
34+
],
35+
"notes": "LinkedIn post targeting engineering leaders and DevOps."
36+
}
37+
]
38+
}

‎marketing/data/marketing.index.json‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{
2+
"schemaVersion": "1.0.0",
3+
"tools": [
4+
{ "ref": "tools/zip-meta-map.json" }
5+
],
6+
"audiences": [
7+
{ "ref": "audiences/ci-maintainers.json" },
8+
{ "ref": "audiences/llm-toolchain-devs.json" }
9+
],
10+
"campaigns": [
11+
{ "ref": "campaigns/zmm-launch.json" }
12+
]
13+
}

‎marketing/data/tools/zip-meta-map.json‎

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
{
2+
"schemaVersion": "1.0.0",
3+
"id": "tool.zip-meta-map",
4+
"name": "zip-meta-map",
5+
"positioning": {
6+
"oneLiner": "Make repos and ZIPs self-describing for LLMs with CI-grade diffs.",
7+
"valueProps": [
8+
"Deterministic index: same repo produces the same output, every time",
9+
"Token-budgeted LLM plans: structured context that fits in context windows",
10+
"CI gating with diff --exit-code: fail builds when metadata drifts",
11+
"JSON Schema-validated output with 246 tests backing correctness"
12+
]
13+
},
14+
"audienceRefs": [
15+
"aud.ci-maintainers",
16+
"aud.llm-toolchain-devs"
17+
],
18+
"claims": [
19+
{
20+
"id": "claim.zip-meta-map.deterministic-output",
21+
"status": "proven",
22+
"statement": "Given the same repository state, zip-meta-map produces byte-identical index output.",
23+
"evidenceRefs": ["ev.zip-meta-map.deterministic-test.v1"]
24+
},
25+
{
26+
"id": "claim.zip-meta-map.246-tests",
27+
"status": "proven",
28+
"statement": "The test suite contains 246 passing tests covering CLI, schema validation, and diff behavior.",
29+
"evidenceRefs": ["ev.zip-meta-map.test-suite.v1"]
30+
},
31+
{
32+
"id": "claim.zip-meta-map.ci-gating",
33+
"status": "proven",
34+
"statement": "zip-meta-map diff --exit-code returns non-zero when metadata drifts, suitable for CI gating.",
35+
"evidenceRefs": ["ev.zip-meta-map.ci-step-summary.v1"]
36+
},
37+
{
38+
"id": "claim.zip-meta-map.token-budgets",
39+
"status": "proven",
40+
"statement": "LLM plans respect configurable token budgets, producing structured context that fits within specified limits.",
41+
"evidenceRefs": ["ev.zip-meta-map.build-screenshot.v1"]
42+
},
43+
{
44+
"id": "claim.zip-meta-map.schema-validated",
45+
"status": "proven",
46+
"statement": "All output conforms to a published JSON Schema, validated in CI on every commit.",
47+
"evidenceRefs": ["ev.zip-meta-map.test-suite.v1"]
48+
},
49+
{
50+
"id": "claim.zip-meta-map.sub-second-builds",
51+
"status": "aspirational",
52+
"statement": "Typical repo builds complete in under one second on commodity hardware.",
53+
"notes": "Anecdotally true but not yet benchmarked with reproducible methodology."
54+
}
55+
],
56+
"antiClaims": [
57+
{
58+
"statement": "Does not replace code search or embeddings — it complements them with structural metadata."
59+
},
60+
{
61+
"statement": "Does not perform runtime vulnerability scanning — heuristic flagging is advisory, not CVE-grade."
62+
},
63+
{
64+
"statement": "Does not require or assume any specific LLM provider — output is plain JSON consumable by any tool."
65+
}
66+
],
67+
"messages": [
68+
{
69+
"id": "msg.zip-meta-map.web-blurb",
70+
"channel": "web",
71+
"tone": "pragmatic",
72+
"text": "zip-meta-map makes repos self-describing for LLMs. Deterministic builds, token-budgeted plans, and CI gating with 246 tests backing every claim.",
73+
"claimRefs": [
74+
"claim.zip-meta-map.deterministic-output",
75+
"claim.zip-meta-map.token-budgets",
76+
"claim.zip-meta-map.ci-gating",
77+
"claim.zip-meta-map.246-tests"
78+
],
79+
"constraints": { "maxChars": 280 }
80+
},
81+
{
82+
"id": "msg.zip-meta-map.readme-snippet",
83+
"channel": "readme",
84+
"tone": "technical",
85+
"text": "Build a self-describing index of any repo or ZIP. JSON Schema-validated output, configurable LLM token budgets, and diff --exit-code for CI gating. 246 tests. Deterministic.",
86+
"claimRefs": [
87+
"claim.zip-meta-map.schema-validated",
88+
"claim.zip-meta-map.token-budgets",
89+
"claim.zip-meta-map.ci-gating",
90+
"claim.zip-meta-map.246-tests",
91+
"claim.zip-meta-map.deterministic-output"
92+
]
93+
},
94+
{
95+
"id": "msg.zip-meta-map.hn-post",
96+
"channel": "hn",
97+
"tone": "technical",
98+
"text": "Show HN: zip-meta-map — deterministic repo indexes for LLM agents. Same repo = same output, diffable in CI, token budgets for context windows. 246 tests, JSON Schema-validated, pip install zip-meta-map.",
99+
"claimRefs": [
100+
"claim.zip-meta-map.deterministic-output",
101+
"claim.zip-meta-map.ci-gating",
102+
"claim.zip-meta-map.token-budgets",
103+
"claim.zip-meta-map.246-tests",
104+
"claim.zip-meta-map.schema-validated"
105+
],
106+
"constraints": { "maxChars": 300, "notes": "HN title should be separate and under 80 chars." }
107+
},
108+
{
109+
"id": "msg.zip-meta-map.x-post",
110+
"channel": "x",
111+
"tone": "pragmatic",
112+
"text": "zip-meta-map: make any repo self-describing for LLMs. Deterministic output, token budgets, CI gating. 246 tests. pip install zip-meta-map",
113+
"claimRefs": [
114+
"claim.zip-meta-map.deterministic-output",
115+
"claim.zip-meta-map.token-budgets",
116+
"claim.zip-meta-map.ci-gating",
117+
"claim.zip-meta-map.246-tests"
118+
],
119+
"constraints": { "maxChars": 280 }
120+
},
121+
{
122+
"id": "msg.zip-meta-map.linkedin-post",
123+
"channel": "linkedin",
124+
"tone": "executive",
125+
"text": "We built zip-meta-map to solve a specific problem: LLM agents need structured repo context, but directory listings waste tokens and drift silently. Our approach is deterministic indexes with CI gating — same repo, same output, every time. 246 tests enforce it.",
126+
"claimRefs": [
127+
"claim.zip-meta-map.deterministic-output",
128+
"claim.zip-meta-map.token-budgets",
129+
"claim.zip-meta-map.ci-gating",
130+
"claim.zip-meta-map.246-tests"
131+
],
132+
"constraints": { "maxChars": 700 }
133+
}
134+
]
135+
}

0 commit comments

Comments
 (0)