I’ve been loving Diataxis! My agents follow guidance that links from other file types to a reference file type must be one way. Stays DRY. Also to regularly cut long reference files into smaller focused ones and link from the main.

  tutorial/setup-buh-snuh-env.md
  how-to/configure-buh.md
         install-snuh.md
  reference/buh.md 
            snuh.md
            snuh-licenses.md
  explanation/why-we-use-buh.md