Skip to content

spec(hello-world): GitHub Pages hosting for product page and product demo#9

Open
Luis85 wants to merge 2 commits into
developfrom
claude/define-hello-world-specs-Qy9TU
Open

spec(hello-world): GitHub Pages hosting for product page and product demo#9
Luis85 wants to merge 2 commits into
developfrom
claude/define-hello-world-specs-Qy9TU

Conversation

@Luis85
Copy link
Copy Markdown
Owner

@Luis85 Luis85 commented May 3, 2026

Summary

Adds specs/hello-world/github-pages.md (SPEC-HW-001), updated to align with the ratified event taxonomy, CI gate philosophy, and SAO orchestrator integration.

What changed from the original

Area Original issue Fixed
Event names Used assumed names (workflow.started, agent.invoked, agent.completed, workflow.completed) that don't match the runtime's event model Updated to preliminary names from #15/#21: session.started, agent.spawned, command.dispatched, artifact.created, session.stopped
Event payload No mention of traceId, seq, eventId Each event entry must show eventId, traceId, seq, type
CI design (pages.yml) Flat step list with no gate distinction Hard gates (file existence, HTML validity, no undisclosed external scripts) vs. soft gate (reachability — retry once, advisory failure) per #29
Error messages No format specified Each pages.yml error follows the agent-readable format from #28 (violation + fix instruction + docs link)
Integration map Missing SAO docs/index.html must include SAO orchestrator engine in the integration map
Living-spec notice Not present — demo was implicitly fictional Explicit notice: event names and demo content must be verified against actual examples/hello-world/index.ts output before merge; cross-references to #14, #15, #21 as authoritative sources

Key design principle added

The demo page (docs/demo.html) is a rendered snapshot of a real run, not a fictional example. Event names must match the ratified RuntimeEvent union from #15 §7. This spec will need one final pass after #15 closes to confirm the event table.

Test plan

Relates to #8

https://claude.ai/code/session_017U6JmCXpzcspdtzvck4SsL

…roduct demo

Adds SPEC-HW-001 which formalises the requirement that docs/index.html
(product page) and docs/demo.html (product demo) are delivered as static
HTML files and served via GitHub Pages from the docs/ directory on main.

Covers deliverable content, GitHub Pages configuration, a pages.yml CI
workflow, and acceptance criteria aligned with issue #8.

https://claude.ai/code/session_01AtN6bdu7Gk1Cb13SxZ4RaJ
@Luis85 Luis85 added the roadmap:hello-world v0.1.0 milestone: first end-to-end runtime proof — kernel, event bus, npm package, demo. label May 5, 2026
…my, CI gate policy, and SAO integration map

- Event names updated to match #15/#21 RuntimeEvent union (session.*, agent.spawned, command.dispatched)
- pages.yml redesigned with hard/soft gate split per #29 (existence + HTML validity = hard; reachability = soft with retry)
- Demo content pinned to actual hello-world run output — explicit note to verify against #15 before merge
- Integration map includes SAO orchestrator engine
- Added #14/#15/#21/#29 cross-references for authoritative sources
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

roadmap:hello-world v0.1.0 milestone: first end-to-end runtime proof — kernel, event bus, npm package, demo.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants