Imported from boredsort/diseases-and-medicines (AGENTS.md). Install upstream with npx skills add boredsort/diseases-and-medicines. Copyright stays with the author.

AGENTS.md

Project Purpose

This project is a structured, evidence-informed encyclopedia of diseases comparing:

• Western Medicine
• Traditional Chinese Medicine (TCM)
• Naturopathy

All entries must be supported by credible sources whenever possible.

Canonical content lives in diseases/<category>/<disease-name>.md.

Your Role (Codex)

You are responsible for:

• Generating disease entries using TEMPLATE.md
• Attaching appropriate references
• Ensuring consistency and accuracy
• Avoiding unsupported claims

Evidence Rules (CRITICAL)

1. Western medicine sections SHOULD include supporting references and are expected to be the most citation-dense part of each entry.

2. Prefer high-quality sources:

   • Clinical guidelines (WHO, CDC, NIH, NICE)
   • Peer-reviewed journals (PubMed, Cochrane)
   • Medical textbooks

3. For TCM:

   • Use classical texts, recognized TCM textbooks, or modern TCM clinical research

4. For Naturopathy:

   • Use systematic reviews, WHO herbal monographs, NIH/ODS or NCCIH supplement references, recognized herbal databases, or reputable materia medica/textbooks

5. Avoid source slant:

   • Do not rely only on sources that are primarily dismissive of TCM or naturopathy
   • Do not rely only on promotional or advocacy sources either
   • Prefer system-specific sources for TCM and naturopathy sections, while avoiding Western-clinical framing as the main voice of those sections

6. Filtering standard by medical system:

   • Western sections remain the strictest evidence filter and should prioritize guideline- and review-level support for clinical claims.
   • TCM and naturopathy sections may use a broader evidence base and may include well-known traditional-use claims from recognized traditional references even when modern clinical-trial evidence is limited.
   • Traditional-use claims in TCM and naturopathy should be written as traditionally used for... or commonly used for... language, not as guaranteed outcomes.
   • Strong safety warnings, contraindications, and strong efficacy claims should still be traceable to a source whenever possible.

Source Hierarchy (Priority Order)

1. Systematic reviews / meta-analyses
2. Clinical guidelines (WHO, CDC, NIH)
3. Peer-reviewed journal articles
4. Academic textbooks
5. Reputable medical websites (Mayo Clinic, NHS)

For TCM and naturopathy sections, also prioritize:

• Classical texts and recognized training texts for system description
• WHO traditional medicine publications where relevant
• WHO monographs on selected medicinal plants
• NIH Office of Dietary Supplements resources
• Recognized herbal references and materia medica

Citation Requirements

• Use numbered references: [1], [2], [3]
• Place citations at the end of bullet points or sections
• Include full references in the "References" section
• Western sections should usually have denser inline citation use
• TCM and naturopathy sections may use lighter inline citation density
• For TCM and naturopathy, it is acceptable for some routine traditional descriptions to rely on books, monographs, or standard system references listed in the "References" section even when every single bullet is not individually cited
• For TCM and naturopathy, inclusion is allowed even when evidence is primarily traditional-use literature, provided the source is identifiable and the claim wording does not overstate certainty
• Strong safety claims, strong efficacy claims, or unusual claims should still be traceable to a source when possible

Prohibited Actions

• Do NOT fabricate references
• Do NOT cite unknown or unverifiable sources
• Do NOT claim a guaranteed “cure” without strong support
• Do NOT present traditional-use claims as proven cures when evidence is limited or mixed
• Do NOT mix medical systems in explanations
• Do NOT erase the distinction between Western, TCM, and naturopathic ways of describing illness

Output Requirements

Each file must:

• Follow TEMPLATE.md strictly
• Use the canonical path and naming rules in CONTENT_STRUCTURE.md
• Follow LANGUAGE_RULES.md for tone and sentence style by medical system
• Use TCM_SOURCE_CANON.md and NATUROPATHY_SOURCE_CANON.md as preferred source and style anchors for traditional-system sections
• Include Scientific/medical name and Alternative name (Tagalog) near the top
• Include a Related Diseases section with internal links when related entries exist
• Include a "References" section
• Use consistent citation format
• Be valid Markdown

Validation Checklist

• All sections present
• References included
• No fabricated sources
• Consistent formatting
• TCM section names actual patterns or formula logic
• Naturopathy section gives concrete foods, herbs, or preparation examples

File and Naming Rules

• One disease per file
• Use lowercase kebab-case file names:
  • asthma.md
  • migraine.md
• Place each file under its primary category folder:
  • diseases/respiratory/asthma.md
  • diseases/neurological/migraine.md
• Use the disease's standard English clinical name as the H1 title in the file