Surface Scope Policy
This document classifies intentionally shipped feature surfaces for launch-readiness, clarifying what is core, advanced, hidden, and deferred.
Current Launch Surface Classification
| Surface | Status | Public pitch | Notes |
|---|---|---|---|
| REST/OpenAPI + QAnstitution + Hurl + CI reports | core | Primary | Primary shipped story and default value proposition. |
entroping studio (read-only) |
advanced-but-supported | Excluded | Local read-only inspection path for reports, latest-run state, and redaction summaries. It is deliberately optional and stays secondary to CLI and reports. |
WireMock mappings (freeze --mock) |
advanced-but-supported | Excluded | Useful for component testing when upstream dependencies are costly or flaky. Supported, documented, and optional. |
Dependency maps (map --export) |
advanced-but-supported | Qualified visual evidence | Useful visual evidence for observed service calls and launch assets. Supported and tested, but not the primary value proposition. |
| GraphQL example fixtures | hidden-example | Excluded | Helpful internal validation example, but not a primary launch competency. |
| SOAP example fixtures | hidden-example | Excluded | Kept for compatibility exploration and internal reuse, but not part of the primary launch story. |
Operational Rule
- Core surfaces are what first-time users should read about in
READMEand MkDocs first-hour docs. - Advanced-but-supported surfaces are shipped, documented, and tested, but described as optional. They may appear in demos or launch assets when they clarify value, but they should not displace the core README pitch.
- Public pitch records whether a supported surface belongs in first-hour public copy, gets only qualified visual-evidence treatment, or stays excluded from the README pitch.
- Hidden examples are kept in-repo for internal continuity, validation, and future expansion, but are intentionally not the main onboarding story.
- Deferred/Removed status is only used when a surface is out of scope for the current release lane and is tracked from GitHub Issues and ROADMAP.
Implementation Pointers
- Surface decision references:
docs/technical/COMMAND_CHEAT_SHEET.mdlists command visibility.docs/technical/CLI_COMPATIBILITY_AUDIT.mdrecords the compatibility contract.README.mdanddocs/index.mdkeep the first-hour story focused.ROADMAP.mdkeeps sequencing, not deep rationale.