---
id: 11728
title: Day-0 executable cloud-deployment tutorial
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
assignees:
  - neo-gpt
createdAt: '2026-05-21T17:24:59Z'
updatedAt: '2026-05-22T10:06:01Z'
githubUrl: 'https://github.com/neomjs/neo/issues/11728'
author: neo-opus-ada
commentsCount: 1
parentIssue: 11720
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-22T10:06:01Z'
---
# Day-0 executable cloud-deployment tutorial

## Context

Sub **F2** of Epic #11720 (Cloud Agent OS Deployment Readiness). **MVP-critical** — it is the reproducibility proof: a future agent/operator must follow it without tacit maintainer knowledge.

## The Problem

Guides + `DeploymentCookbook.md` exist, but there is no narrow **executable day-0 tutorial** that walks an external workspace through the deployment + adoption ladder. A guide explains the system; a tutorial is prescriptive, linear, executable — that artifact is missing.

## The Fix

Author a new markdown tutorial artifact (under `learn/agentos/cloud-deployment/` or a sibling tutorial path per the D0 docs taxonomy): a linear, executable day-0 walkthrough of the adoption ladder — runnable remote-MCP SSE healthcheck demo → MC connection → KB connection over the Neo-shared corpus → tenant ingestion → one client-side parser → bulk / volume-gate path → backup/redeploy check. Exact commands, config snippets, **expected outputs**, and common **failure signatures**. Scoped to "something that works" for the PoC — NOT a comprehensive guide rewrite.

## Acceptance Criteria

- [ ] A new day-0 tutorial markdown artifact exists, aligned to the adoption-ladder milestones (0–7).
- [ ] Linear + executable: exact commands, config snippets, expected outputs, failure signatures.
- [ ] Validated — a fresh agent/operator can follow it to a working PoC without tacit maintainer knowledge.

## Out of Scope

- `DeploymentCookbook.md` realignment (Sub F1).
- A comprehensive guide rewrite — this is a narrow first-run tutorial.

## Related

Parent #11720 · pairs with Sub F1 · adoption ladder = Origin Discussion #11718 §8 · Origin Discussion #11718 §5 Sub F2.

## Origin Session ID

`8e1dc8ca-b5a5-4479-b3cf-31918eb4a5b2`

## Timeline

- 2026-05-21T17:25:00Z @neo-opus-ada added the `documentation` label
- 2026-05-21T17:25:00Z @neo-opus-ada added the `enhancement` label
- 2026-05-21T17:25:01Z @neo-opus-ada added the `ai` label
- 2026-05-21T17:27:34Z @neo-opus-ada added parent issue #11720
- 2026-05-21T17:32:55Z @neo-gpt cross-referenced by #11720
- 2026-05-21T17:50:38Z @neo-gpt cross-referenced by #11729
- 2026-05-21T18:40:36Z @neo-gpt cross-referenced by #11730
- 2026-05-21T18:42:59Z @neo-opus-ada cross-referenced by #11735
- 2026-05-21T20:28:25Z @neo-gpt cross-referenced by PR #11737
- 2026-05-21T22:29:15Z @neo-gpt cross-referenced by PR #11742
- 2026-05-22T02:19:05Z @neo-gpt cross-referenced by #11743
- 2026-05-22T02:41:25Z @neo-gpt cross-referenced by #11744
- 2026-05-22T07:04:28Z @neo-gpt cross-referenced by PR #11745
- 2026-05-22T07:57:08Z @neo-gpt cross-referenced by PR #11749
- 2026-05-22T08:49:52Z @neo-gpt cross-referenced by PR #11751
- 2026-05-22T09:02:06Z @neo-gpt assigned to @neo-gpt
- 2026-05-22T09:18:13Z @neo-gpt cross-referenced by PR #11753
- 2026-05-22T09:58:01Z @tobiu referenced in commit `46b3848` - "docs(agentos): add day-0 cloud deployment tutorial (#11728) (#11753)

Co-authored-by: tobiu <tobiasuhlig78@gmail.com>"
### @neo-gpt - 2026-05-22T10:05:57Z

**Input from GPT-5.5 (Codex Desktop):**

> ● Closeout / rescope correction:
> 
> #11728 is the tutorial ticket. PR #11753 is merged and delivered the day-0 tutorial artifact plus the tutorial-facing validation: adoption-ladder alignment, exact commands/config snippets, expected outputs, failure signatures, discoverability links, markdown-link checks, JSON-fence parsing, and `learn/tree.json` parse validation.
> 
> I had left #11728 open because the PR body named the Docker-capable fresh-run proof as residual. That was over-broad for this ticket. Treating Docker proof or new unit-test coverage as a closure requirement here would scope-creep the tutorial lane. Those belong in #11725 or a fresh follow-up if more proof substrate is needed.
> 
> Verdict: #11728 is complete as the tutorial artifact lane and can close as completed.

- 2026-05-22T10:06:01Z @neo-gpt closed this issue
- 2026-05-22T10:13:02Z @neo-gpt cross-referenced by PR #11756
- 2026-05-22T10:25:50Z @neo-gpt cross-referenced by PR #11758

