Map

---
name: map
description: Show or update the mapping between literature and thesis chapters — which sources support which arguments. Use for tracking coverage.
allowed-tools: Read, Glob, Grep, Edit, Write
---

# /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. **Output the mapping.**

## 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.}
```

## Saving the Matrix

If the user says "save" or "export mapping", write the matrix to `literature/mapping_matrix.md` using Edit (if the file exists) or Write (if creating new). Include a timestamp header.

## Gap Threshold

- **Under-covered**: fewer than 3 mapped sources per chapter.
- This threshold can be adjusted if the user specifies a different minimum.

## Constraints

1. **Read-only by default.** Only modify files if the user explicitly asks to save the matrix.
2. **No emoji** in output.
3. **No hardcoded chapter count.** Detect chapters dynamically from the `chapters/` directory.
4. **Source names** use the format `{Author} ({Year})` for readability.
5. **Connection types** are derived from the `Connection Type` column in notes files. If that column is missing, infer from the `Relevance` field.