cultural-research

name	cultural-research
description	Use this to autonomously populate Martinique_DB. Takes a cultural topic from the 6 CoT circles, runs a deep research loop using gpt-researcher or web search, structures findings into DB-ready entries, and loops until coverage is sufficient.

Cultural Research Loop — Martinique_DB Population

Autonomously research and populate a cultural knowledge circle in Martinique_DB. This skill applies the Karpathy autoresearch pattern to knowledge base construction: run overnight, wake up to a populated DB.

The 6 Cultural Circles (from reflexion_structuree_cot.md)

Priority order for population:

1. Cercle 1 — L'individu (daily life, demographics, habits)
2. Cercle 2 — La communauté (family, social structure, annual traditions)
3. Cercle 3 — La culture profonde (language, music, food, arts)
4. Cercle 4 — Le territoire (geography, communes, flora/fauna)
5. Cercle 5 — Histoire & identité (historical timeline, intellectual thought)
6. Cercle 6 — Économie & enjeux contemporains (economy, current issues, health)

Research Loop

LOOP FOREVER (until manually stopped or coverage target met):

1. Check coverage report — which sub-topics in the target circle are empty or thin?
2. Pick the thinnest sub-topic
3. Run research (gpt-researcher / web search / Wikipedia FR)
4. Structure findings into DB entries (see Entry Format below)
5. Write entries to martinique_db/data/<circle>/<topic>.json
6. Update coverage report
7. If circle coverage >= 80%, advance to next circle

Entry Format

Every entry in Martinique_DB must include these metadata fields:

{
  "id": "unique slug",
  "title": "string",
  "content": "string — the actual knowledge, 100-500 words",
  "category": "cercle_1 | cercle_2 | cercle_3 | cercle_4 | cercle_5 | cercle_6",
  "sub_category": "string — e.g. 'gastronomie', 'musique', 'commune'",
  "language": "fr | creole | bilingual",
  "source": "oral | web | institutional | wikipedia",
  "reliability": "verified | tradition | estimate",
  "temporality": "historical | current | evolving",
  "geo": "string — commune, zone (nord/sud/centre), or 'all'",
  "entities": ["list of named entities — people, places, events"],
  "relations": [{"entity": "string", "relation": "string", "target": "string"}],
  "created_at": "ISO date"
}

Research Sources Priority

1. Wikipedia FR (Martinique pages) — structured, reliable
2. Collectivité de Martinique official site
3. France-Antilles archives
4. Academic sources (CNRS, université Antilles)
5. ATV / RCI / Martinique La 1ère
6. YouTube: transcribe via faster-whisper for oral/musical content

Coverage Metric

Coverage = number of non-empty sub-topics / total sub-topics in circle × 100.

Target: 80% coverage per circle before advancing. Store in martinique_db/coverage.json.

NEVER STOP rule

Once the loop has started, do NOT pause to ask if you should continue. The human may be asleep. Run until manually interrupted or 80% coverage is reached for all 6 circles.