spec: archive refactor-docs-onboarding spec

Author: estebanjosse

…ges/refactor-docs-onboarding/proposal.md …-08-refactor-docs-onboarding/proposal.mdopenspec/changes/refactor-docs-onboarding/proposal.md renamed to openspec/changes/archive/2026-02-08-refactor-docs-onboarding/proposal.md openspec/changes/refactor-docs-onboarding/proposal.md renamed to openspec/changes/archive/2026-02-08-refactor-docs-onboarding/proposal.md

@@ -0,0 +1,27 @@
+# developer-docs Specification
+
+## Purpose
+TBD - created by archiving change refactor-docs-onboarding. Update Purpose after archive.
+## Requirements
+### Requirement: Onboarding Landing Page
+The repository SHALL provide a root-level README focused on onboarding new users by summarizing prerequisites, installation steps, configuration, and quick start instructions for both stdio and HTTP hosts while deferring deep-dive content.
+
+#### Scenario: Quick start guidance
+- **GIVEN** a developer unfamiliar with the template
+- **WHEN** they open the root README
+- **THEN** they can identify prerequisites, installation commands, configuration notes, and execution steps for stdio and HTTP hosts within the primary sections.
+
+### Requirement: Dedicated Documentation Directory
+The repository SHALL expose detailed architecture, capability, and operations information via markdown files stored under a docs/ directory instead of embedding them in the root README.
+
+#### Scenario: Sectional documentation discovery
+- **WHEN** a user navigates into docs/
+- **THEN** they find separate markdown files covering architecture overview, feature and capability reference, and operational procedures.
+
+### Requirement: Cross-linked Documentation Navigation
+The onboarding README SHALL link to the corresponding docs/ pages so that advanced readers can access deep-dive material directly from the landing page.
+
+#### Scenario: README deep dive handoff
+- **WHEN** the README references architecture, capabilities, or operations
+- **THEN** it provides hyperlinks to the associated docs/ files located under docs/.
+