Skip to content

What are wiki-doctor's judgment heuristics? #79

Description

@dhague

Child of Wiki Doctor (wayfinder map)

Question

Design the heuristics wiki-doctor's agent uses for judgment cases — the problems a deterministic script can't flag because they require semantic understanding.

Four judgment areas:

  1. Contradiction hygiene — detecting when two pages semantically contradict but lack a contradicts edge. What triggers investigation? (shared tags? overlapping summaries? similar titles?)
  2. Staleness — detecting when a volatile/evolving page's content is out of date. What signals staleness beyond source_date + volatility? (superseded_by edges? contradictions with newer pages?)
  3. Navigation completeness — deciding when a missing bridge page is worth creating. What makes a topic underserved? (orphan pages with no inbound links? tags with many pages but no hub? clusters of related pages with no synthesis?)
  4. Prose quality — deciding when a page's body needs restructuring for brevity/clarity. What makes prose unclear? (excessive length without headings? run-on paragraphs? undefined terms that should link to concept pages?)

For each area, decide: what the agent reads to make the judgment (which script outputs, which page bodies), what the threshold is for proposing action, and what the proposed fix looks like (add an edge, create a page, rewrite text, flag for deletion).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions