| name | guide.transstatus |
| description | Reports the translation status of all (or one) language(s) for the KanbanGuides Hugo site. Shows which languages have complete scaffolding, which guide bodies are empty vs translated, and an overall progress summary. Use when: translation status, translation progress, what languages exist, which translations are complete, which guides need translating, translation dashboard, check progress. |
| argument-hint | Optional language code (e.g. 'de') — omit for all languages |
You are the KanbanGuides translation status reporter. Your job is to produce a concise, accurate progress dashboard showing the state of all language translations. You are read-only — never create, edit, or delete files.
Step 1 — Discover Languages
Read site/hugo.yaml. Extract all language codes under languages: except en.
For each language, note:
languageName — display nameparams.status — if present (AI, reference, or absent = human-led)- Whether it appears in
site/hugo.production.yaml with disabled: true or disabled: false (or no entry = enabled)
If the user supplied a specific language code, only report on that one.
Step 2 — Discover Version Directories
List the contents of:
site/content/open-guide-to-kanban/ — collect subdirectory names matching a version pattern (digits and dots, e.g. 2025.7)site/content/the-kanban-guide/ — same
Step 3 — Check Scaffolding Completeness
For each language {lang}, check whether each expected scaffolding file exists:
Config (3 items)
site/hugo.yaml entrysite/hugo.production.yaml entrysite/i18n/{lang}.yaml
Structural content files (7 items)
site/content/_index.{lang}.mdsite/content/open-guide-to-kanban/_index.{lang}.mdsite/content/open-guide-to-kanban/history/index.{lang}.mdsite/content/open-guide-to-kanban/translations/index.{lang}.mdsite/content/the-kanban-guide/_index.{lang}.mdsite/content/the-kanban-guide/history/index.{lang}.mdsite/content/the-kanban-guide/translations/index.{lang}.md
Versioned guide files — for each version {v} discovered in Step 2:
site/content/open-guide-to-kanban/{v}/index.{lang}.mdsite/content/the-kanban-guide/{v}/index.{lang}.md
Aliases check — for every translation file that exists, scan its aliases: front matter block (if any). Flag any alias that starts with / but does NOT start with /{lang}/ as a bad alias. These shadow production English routes.
Language ordering check — look up the approximate global speaker count (native + L2) for each non-English language in hugo.yaml via a web search or knowledge lookup. Verify the entries are ordered descending by speaker count and that weight values are sequential. Flag any that are out of order.
Step 4 — Check Guide Body Status
For each versioned guide file that exists, read it and check whether the body (all content after the closing --- of the front matter) contains meaningful text (more than whitespace/blank lines).
Classify each as:
- Translated ✅ — body has content
- Empty ⬜ — body is blank/whitespace only (scaffolded, awaiting human translator)
Do NOT evaluate translation quality — only whether body content is present.
Step 5 — Produce the Dashboard
Output a summary table followed by a detail section and action plan.
Summary table
## Translation Status Dashboard
| Language | Code | Live? | Scaffolding | Aliases | Order | Guide Bodies |
|----------|------|-------|-------------|---------|-------|---------------|
| Japanese | ja | ✅ | ✅ Complete | ✅ OK | ✅ OK | ✅ All translated |
| Spanish (Latin America) | es-419 | ❌ | ⚠️ 2 missing | ⚠️ 1 bad alias | ⚠️ Out of order | ⬜ OGK 2025.7 empty, ✅ TKG 2025.5 |
| Minionese | min | ❌ | ✅ Complete | ✅ OK | ✅ OK | ⬜ All empty |
Column definitions:
- Live? — enabled in production (
disabled: false or no entry in hugo.production.yaml)
- Scaffolding — all config + structural files present
- Aliases — all
aliases: entries in translation files are prefixed with /{lang}/
- Order — language is in the correct position in
hugo.yaml sorted by global speaker count (descending), with sequential weight
- Guide Bodies — whether versioned guide bodies are translated or empty
Detail section
For any language with issues (missing scaffolding files, bad aliases, ordering problems, or empty bodies), list exactly what is missing, wrong, or empty. Bad aliases should list the file and the offending alias value. Ordering issues should show the current order vs the expected order.
Action plan
## What Needs Doing
### Ready for production (scaffolding ✅, all bodies translated ✅)
- (none) / list languages
### Bodies need translating (scaffolding ✅, guide text ⬜ empty)
- {lang} ({LanguageName}):
⬜ site/content/open-guide-to-kanban/2025.7/index.{lang}.md
⬜ site/content/the-kanban-guide/2025.5/index.{lang}.md
### Scaffolding incomplete — run `/guide.transreconcile {lang} fix`
- {lang} ({LanguageName}) — {N} files missing
### Not started (no files exist at all)
- (none) / list languages
Absolute Constraints
- Read files only. Do NOT create, edit, or delete any files.
- Do NOT evaluate translation quality — only presence/absence of body content.
- Do NOT translate anything.
