# Knowledge Funnel Demo Bundle

This folder contains a cleaned, static demo package that explains the
Poetry-to-uv migration journey as a layered "knowledge funnel."

The bundle is documentation-only. It does not contain runtime code, secret
material, or environment-specific configuration.

## What this bundle is for

Use this folder when you want to:

1. review the full demo as static artifacts
2. understand how the migration work was condensed into reusable handoff
   materials
3. inspect the cleaned supporting documents behind the HTML narrative

## How to read it

Recommended order:

1. `index.html` — visual landing page for the demo bundle
2. `poetry-to-uv-migration-process-journey.html` — full static journey page
3. `README.md` — this file, for bundle inventory and usage notes
4. supporting Markdown documents, as needed

## Files in this folder

| File | Purpose |
| --- | --- |
| `index.html` | Entry page for the demo bundle. Summarizes the funnel and links to the supporting documents. |
| `poetry-to-uv-migration-process-journey.html` | Main static HTML narrative describing the migration journey from research to reusable artifacts. |
| `poetry-to-uv-migration-process-journey.md` | Markdown mirror of the journey page for easier text review and diffing. |
| `poetry-to-uv-migration-research-2026.html` | Research source document referenced by the narrative and included in the cleaned bundle for context. |
| `poetry-to-uv-migration-session-record.cleaned.md` | Cleaned implementation-session summary describing how the migration skill and related artifacts were produced. |
| `poetry-to-uv-migration-eval-handoff.cleaned.md` | Cleaned eval-handoff document describing the evaluation design and transfer packaging. |
| `README.md` | Bundle guide explaining what each file is for and how to navigate the package. |

## Included vs. referenced artifacts

This folder includes only the files listed above.

The HTML and Markdown narrative may also mention other artifact types such as
`SKILL.md`, `migrate.sh`, `skill-eval.toml`, ZIP bundles, and transfer
manifests. Those are described for context but are not included in this demo
folder unless explicitly listed in the table above.

## Bundle characteristics

- static and self-contained
- cleaned of user-, host-, session-, and secret-specific details
- intended for review, explanation, and handoff