docs: move component analysis docs into CONTRIBUTOR-DOCS

Author: rise-erpelding

CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/01_status.md

@@ -1,6 +1,47 @@
+<!-- Generated breadcrumbs - DO NOT EDIT -->
+
+[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / Spectrum 2 migration roadmap
+
+<!-- Document title (editable) -->
+
 # Spectrum 2 migration roadmap
 
-This directory contains comprehensive migration documentation for 2nd generation Spectrum Web Components based on the implementation of Spectrum 2 components that were previously migrated in [Spectrum CSS](https://github.com/adobe/spectrum-css/tree/spectrum-two). It helps engineers understand what needs to be implemented, updated, or aligned between the two systems to guide development of 2nd generation web components.
+<!-- Generated TOC - DO NOT EDIT -->
+
+<details open>
+<summary><strong>In this doc</strong></summary>
+
+- [Purpose](#purpose)
+    - [Why we do this analysis](#why-we-do-this-analysis)
+    - [The bigger picture](#the-bigger-picture)
+- [What we analyze](#what-we-analyze)
+    - [Component specifications](#component-specifications)
+    - [DOM structure comparison](#dom-structure-comparison)
+    - [CSS to SWC mapping](#css-to-swc-mapping)
+    - [Implementation gaps](#implementation-gaps)
+- [Documentation structure](#documentation-structure)
+- [How to generate documentation](#how-to-generate-documentation)
+    - [Prerequisites](#prerequisites)
+    - [Using the cursor prompt](#using-the-cursor-prompt)
+    - [Quality assurance](#quality-assurance)
+    - [Common issues to watch for](#common-issues-to-watch-for)
+- [Contributing](#contributing)
+    - [Modifying the cursor prompt](#modifying-the-cursor-prompt)
+    - [Adding new components](#adding-new-components)
+- [Resources](#resources)
+
+</details>
+
+<details open>
+<summary><strong>Beneath this doc</strong></summary>
+
+- [Spectrum Migration Documentation Prompt](cursor_prompt.md)
+
+</details>
+
+<!-- Document content (editable) -->
+
+This step contains comprehensive migration documentation for 2nd generation Spectrum Web Components based on the implementation of Spectrum 2 components that were previously migrated in [Spectrum CSS](https://github.com/adobe/spectrum-css/tree/spectrum-two). It helps engineers understand what needs to be implemented, updated, or aligned between the two systems to guide development of 2nd generation web components.
 
 ## Purpose
 
@@ -131,7 +172,7 @@ Set up a Cursor workspace with both repositories:
 
 **Model recommendation**: This type of detailed migration analysis is better handled by slower but more advanced thinking models like Claude or GPT-5, which can provide more thorough analysis and better understand complex component relationships.
 
-1. **Load the prompt**: Reference `migration-roadmap/cursor_prompt.md`
+1. **Load the prompt**: Reference `cursor_prompt.md` in this step folder
 2. **Specify component**: Replace `[COMPONENT_NAME]` with the target component
 3. **Branch verification**: Ensure correct branches are checked out:
     - `spectrum-css`: `spectrum-two` for specifications, both `main` and `spectrum-two` for comparisons
@@ -170,9 +211,9 @@ The cursor prompt template (`cursor_prompt.md`) can be modified to improve AI pe
 ### Adding new components
 
 1. Use the cursor prompt with the target component name
-2. Generate the markdown file in `migration-roadmap/[component-name].md`
+2. Generate the markdown file in `CONTRIBUTOR-DOCS/03_project-planning/03_components/[component-name]/rendering-and-styling-migration-analysis.md`
 3. Review and validate all sections for accuracy
-4. Submit a PR to the `2nd-gen-component-analysis` branch
+4. Submit a PR
 
 ## Resources
 

migration-roadmap/README.md …_analyze-rendering-and-styling/README.mdmigration-roadmap/README.md renamed to CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/README.md migration-roadmap/README.md renamed to CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/README.md

@@ -1,5 +1,28 @@
+<!-- Generated breadcrumbs - DO NOT EDIT -->
+
+[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / [Spectrum 2 migration roadmap](README.md) / Spectrum Migration Documentation Prompt
+
+<!-- Document title (editable) -->
+
 # Spectrum Migration Documentation Prompt
 
+<!-- Generated TOC - DO NOT EDIT -->
+
+<details open>
+<summary><strong>In this doc</strong></summary>
+
+- [File Organization](#file-organization)
+- [Component Documentation Structure](#component-documentation-structure)
+    - [1. Component Specifications](#1-component-specifications)
+    - [2. Comparison](#2-comparison)
+    - [3. Summary of changes](#3-summary-of-changes)
+    - [4. Resources section](#4-resources-section)
+- [Output format notes](#output-format-notes)
+
+</details>
+
+<!-- Document content (editable) -->
+
 For the **[COMPONENT_NAME]** component(s), create comprehensive migration documentation in individual markdown files within the `migration-roadmap/` directory of the spectrum-web-components repository, following this exact structure:
 
 **IMPORTANT**: All files must be created on the original spectrum-web-components branch where the session started.
@@ -8,8 +31,8 @@ For the **[COMPONENT_NAME]** component(s), create comprehensive migration docume
 
 - **One markdown file per component**
 - Use the component/package name from the spectrum-web-components repository:
-- File path format: `migration-roadmap/[COMPONENT_NAME].md`
-- Example: `migration-roadmap/alert-banner.md`, `migration-roadmap/dialog.md`
+- File path format: `CONTRIBUTOR-DOCS/03_project-planning/03_components/[component-name]/rendering-and-styling-migration-analysis.md`
+- Example: `CONTRIBUTOR-DOCS/03_project-planning/03_components/alert-banner/rendering-and-styling-migration-analysis.md`, `.../dialog/rendering-and-styling-migration-analysis.md`
 
 ## Component Documentation Structure
 

migration-roadmap/cursor_prompt.md …e-rendering-and-styling/cursor_prompt.mdmigration-roadmap/cursor_prompt.md renamed to CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/cursor_prompt.md migration-roadmap/cursor_prompt.md renamed to CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/cursor_prompt.md

@@ -13,12 +13,13 @@
 
 - [Status](01_status.md)
 - Step By Step
-    - [Factor rendering out of 1st-gen component](02_step-by-step/01_factor-rendering-out-of-1st-gen-component.md)
-    - [Move base class to 2nd-gen core](02_step-by-step/02_move-base-class-to-2nd-gen-core.md)
-    - [Formalize Spectrum data model](02_step-by-step/03_formalize-spectrum-data-model.md)
-    - [Add 2nd-gen SWC component](02_step-by-step/04_implement-2nd-gen-component.md)
-    - [Migrate rendering & styles from Spectrum CSS](02_step-by-step/05_migrate-rendering-and-styles.md)
-    - [Add stories for 2nd-gen component](02_step-by-step/06_add-stories-for-2nd-gen-component.md)
+    - [Spectrum 2 migration roadmap](02_step-by-step/01_analyze-rendering-and-styling/README.md)
+    - [Factor rendering out of 1st-gen component](02_step-by-step/02_factor-rendering-out-of-1st-gen-component.md)
+    - [Move base class to 2nd-gen core](02_step-by-step/03_move-base-class-to-2nd-gen-core.md)
+    - [Formalize Spectrum data model](02_step-by-step/04_formalize-spectrum-data-model.md)
+    - [Add 2nd-gen SWC component](02_step-by-step/05_implement-2nd-gen-component.md)
+    - [Migrate rendering & styles from Spectrum CSS](02_step-by-step/06_migrate-rendering-and-styles.md)
+    - [Add stories for 2nd-gen component](02_step-by-step/07_add-stories-for-2nd-gen-component.md)
 
 </details>