web/docs/platform-spec-alignment-review.md

45 lines
1.9 KiB
Markdown

# Platform Spec Alignment Review
## Sources Referenced
- `/Users/vsg/Documents/VSG Codex/kernel/docs/architecture/PRODUCT_ARCHITECTURE.md`
- `/Users/vsg/Documents/VSG Codex/kernel/docs/architecture/REPO_TOPOLOGY_25Y.md`
- `/Users/vsg/Documents/VSG Codex/platform-docs/business/38_license_model.md` (noted as potentially legacy relative to latest direction)
## Alignment Summary
The revised web copy is aligned with core platform direction on:
1. Deterministic governance as primary execution/control model.
2. Layered architecture where intelligence is optional augmentation.
3. Local-first durability and operational resilience framing.
4. Open/closed boundary discipline (no disclosure of private kernel internals).
5. Wallet-first identity continuity aligned with licensing architecture direction.
6. Membership-gated commerce model separated from product entitlement rights.
## Resolved Conflicts from Initial Web Draft
1. Ownership/IP overstatement removed.
- Previous copy implied full source-code transfer in all cases.
- Revised copy now uses contractual-boundary language.
2. Crypto exclusion statement removed.
- Previous copy categorically denied crypto association.
- Revised copy avoids hard claims that can conflict with evolving licensing rails.
3. Secret system spec correctness fixed.
- Mailgun signing verification now references signing key.
- Failure handling now avoids silent acceptance on processing failure.
## Deliberate Neutrality Choices
To avoid drift between evolving licensing specs and public marketing:
- No fixed pricing is stated.
- No hard commitment to one entitlement unit (per-human vs per-device) is stated on landing page.
- No claim is made that requires publishing proprietary module/kernel implementation details.
## Recommendation
Treat this web repo as the public narrative layer, and keep constitutional licensing/mechanics claims anchored in dedicated legal and contract documents as those finalize.