wos-research

name: wos-research description: Researches Whiteout Survival game data from verified tiered sources. Use when looking up building costs, troop stats, hero info, chief gear, war academy, or any game mechanics. Automatically selects the best source based on topic and applies confidence levels. allowed-tools: WebFetch(domain:www.whiteoutsurvival.wiki), WebFetch(domain:whiteoutsurvival.fandom.com), WebFetch(domain:whiteoutsurvival.app), WebFetch(domain:whiteoutdata.com), WebFetch(domain:www.quackulator.com), WebFetch(domain:onechilledgamer.com), WebFetch(domain:www.allclash.com), WebFetch(domain:www.bluestacks.com), WebFetch(domain:lootbar.gg), WebFetch(domain:www.ajackof.com), WebSearch, Read, Write, Glob

WoS Research - Tiered Source Registry

Design Principle

Use official/structured sources for mechanics & costs, community tools for tables/calculators, content creators only for meta (explicitly labeled).

Research Rules (MUST FOLLOW)

1. Mechanics > Meta: If Wiki contradicts community guide, Wiki wins
2. Tables > Advice: If a calculator table exists, use it instead of prose
3. Meta must be labeled: Community/meta claims must have claim_type: meta and confidence_cap: C
4. Cost data requires a table: Never guess costs from text descriptions

Source Tiers

Tier 1 - Highest Trust (trust: 1.0)

Use for mechanics, rules, skill descriptions, system definitions.

Wiki wins over all other sources if conflict exists.

Tier 2 - Structured Calculators (trust: 0.85-0.9)

Use for cost tables and structured data.

Tier 3 - Community Meta (trust: 0.6)

ALWAYS tag output as claim_type: meta and cap confidence at C.

Tier 4 - Early Detection Only (trust: 0.4)

Never emit without at least one stronger source.

• Reddit/Discord/Facebook - Use only for early patch detection, edge cases

Topic → Best Source Mapping

Local Data - Check FIRST

Before fetching external sources, check if data already exists:

data/upgrades/buildings.edges.json      - Building L1-L30 (261 edges, 9 buildings)
data/upgrades/buildings.fc.edges.json   - Building FC levels (313 edges, 7 buildings)
data/upgrades/chief_gear.steps.json     - Chief gear costs (83 edges)
data/upgrades/war_academy.steps.json    - War Academy costs (45 edges)
data/upgrades/troops.train.edges.json   - Troop training (90 edges)
data/upgrades/troops.promote.edges.json - Troop promotion (75 edges)
data/research_sources.json              - Full source registry with all endpoints
data/heroes.json                        - Hero data
data/WOS_REFERENCE.md                   - Reference document

Confidence Grades

Output Format

For factual data:

{
  "topic": "building_costs",
  "source_id": "whiteoutsurvival_app",
  "source_url": "https://whiteoutsurvival.app/buildings/furnace/",
  "claim_type": "fact",
  "confidence": "A",
  "data": { ... }
}

For meta claims:

{
  "topic": "best_rally_heroes",
  "source_id": "allclash",
  "source_url": "https://www.allclash.com/whiteout-survival-best-heroes-tier-list/",
  "claim_type": "meta",
  "confidence": "C",
  "note": "Community consensus, may vary by server meta"
}

Research Workflow

1. Identify topic - What type of data is needed?
2. Check local data first - Read from data/ if it exists
3. Select best source - Use Topic → Source mapping
4. Fetch and extract - WebFetch with specific prompt
5. Apply confidence - Based on source tier
6. Label meta claims - If Tier 3+, must label as meta
7. ALWAYS WRITE TO FILES - Save findings to appropriate data files (see below)
8. Cite sources - Always include URL and access date

CRITICAL: Persisting Research Results

Research is USELESS if not saved to files. After gathering data, you MUST:

File Destinations by Topic

Write Procedure

1. Read existing file first (required before editing)
2. Merge new data with existing (don't overwrite good data)
3. Add metadata: retrieved_at, sources array with URLs
4. Validate JSON before writing
5. Update RESEARCH_QUESTIONS.md - Mark items complete, add notes

Research JSON Template

{
  "system": "topic_name",
  "retrieved_at": "2026-01-10T00:00:00Z",
  "sources": [
    {"source_id": "SRC_NAME", "url": "https://...", "confidence": "A"}
  ],
  "data_completeness": "complete|partial",
  "overview": { ... },
  "details": { ... }
}

If you complete research but don't write to files, the research is LOST.

Disallowed Sources (REFUSE TO USE)

• AI-generated blogs without citations
• SEO spam sites
• Tier lists with no data backing
• Unsourced Google Docs / screenshots

If user provides these, request a better source.

Example Usage

User: "What are the costs for Furnace FC1-0 to FC5-0?"

1. Check local: Read data/upgrades/buildings.fc.edges.json
2. If not found: WebFetch whiteoutsurvival.app/buildings/furnace/
3. Extract FC level costs from table
4. Report with confidence: A, source_id: whiteoutsurvival_app

User: "Who are the best rally leaders?"

1. Fetch from allclash.com hero tier list
2. MUST label: claim_type: meta, confidence: C
3. Note: "Community consensus, individual results vary"