Skip to content

docs(product-presence): product page, VISION.md, and README#13

Open
Luis85 wants to merge 2 commits into
developfrom
claude/product-page-brief-Gl2yQ
Open

docs(product-presence): product page, VISION.md, and README#13
Luis85 wants to merge 2 commits into
developfrom
claude/product-page-brief-Gl2yQ

Conversation

@Luis85
Copy link
Copy Markdown
Owner

@Luis85 Luis85 commented May 4, 2026

Summary

Delivers all three issue #2 (Product presence) artifacts as a single coherent unit, updated to reflect the current architecture proposal (#14), orchestrator engine design (#43), and actual roadmap phases.

What changed from the original

File Original issues Fixed
README.md Wrong phases ("Phase 1 Core Skeleton" etc.); oversimplified ecosystem diagram; missing SAO Four-project map per #14; correct phases; orchestrator engine concept
VISION.md No SAO non-goal distinction; 12-month success didn't mention automation; no harness framing SAO as separate layer; automation in success criteria; harness language
docs/product-page.md Wrong phases; missing SAO in integration map; RuntimeKernel/EventBus predates ratified API; no permission enforcement in capabilities Updated map with SAO; ratified verbs; permission enforcement; correct phases

Test plan

  • docs/product-page.md passes the cold-reader test — a newcomer can orient within 60 seconds
  • VISION.md can serve as a decision filter — the north star statement is testable against any proposed decision
  • README.md passes the cold-reader test — where it fits, what it does, what the concepts mean, what comes next
  • All three documents use consistent terminology with no contradictions
  • API verbs in docs/product-page.md are consistent with Phase 1 · Architecture proposal v1 — runtime kernel, event bus, and module layout #14's public surface (startSession, runCommand, submitTask, runScript, spawnAgent, bus.subscribe)
  • SAO orchestrator engine mentioned in all three documents
  • Delivery phases match the roadmap in ROADMAP — Specorator Runtime #37
  • Content is coherent with PRD (issue Phase 0 · PRD — Specorator Runtime #1) without duplicating it

Closes #2

https://claude.ai/code/session_017U6JmCXpzcspdtzvck4SsL

Delivers all three issue #2 artifacts:
- docs/product-page.md — hero, problem/solution, capabilities, integration map, roadmap
- VISION.md — why/who/success/non-goals/north star decision filter
- README.md — cold-reader front door with core concepts and delivery plan

These are the source documents for docs/index.html (SPEC-HW-001) and feed
directly into the design consolidation in #4 and the v0.0.1 baseline in #5.

https://claude.ai/code/session_01WzYmom16ifVgSrBRqFwSNE
@Luis85 Luis85 added the roadmap:foundation Phase 0: pre-engineering foundation — PRD, product presence, design workshops, baseline. label May 5, 2026
…ual roadmap phases

- README: four-project system map (per #14), orchestrator engine concept, correct phases
- VISION: add SAO non-goal distinction; 12-month success includes automated dispatch; harness framing
- product-page: updated integration map with SAO, ratified API verbs, correct phase table
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

roadmap:foundation Phase 0: pre-engineering foundation — PRD, product presence, design workshops, baseline.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Phase 0 · Product presence — README, VISION.md, and product page

2 participants