Home /Modules/languages/AI-AID.md

AI-AID.md

languages/AI-AID.md · 49 line(s) · markdown

AI-AID: model of the languages/ folder

For Kiro and any other AI assistant. Read this before editing or summarizing the folder. Each subfolder has a DEGREE.MD stating how complete and valid it is.

Purpose

languages/ holds three independent things. Do not merge them.

PartFilesModel
Localization packs*.lang (12: en es fr de pt it ja zh hi ko th ar), KEYS.md, settings.confkey = value UTF-8 text. English is the reference key set. Missing keys fall back to English. Read by lib/languages (SLLanguage, SLLanguageCatalog). Documented in README.md.
Language research profiles80 folders named by language (english, mandarin-chinese, ... maithili)Top 80 languages by total speakers (2025 ranking). Each holds README.md (research template), alphabet.json, ALPHABET.xml. Statistics are per country and year, never traits of speakers.
FRUCHST dictionariesFRUCHST_FORMAT.md, FRUCHST_SOURCES.md, FRUCHST_STATUS.md, FRUCHST_TARGETS.json, datasets/, tools/One binary fruchst.<code>.bin per profile: 1,000 frequency-ranked native headwords, each with aligned English, French and Spanish definitions.

Ground rules

  1. A profile folder is not "done" until its corpus, definition sources and licenses are reviewed and its binary validates (tools/fruchst.py).
  2. Never invent ranks, frequencies, definitions, statistics or sources. Unknown means "to be researched" or "none".
  3. Never present frequency candidates as approved definitions. Every candidate is review_status: required; approved count is 0.
  4. Keep the three parts independent. Alphabet files and .lang packs do not depend on FRUCHST.
  5. Social indicators (education, fertility, savings, well-being) belong to geographies, not languages. Do not compute a combined "aptitude" score.
  6. Respect upstream licenses recorded in FRUCHST_TARGETS.json (license_review). Do not copy third-party text that is not listed there.
  7. Source of truth for numbers: FRUCHST_STATUS.md and FRUCHST_TARGETS.json. DEGREE.MD files are derived snapshots (2026-11-16). On conflict, the sources win and the DEGREE.MD should be refreshed.

Pipeline stages (used by every DEGREE.MD)

TierMeaning
C0Scaffold only. No licensed frequency source found.
C11,000-word list staged. Definitions negligible (under 50 words with all three).
C2Word list plus partial EN/FR/ES candidate definitions.
C3Near-complete candidates, still unreviewed.
C4Reviewed and approved definitions. (none yet)
C5Binary built and validated. (none yet)

Degree percent = 10 (scaffold) + 20 (word list) + 30 x (all-three definitions / 1,000). Review and binary make up the other 40 points, currently 0 everywhere. No folder can exceed 60% until review starts.

Overall state (2026-11-16)

Where to look