map

/map — Literature-Thesis Mapping Skill

Purpose

Build and display a mapping matrix showing which literature sources support which thesis chapters. Identify coverage gaps where chapters lack sufficient source support.

Trigger Words

This skill activates on: map, show mapping, coverage, which sources, /map.

Workflow

1. Scan all notes files in literature/reading_notes/ using Glob (*_NOTES.md). For each file, extract:

   • Author and title (from the # Reading Notes: heading)
   • Status field value
   • Relevance field value
   • All rows from the ## Thesis Connections table

2. Scan chapter files in chapters/ to get the list of chapters and their section headings.

3. Build the mapping matrix. Rows are sources (sorted alphabetically by author), columns are chapters (Ch1 through Ch8 or however many exist).

   • Mark each cell with the connection type if a mapping exists (e.g., supports, challenges, extends).
   • Leave cells empty if no connection.

4. Identify coverage gaps. Flag any chapter that has fewer than 3 mapped sources as "under-covered".

5. Add the progress dashboard. Count chapter words deterministically with wc -w chapters/*.md (never estimate word counts by reading), compare against the per-chapter targets in CLAUDE.md, and count notes files by Status value (reading / completed / integrated).

6. Output the mapping and dashboard.

Output Format

## Literature-Thesis Mapping -- {YYYY-MM-DD}

### Matrix

| Source | Status | Ch1 | Ch2 | Ch3 | Ch4 | Ch5 | Ch6 | Ch7 | Ch8 |
|--------|--------|-----|-----|-----|-----|-----|-----|-----|-----|
| Smith (2024) | integrated | | supports | supports | | | | | |
| Jones (2021) | integrated | extends | supports | supports | extends | | | | |
| Lee (2019) | completed | | | supports | | | challenges | | challenges |

### Coverage Summary

| Chapter | Mapped Sources | Status |
|---------|---------------|--------|
| Ch1 | {N} | OK / Under-covered |
| Ch2 | {N} | OK / Under-covered |

### Under-covered Chapters

{List chapters with < 3 sources, with suggestions for which completed-but-not-yet-mapped notes might fill the gap.}