Open
Conversation
Reconciles the pv-zcp positioning manifesto and kh-zcp ops manual into a single ZCP docs set. Adds: - /features/coding-agents.mdx — features-page positioning anchor with ZCP MCP vs hosted-service framing, comparison vs Lovable/E2B/Replit/ Codespaces/Cloudflare, capability-by-job table. - /features/local-remote-development.mdx — paired three-modes story (Local+VPN / Cloud IDE on ZCP / Native IDE over SSH). - /zcp/ — 17-page reference subsection: overview, quickstart, glossary, how-it-works, choose-workspace + hosted/local setup, trust-model + tokens + production-policy + auditing, create-or-adopt + build-and- verify + delivery-handoff + package-running, agent-workflow contract reference, troubleshooting. - Mermaid diagrams: where-ZCP-runs architecture, bootstrap-routes decision tree, develop-flow loop, trust-model blast radii. - CustomCard pairs and DocCardList for entry-point pages. Sidebar: new "Zerops Control Plane" subsection under References, between Command Line Tools and Networking. "Infrastructure for Coding Agents" added at the bottom of the Features section. Removes the orphan /guides/local-development.mdx (superseded by /zcp/setup/local-agent-bridge and /features/local-remote-development). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Term discipline pass — Codex-verified across all ZCP pages: - Operational verbs (validates, reads, refuses, exposes, authorizes, picks up, records, enforces) now subject "the MCP" / "ZCP MCP", not bare "ZCP". - Container/wrapper references (token storage, env vars, isolation flags, SSHFS mounts, the thing you add to a project, what you SSH into) now subject "the hosted workspace" or "the `zcp` service". - "ZCP" reserved for the umbrella concept (titles, sidebar label, comparison-section product reference, the kept aphorism). Specific corrections: - VPN reach in local mode — your laptop reaches managed services via VPN; the MCP itself talks to the Zerops API directly. - Agent-workflow Workspace layer — in hosted mode the wrapping service also runs the bundled agent CLI; in local mode the agent runs in your editor and talks to the MCP. - Trust-model isolation flags — `envIsolation: none` / `sshIsolation: vpn service@zcp` are scoped to the `zcp@1` service, not "ZCP itself". - "Where ZCP runs" architecture — hosted on the project network vs local binary talking to the API with VPN as a separate concern. Linking: - features/coding-agents — CustomCard pairs in "Two ways to run it" now link to setup pages directly. MCP-and-permissions cards link to the named tool sections in agent-workflow. Trust model linked inline. Glossary added to the bottom DocCardList. Quickstart promoted from bottom-only to a body mention. - features/local-remote-development — Browser Cloud IDE section links to Provision a hosted workspace; Picking a mode footer links to Choose your workspace; Next steps expanded with hosted-workspace, choose-workspace, glossary. Other: - Public-preview/dev-staging conflation removed across pages — the dev/staging rule is a security principle, independent of preview status. - Recipe-UI gotchas (deploy-button label) cut from quickstart and hosted-workspace — that's Zerops recipe UX, not a ZCP gotcha. - Glossary moved to end of ZCP sidebar. - Sidebar label: "Zerops Control Plane" → "Zerops Control Plane MCP". - Table-balancing CSS extended to /features/coding-agents and /features/local-remote-development. - `zerops.yml` → `zerops.yaml` (canonical). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reconciles the pv-zcp positioning manifesto and kh-zcp ops manual into a single ZCP docs set. Adds:
Sidebar: new "Zerops Control Plane" subsection under References, between Command Line Tools and Networking. "Infrastructure for Coding Agents" added at the bottom of the Features section.
Removes the orphan /guides/local-development.mdx (superseded by /zcp/setup/local-agent-bridge and /features/local-remote-development).
What Type of Change is this?
Description (required)
Related issues & labels (optional)