claude-plugins/fiction-assistance/commands/generate/update-links.md

description, allowed-tools

description	allowed-tools
Update cross-reference links in generated files	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.