Skip to content

docs: position self-hosted/deploy as Early access (in testing) for launch (ACE-064) - #126

Merged
ashwin-agami merged 2 commits into
mainfrom
ACE-064-self-host-early-access-positioning
Jul 13, 2026
Merged

ashwin-agami merged 2 commits into
mainfrom
ACE-064-self-host-early-access-positioning

Conversation

@ashwin-agami

Copy link
Copy Markdown
Contributor

Spec: ACE-064 · docs/positioning only — no code or behavior change.

Summary

For the public launch, lead with the local single-player experience and mark the self-hosted/deploy path (the /agami-deploy skill + HTTP MCP team server) as "Early access (in testing)" — usable today, newer than the local path, feedback via GitHub issues. The deploy capability is untouched; the skill still ships and works. Raising this for wording review — please read the copy before we merge.

Changes

  • README hero → local-only. Removed the self-host Docker badge, the "Want your team on it? Deploy a shared server" intro bullet, and the deploy link from the top nav line. The top of the README now reads local-first.
  • One labeled section. The old "Deploy a shared server for your team" section is now "Self-hosted team server — Early access (in testing)" with an early-access callout (usable today · newer than local · file a GitHub issue for feedback). The "What you get" team bullet, the /agami-deploy skills-table row, and the doc-nav link are all tagged (early access — in testing) and point to it.
  • Canonical callout at the very top of deploy/README.md — the single source of the wording; other surfaces link here.
  • Docs labeled/linked: docs/open-vs-hosted.md, docs/privacy.md, docs/self-hosting.md.
  • Skill + install: a light early-access note in the agami-deploy SKILL.md description (body untouched); a note under the install "skills available" list (the literal output is unchanged — the label is prose beneath it).
  • Marketplace metadata unchanged.claude-plugin/marketplace.json and plugin.json already lead local-first and don't promote deploy, so nothing to relabel.

Verification (docs-only, no unit tests)

  • README hero contains no deploy badge/bullet/nav; exactly one self-hosting section, labeled.
  • Every in-scope deploy/self-host mention carries the label or links to the deploy/README.md callout.
  • In-page anchor #self-hosted-team-server--early-access-in-testing matches the heading's GitHub slug; all added links resolve.
  • git diff touches only 7 files; CHANGELOG.md, SECURITY.md, packages/agami-core/README.md unchanged.
  • uv run dev.py check green (ruff + full suite + gitleaks); a review agent confirmed link integrity, label consistency, and no contradictions.

Checklist

  • uv run dev.py check green
  • Links/anchors verified; label consistent everywhere
  • Customer-safety: no customer names, no real contact email (feedback → GitHub issues), no secrets
  • Out-of-scope files (CHANGELOG/SECURITY/packages README) untouched; no code change
  • Human wording review + approval ← this PR is up for that

Out of scope

  • The launch blog post (GTM repo); any change to deploy code/behavior; relabeling historical CHANGELOG/SECURITY; the eventual GA flip.
  • The README "Fair-code vs hosted" section (licensing boundary, not deploy promotion) — left as-is; happy to fold in an early-access nod if you want.

…or launch

Public launch leads with the local single-player experience; the self-hosted team
server (the /agami-deploy skill + HTTP MCP server) is marked Early access (in testing) —
usable today, newer than the local path, feedback via GitHub issues. No code/behavior change.

- README: remove self-host Docker badge + team intro bullet + hero nav from the hero
  (top now reads local-only); one labeled 'Self-hosted team server — Early access (in
  testing)' section; skills-table row + What-you-get bullet + doc-nav tagged early-access
- deploy/README.md: canonical Early-access callout at the top (single source of wording)
- docs/open-vs-hosted, docs/privacy, docs/self-hosting: labeled / linked to the callout
- agami-deploy SKILL.md description: early-access note; install page: note under the skills list
- marketplace.json / plugin.json: unchanged (already local-first, no deploy promotion)

Spec: ACE-064
Copilot AI review requested due to automatic review settings July 13, 2026 12:24

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates public-facing documentation to position the local single-player workflow as the primary launch experience, while labeling the self-hosted/team deploy workflow as Early access (in testing). It does not change any runtime behavior or deployment capability.

Changes:

  • Removes deploy/self-hosting promotion from the README hero area and reframes the top-level “next steps” as local-only.
  • Relabels the self-hosted/team server surfaces (README section + docs references + install note + skill description) as early access and centralizes the wording in deploy/README.md.
  • Adds/updates early-access callouts and links across relevant docs pages.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
README.md Removes deploy promo from the hero and relabels the self-hosted section as early access.
plugins/agami/skills/agami-deploy/SKILL.md Adds an early-access disclaimer to the skill’s description metadata.
docs/self-hosting.md Adds an early-access callout pointing readers to the deploy README canonical note.
docs/privacy.md Labels the team server section as early access and adds a short disclaimer + feedback link.
docs/open-vs-hosted.md Marks /agami-deploy as early access and links to the canonical deploy note.
docs/install/claude-code-cli.md Adds an install-time early-access note for agami-deploy.
deploy/README.md Adds the canonical early-access callout at the top of the deploy guide.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
@ashwin-agami

Copy link
Copy Markdown
Contributor Author

Thanks @copilot — fixed: added the relative pronoun so it reads 'self-host one governed server that your whole team … query'.

@ashwin-agami
ashwin-agami merged commit f77a88e into main Jul 13, 2026
7 checks passed
@ashwin-agami
ashwin-agami deleted the ACE-064-self-host-early-access-positioning branch July 13, 2026 12:35
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 13, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants