Skip to content

Rebrand canonical tagline to the deterministic merge gate#156

Merged
pengfei-threemoonslab merged 3 commits into
mainfrom
claude/condescending-gould-78096b
May 31, 2026
Merged

Rebrand canonical tagline to the deterministic merge gate#156
pengfei-threemoonslab merged 3 commits into
mainfrom
claude/condescending-gould-78096b

Conversation

@pengfei-threemoonslab
Copy link
Copy Markdown
Contributor

Summary

  • Brand-wide canonical-tagline replacement — Local-first, static Tool-Use Readiness release gate for AI agent tool surfacesThe deterministic merge gate for AI-generated agent capability changes (the "Merge Gate" repositioning). Atomic across every contract-enforced surface (tests/test_public_surface_contract.py) plus all remaining repo-wide occurrences. Engine/logic unchanged — copy and positioning only.
  • README gains a hero headline ("Your coding agent changed what your AI agent can do — Agents Shipgate tells you whether it can merge."), a local-first/static trust sub-line, and a verify-first quickstart; the design-partner CTA is reframed to "bring us one AI-generated PR."
  • Kept "Tool-Use Readiness" as the category/wedge and the "Tool-Use Readiness Report" artifact name — only the one-sentence tagline changed. The standalone category phrase "Tool-Use Readiness release gate" intentionally stays.

Reviewer notes:

  • Generated surfaces were regenerated from source, not hand-edited: the four block renderers + adoption-kits/*/SKILL.md.cursor/rules/agents-shipgate.mdc, both committed SKILL.md copies, the slash command, and benchmark templates. SHA snapshots in tests/test_agent_instructions_renderers.py and prior_render_sha256 in the kit metadata were bumped accordingly.
  • The report/packet disclaimer copy embeds the tagline, so all samples/*/expected/{report.md,packet.md,packet.json,packet.html} goldens were regenerated via run_scan (byte-exact to the golden tests). No schema version change.
  • llms-full.txt regenerated via scripts/build-llms-full.py.
  • Release vehicle (v0.11 minor vs v1.0) is a separate decision and is not part of this PR.

Type

  • Check or risk-model change
  • Input adapter change
  • CLI or GitHub Action behavior — --help / scan docstring copy only
  • Report, schema, or SARIF output — report/packet disclaimer copy only (no schema change)
  • Documentation only — not only docs; also touches CLI help + report copy

Verification

CI is authoritative for python -m ruff check ., python -m compileall -q src tests, and python -m pytest.

Additional local checks run:

  • python -m pytest2368 passed, 4 skipped, 0 failed
  • python -m pytest tests/test_public_surface_contract.py (brand enforcer) → green
  • python scripts/generate_schemas.py --check → clean
  • python -m ruff check . → clean
  • Repo-wide sweep for the old tagline sentence → 0 occurrences

Release-readiness notes

  • No user-code import added to default scan paths
  • No network access added to default scan paths
  • New or changed check IDs are documented in docs/checks.md — N/A (no check changes)
  • Report/schema changes are additive or documented in STABILITY.md — disclaimer copy only; report/packet schema versions unchanged

🤖 Generated with Claude Code

pengfei-threemoonslab and others added 3 commits May 31, 2026 10:18
Replace the old canonical tagline "Local-first, static Tool-Use Readiness
release gate for AI agent tool surfaces" with "The deterministic merge gate
for AI-generated agent capability changes" (the "Merge Gate" repositioning),
atomically across every contract-enforced public surface plus all remaining
repo-wide occurrences. No engine/logic change — copy and positioning only.

- Update POSITIONING_PHRASE / POSITIONING_SCAN_DOCSTRING (atomic enforcer)
- Static surfaces: README hero (new headline + tagline + local-first/static
  trust sub-line + verify-first quickstart), AGENTS.md, pyproject, action.yml,
  .well-known (tagline + positioning.answer), llms.txt, docs/* positioning pages
- Generated sources + regenerated outputs: CLI help, scan docstring, the four
  block renderers + adoption-kit SKILL.md; report/packet disclaimers; cursor
  rule, both committed SKILL.md copies, slash command, benchmark templates,
  llms-full.txt; bumped renderer SHA snapshots + kit prior_render hashes
- Regenerated all sample report/packet goldens (disclaimer text changed)
- Kept "Tool-Use Readiness" as the category/wedge/report-artifact name
- Off-list cleanup: engineering verifier guide, SEO/GEO review, use-case page,
  onboarding prompt; design-partner CTA reframed to "bring us one AI-generated PR"

Verified: pytest 2368 passed / 4 skipped, generate_schemas --check clean,
ruff clean, zero residual old-tagline.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…r local

The verify-first quickstart framed the PR case but showed the local
(no --base/--head) form, which scans the head workspace without PR diff
context — so capability-diff and trust-root signals can be missing. Show the
`--base origin/main --head HEAD` form for committed PR/CI refs (matching the
AGENTS.md / trigger guidance) and reserve the no-base/--head form for local
uncommitted work.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…l.txt

Note in the canonical-tagline directive that the website's `.well-known`
discovery file is pinned to the latest released tag and refreshes at each
release (closes a reviewer question about external surfaces not yet matching
the new tagline). Regenerate llms-full.txt since AGENTS.md is one of its
sources.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@pengfei-threemoonslab pengfei-threemoonslab merged commit 7ff223a into main May 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant