You are helping the user maintain their knowledge base index.

Task

Update notes/INDEX.md to reflect recent work and maintain organization.

Arguments

If the user provided an action argument (e.g., /update-index consolidate), perform that action directly.

Valid actions:

•experiment - Add a recent experiment
•decision - Add a recent decision
•troubleshooting - Add a troubleshooting guide
•consolidate - Review recent notes and extract patterns
•cleanup - Remove old entries, fix broken links

Steps

•
Read current INDEX.md
- •Check what's already documented
- •Note the last update date
•
Ask what to add Options:
- •"I just finished an experiment" → Add to Recent Activity + All Experiments
- •"I made a decision" → Add to Decisions list
- •"I solved an error" → Add to Known Issues or Troubleshooting
- •"Review recent notes" → Scan notes/ directories and suggest updates
- •"Consolidate findings" → Review multiple experiments and extract patterns
•
For new experiment:
- •Add one-line summary to "Recent Activity"
- •Add to "All Experiments" chronologically
- •If significant: Add to "What Works" or "Known Issues"
- •Include link to actual note file
•
For new decision:
- •Add to "All Decisions" list
- •Add one-line summary with link
- •If it affects current practice: Note in "What Works"
•
For troubleshooting:
- •Add to "Known Issues" if ongoing problem
- •Add to "All Troubleshooting Guides" list
- •Include symptom + link
•
For consolidation:
- •Scan experiments/ for recent notes
- •Extract common patterns
- •Group related findings
- •Update "What Works" summary section
- •Update "Known Issues" summary section
•
Update timestamp
- •Change "Last updated:" to today's date
•
Show changes
- •Display the diff or summarize what was added
- •Ask for confirmation before saving

INDEX.md Structure

markdown

# Project Notes Index

Last updated: YYYY-MM-DD

## Quick Links
- [Current Best Config](../configs/)
- [Quick Reference](quick-reference.md)

## What Works (Summary)
- **Topic**: One-line summary (see experiments/YYYY-MM-DD-file.md)

## Known Issues
- **Issue**: One-line description (see troubleshooting/file.md)

## Recent Activity (Last 7 days)
- YYYY-MM-DD: What happened (link)

## All Experiments
- YYYY-MM-DD: Title - Brief result (path)

## All Decisions
- [Topic](decisions/file.md) - One-line summary

## All Troubleshooting Guides
- [Error Name](troubleshooting/file.md) - Symptom

Smart Consolidation

When user asks to "consolidate" or "review":

•

Scan directories

bash

ls -lt notes/experiments/*.md | head -10
ls -lt notes/decisions/*.md
ls -lt notes/troubleshooting/*.md

•
Read recent files
- •Last 7 days of experiments
- •Any new decisions
- •New troubleshooting guides
•
Extract patterns
- •What worked across multiple experiments?
- •What failed multiple times?
- •Are there contradictions to resolve?
•
Propose updates Show user proposed additions: "I found these patterns from your recent work:

✅ What Works:
- •Learning rate 0.0003 consistently good (3 experiments)
- •4-layer architecture optimal for this task
❌ Known Issues:
- •Batch size >64 causes OOM on RTX 3090
Should I add these to INDEX.md?"

One-Line Summary Guidelines

Good summaries are:

•✅ Specific: "LR=0.0003 optimal for 4-layer model"
•✅ Actionable: "Use batch_size ≤32 to avoid OOM"
•✅ Concise: One line with key metric or finding

Bad summaries:

•❌ Vague: "Tested learning rates"
•❌ Too long: Full paragraph
•❌ No context: "It worked"

Recent Activity Format

Keep last 7-14 days visible:

markdown

## Recent Activity (Last 7 days)
- 2025-01-13: Learning rate sweep - 0.0003 optimal (experiments/2025-01-13-lr-sweep.md)
- 2025-01-12: Architecture comparison - 4 layers best (experiments/2025-01-12-arch.md)
- 2025-01-11: Optimizer test - AdamW > SGD (experiments/2025-01-11-optimizer.md)

Auto-archive older entries to keep this section focused.

After Update

Tell user:

"✅ Updated notes/INDEX.md

📝 Changes:

•Added to Recent Activity: {summary}
•Updated {section}: {what changed}
•Last updated: {today's date}

💡 Your knowledge map is current. I'll reference these findings in future sessions."

Maintenance Mode

If user says "clean up INDEX" or "reorganize":

•Remove entries older than 30 days from "Recent Activity"
•Check for dead links (files that don't exist)
•Alphabetize sections if requested
•Consolidate duplicate entries
•Verify all links work

Error Handling

•If INDEX.md doesn't exist: "Run /setup-notes first"
•If can't parse structure: Offer to rebuild from scratch
•If referenced files missing: Note broken links and ask to fix