docs: Add implementation plan for neighbourhood dashboard transition

- Create comprehensive transition plan (Change-Toronto-Analysis-Reviewed.md)
  covering cleanup, new data pipeline, dbt restructuring, and dashboard tabs
- Update CLAUDE.md to reflect current app structure (Sprint 8 pages)
- Add reference to new documentation in CLAUDE.md
- Update import examples from TRREB to neighbourhood-based
- Mark legacy docs as being replaced
- Add Jupyter notebook requirements (one per graph with data reference)
- Add CRITICAL rule: NEVER delete development branch

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

CLAUDE.md

@@ -6,8 +6,9 @@ Working context for Claude Code on the Analytics Portfolio project.
 
 ## Project Status
 
-**Current Sprint**: 7 (Navigation & Theme Modernization)
-**Phase**: 1 - Toronto Housing Dashboard
+**Current Sprint**: 8 (Portfolio Website Expansion - Complete)
+**Next Sprint**: 9 (Neighbourhood Dashboard Transition)
+**Phase**: Transitioning to Toronto Neighbourhood Dashboard
 **Branch**: `development` (feature branches merge here)
 
 ---
@@ -33,7 +34,10 @@ make ci             # Run all checks
 1. Create feature branch FROM `development`: `git checkout -b feature/{sprint}-{description}`
 2. Work and commit on feature branch
 3. Merge INTO `development` when complete
-4. `development` -> `staging` -> `main` for releases
+4. Delete the feature branch after merge (keep branches clean)
+5. `development` -> `staging` -> `main` for releases
+
+**CRITICAL: NEVER DELETE the `development` branch. It is the main integration branch.**
 
 ---
 
@@ -43,8 +47,8 @@ make ci             # Run all checks
 
 | Context | Style | Example |
 |---------|-------|---------|
-| Same directory | Single dot | `from .trreb import TRREBParser` |
-| Sibling directory | Double dot | `from ..schemas.trreb import TRREBRecord` |
+| Same directory | Single dot | `from .neighbourhood import NeighbourhoodRecord` |
+| Sibling directory | Double dot | `from ..schemas.neighbourhood import CensusRecord` |
 | External packages | Absolute | `import pandas as pd` |
 
 ### Module Responsibilities
@@ -53,7 +57,7 @@ make ci             # Run all checks
 |-----------|----------|---------|
 | `schemas/` | Pydantic models | Data validation |
 | `models/` | SQLAlchemy ORM | Database persistence |
-| `parsers/` | PDF/CSV extraction | Raw data ingestion |
+| `parsers/` | API/CSV extraction | Raw data ingestion |
 | `loaders/` | Database operations | Data loading |
 | `figures/` | Chart factories | Plotly figure generation |
 | `callbacks/` | Dash callbacks | In `pages/{dashboard}/callbacks/` |
@@ -101,18 +105,43 @@ portfolio_app/
 ├── app.py                    # Dash app factory with Pages routing
 ├── config.py                 # Pydantic BaseSettings
 ├── assets/                   # CSS, images (auto-served)
+│   └── sidebar.css          # Navigation styling
+├── callbacks/               # Global callbacks
+│   ├── sidebar.py           # Sidebar toggle
+│   └── theme.py             # Dark/light theme
 ├── pages/
 │   ├── home.py              # Bio landing page -> /
+│   ├── about.py             # About page -> /about
+│   ├── contact.py           # Contact form -> /contact
+│   ├── health.py            # Health endpoint -> /health
+│   ├── projects.py          # Project showcase -> /projects
+│   ├── resume.py            # Resume/CV -> /resume
+│   ├── blog/
+│   │   ├── index.py         # Blog listing -> /blog
+│   │   └── article.py       # Blog article -> /blog/{slug}
 │   └── toronto/
-│       ├── dashboard.py     # Layout only -> /toronto
-│       └── callbacks/       # Interaction logic
-├── components/              # Shared UI (navbar, footer, cards)
+│       ├── dashboard.py     # Dashboard -> /toronto
+│       ├── methodology.py   # Methodology -> /toronto/methodology
+│       └── callbacks/       # Dashboard interactions
+├── components/              # Shared UI (sidebar, cards, controls)
+│   ├── metric_card.py       # KPI card component
+│   ├── map_controls.py      # Map control panel
+│   ├── sidebar.py           # Navigation sidebar
+│   └── time_slider.py       # Time range selector
 ├── figures/                 # Shared chart factories
+│   ├── choropleth.py        # Map visualizations
+│   ├── summary_cards.py     # KPI figures
+│   └── time_series.py       # Trend charts
+├── content/                 # Markdown content
+│   └── blog/                # Blog articles
 ├── toronto/                 # Toronto data logic
 │   ├── parsers/
 │   ├── loaders/
 │   ├── schemas/             # Pydantic
-│   └── models/              # SQLAlchemy
+│   ├── models/              # SQLAlchemy
+│   └── demo_data.py         # Sample data
+├── utils/                   # Utilities
+│   └── markdown_loader.py   # Markdown processing
 └── errors/
 ```
 
@@ -121,7 +150,15 @@ portfolio_app/
 | URL | Page | Sprint |
 |-----|------|--------|
 | `/` | Bio landing page | 2 |
-| `/toronto` | Toronto Housing Dashboard | 6 |
+| `/about` | About page | 8 |
+| `/contact` | Contact form | 8 |
+| `/health` | Health endpoint | 8 |
+| `/projects` | Project showcase | 8 |
+| `/resume` | Resume/CV | 8 |
+| `/blog` | Blog listing | 8 |
+| `/blog/{slug}` | Blog article | 8 |
+| `/toronto` | Toronto Dashboard | 6 |
+| `/toronto/methodology` | Dashboard methodology | 6 |
 
 ---
 
@@ -249,9 +286,20 @@ All scripts in `scripts/`:
 | Document | Location | Use When |
 |----------|----------|----------|
 | Full specification | `docs/PROJECT_REFERENCE.md` | Architecture decisions |
-| Data schemas | `docs/toronto_housing_dashboard_spec_v5.md` | Parser/model tasks |
-| WBS details | `docs/wbs_sprint_plan_v4.md` | Sprint planning |
+| Data schemas (legacy) | `docs/toronto_housing_dashboard_spec_v5.md` | Reference only - being replaced |
+| WBS details (legacy) | `docs/wbs_sprint_plan_v4.md` | Reference only - being replaced |
+| **Neighbourhood Dashboard Vision** | `docs/changes/Change-Toronto-Analysis.md` | New dashboard specification |
+| **Implementation Plan** | `docs/changes/Change-Toronto-Analysis-Reviewed.md` | Sprint planning, cleanup tasks |
 
 ---
 
-*Last Updated: Sprint 7*
+## Pending Transition
+
+**Note**: This project is transitioning from a TRREB district-based housing dashboard to a comprehensive Toronto Neighbourhood Dashboard (158 neighbourhoods). See the Implementation Plan for details on:
+- Files being deprecated (TRREB parsers, schemas, loaders)
+- New data sources (Toronto Open Data, Toronto Police, CMHC APIs)
+- New dashboard tabs (Overview, Housing, Safety, Demographics, Amenities)
+
+---
+
+*Last Updated: Sprint 8*