90 lines
4.1 KiB
Markdown
90 lines
4.1 KiB
Markdown
|
---
|
||
|
|
description: Update cross-reference links in generated files
|
||
|
|
allowed-tools: Edit(40 - Generated/**), MultiEdit(40 - Generated/**)
|
||
|
|
---
|
||
|
|
You are maintaining cross-reference links across all generated writer's cards.
|
||
|
|
|
||
|
|
**OBJECTIVE**: Scan all files in `40 - Generated/` and `00 - Manuscript/` to create a comprehensive cross-referencing system with proper wiki-style links.
|
||
|
|
|
||
|
|
## Process:
|
||
|
|
|
||
|
|
1. **Inventory all generated files** in `40 - Generated/*/` subdirectories
|
||
|
|
2. **Identify all entities** (characters, locations, ships, technology, species, plotlines, themes, conflicts, events)
|
||
|
|
3. **Update each generated card** to include proper wiki-style links to related entities
|
||
|
|
|
||
|
|
IMPORTANT: DO NOT UPDATE MANUSCRIPT CHAPTERS OR WORLD BIBLE FILES. Only files inside `40 - Generated/` should be edited, though _destinations_ can be outside that.
|
||
|
|
|
||
|
|
## Link Rules:
|
||
|
|
|
||
|
|
### Wiki-Style Linking Format:
|
||
|
|
- Use `[[filename.md|Display Name]]` for first mentions
|
||
|
|
- Use `[[filename.md]]` for subsequent mentions if the filename matches the display name
|
||
|
|
- Always use the actual filename, not aliases
|
||
|
|
|
||
|
|
### What to Link:
|
||
|
|
- **Characters** → Link to other characters, locations, ships, events, conflicts they're involved in
|
||
|
|
- **Locations** → Link to characters present, events that occurred there, related locations
|
||
|
|
- **Ships** → Link to crew members, captains, locations visited, events involving the ship
|
||
|
|
- **Technology** → Link to users, related tech, events where it's significant
|
||
|
|
- **Species** → Link to known individuals, their technology, locations they inhabit
|
||
|
|
- **Plotlines** → Link to key characters, events, conflicts, themes they explore
|
||
|
|
- **Themes** → Link to characters who embody them, events that illustrate them
|
||
|
|
- **Conflicts** → Link to participants, locations where they occur, events that escalate them
|
||
|
|
- **Events** → Link to participants, locations, ships present, technologies used
|
||
|
|
|
||
|
|
### Link Placement:
|
||
|
|
- **Frontmatter lists**: Use links in YAML values and arrays where appropriate
|
||
|
|
- **First mentions**: Always link the first time an entity is mentioned in content
|
||
|
|
- **Section headers**: Don't link section headers themselves
|
||
|
|
- **Context-appropriate**: Only link when the connection adds value
|
||
|
|
|
||
|
|
## File Processing:
|
||
|
|
|
||
|
|
For EACH file in `40 - Generated/`:
|
||
|
|
|
||
|
|
1. **Read the current content**
|
||
|
|
2. **Identify missing or broken links**
|
||
|
|
3. **Add appropriate wiki-style links** for:
|
||
|
|
- Names in frontmatter (appearances, relationships, characters_involved, etc.)
|
||
|
|
- First mentions of entities in the content
|
||
|
|
- Related entities in dedicated relationship sections
|
||
|
|
4. **Fix broken links** where files have been renamed or moved
|
||
|
|
5. **Remove links to non-existent files**
|
||
|
|
|
||
|
|
## Cross-Reference Opportunities:
|
||
|
|
|
||
|
|
### High-Value Links to Add:
|
||
|
|
- Character relationships and family connections
|
||
|
|
- Location hierarchies (rooms within ships, planets within systems)
|
||
|
|
- Technology dependencies and related systems
|
||
|
|
- Species and their known individuals
|
||
|
|
- Events and their participants/locations
|
||
|
|
- Plotlines and the characters/events that drive them
|
||
|
|
- Conflicts and all involved parties
|
||
|
|
- Themes and the characters/events that explore them
|
||
|
|
|
||
|
|
### Frontmatter Link Fields:
|
||
|
|
Update these frontmatter fields with proper links:
|
||
|
|
- `appearances: [chapter, files]`
|
||
|
|
- `characters_involved: [character, files]`
|
||
|
|
- `relationships: [character, files]`
|
||
|
|
- `related_plotlines: [plotline, files]`
|
||
|
|
- `locations: [location, files]`
|
||
|
|
- `crew: [character, files]`
|
||
|
|
- `known_individuals: [character, files]`
|
||
|
|
- And similar relationship fields
|
||
|
|
|
||
|
|
## Quality Requirements:
|
||
|
|
|
||
|
|
- **Only link to files that actually exist**
|
||
|
|
- **Use consistent display names** (match the entity's canonical name)
|
||
|
|
- **Don't over-link** - first mention and contextually important references only
|
||
|
|
- **Preserve existing content** - only add links, don't change the prose
|
||
|
|
- **Maintain proper formatting** - don't break existing markdown structure
|
||
|
|
|
||
|
|
## Output:
|
||
|
|
|
||
|
|
Update each file with improved cross-referencing, ensuring the entire `40 - Generated/` collection becomes a well-linked knowledge graph for the Universalis story world.
|
||
|
|
|
||
|
|
**IMPORTANT**: Always verify file existence before creating links. Use the actual filenames from the filesystem, not assumed names.
|