4 added, 4 removed. Audit A to A.
---
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
---
# /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., `cite`, `argue`, `data`, `method`).
+ - 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 |
|--------|--------|-----|-----|-----|-----|-----|-----|-----|-----|
- | Bennett (2010) | integrated | | argue | argue | | | | | |
- | Goodman (1968) | integrated | cite | argue | argue | cite | | | | |
- | Hui (2017) | completed | | | argue | | | cite | | cite |
+ | Bennett (2010) | integrated | | supports | supports | | | | | |
+ | Goodman (1968) | integrated | extends | supports | supports | extends | | | | |
+ | Hui (2017) | 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.