Add Highlight

Add Highlight

Add a notable item to the public highlights (What's New) page.

When to Use

• After writing a new article worth sharing
• When research reveals something interesting
• When a review finds a significant insight
• Any time something is worth publicising
• Manual invocation: /add-highlight [topic]

Instructions

1. Check Rate Limit

Use the CLI to check if we can add today:

uv run python scripts/highlights.py check

Only 1 highlight per day is allowed. If already added today, skip silently and note in output that a highlight was already added.

2. Compose Highlight

Determine the content:

• Title: Short, engaging (5-10 words). Should make someone want to click.
• Description: 1-2 sentences explaining what's new or interesting. Max 280 characters (Twitter-ready).
• Type: One of:
  • new-article - A new piece of content was created
  • insight - An interesting finding from review or analysis
  • research - Research notes or discoveries
  • refinement - Significant improvement to existing content
• Link: Wikilink to the relevant content (e.g., [[hard-problem-of-consciousness]])

3. Add via CLI

uv run python scripts/highlights.py add "Title Here" "Description of what's interesting, max 280 chars." --type new-article --link "[[article-name]]"

4. Post to Twitter (Optional)

If Twitter is configured (credentials in .env), add the --tweet flag:

uv run python scripts/highlights.py add "Title" "Description" --type new-article --link "[[article]]" --tweet

To test formatting without posting:

uv run python scripts/highlights.py add "Title" "Description" --type new-article --link "[[article]]" --tweet --dry-run

Note: Twitter posting is optional. If credentials aren't configured, the highlight is added and a warning is logged. Twitter failures never block highlight creation.

5. Verify Addition

The CLI will confirm success or report rate limiting.

Content Guidelines

Good highlights are:

• Genuinely interesting to a general audience
• Understandable without deep context
• Engaging enough to click through
• Connected to The Unfinishable Map's philosophical mission

Skip these (not highlight-worthy):

• Routine maintenance (validate-all, check-links)
• Minor refinements with no new insight
• Failed or blocked tasks
• Internal workflow changes

Examples

New Article

uv run python scripts/highlights.py add \
  "Why Materialism Can't Explain Consciousness" \
  "New article argues that all forms of materialism fail to account for subjective experience. The hard problem isn't just unsolved—it may be unsolvable in principle." \
  --type new-article \
  --link "[[materialism]]"

Research Insight

uv run python scripts/highlights.py add \
  "Buddhist Perspectives Challenge Western Assumptions" \
  "Research into Buddhist philosophy reveals that the self-consciousness problem looks different from a tradition that questions the self's existence entirely." \
  --type research \
  --link "[[buddhist-perspectives-meaning]]"

Review Finding

uv run python scripts/highlights.py add \
  "Decoherence Timescales Present Real Challenge" \
  "Pessimistic review identified that quantum decoherence in warm brains happens in femtoseconds—nine orders of magnitude faster than neural processes." \
  --type insight \
  --link "[[consciousness-selecting-neural-patterns]]"

Integration with /evolve

The /evolve skill automatically considers adding a highlight at the end of each session. You don't need to manually call /add-highlight after evolve—it handles this.

Important

• Max 280 characters for descriptions (Twitter-ready for future integration)
• Max 1 highlight per day (enforced by the manager)
• Always use wikilinks for the link field
• Skip routine maintenance - only highlight interesting work
• The highlights page auto-trims to 20 items