Repository navigation
epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs #7
Description
📌 Vision & Strategic Objectives
During the Comprehensive 360° Architecture Audit (audit-360-v1.0.md), Axe 1 identified that the kernel's documentation, validation scripts, and issue templates are heavily French-centric, preventing international adoption and consistency:
- L-01 (🟠 P1):
scripts/validate-docs.sh(140+ French echo strings, French file descriptions, French section banners). - L-02 (🟠 P1):
docs/scripts-reference.md(~220 lines entirely French). - L-03 (🟠 P1):
scripts/README.md(~30 lines entirely French). - L-04 (🟠 P1):
docs/analytics-taxonomy.mdanddocs/qa-classification-test-guide.md(entire analytics contract and QA guide). - L-05 (🟠 P1): GitHub Issue Templates (
bug_report.yml,feature_idea.ymlentirely French). - L-06 (🟡 P2): Targeted bash scripts echoes (
quality-check.sh,deploy-app-distribution.sh,generate-screenshots.sh,pre-invocation-anchor.sh). - R-01 part 1 (🔴 P0):
README.mdFrench Mermaid diagram labels.
🏛️ Rule 0.1 Epic Gating & Zero Branch Guardrail
- Classification:
Size: L(cumulative diff across 7+ files exceeds 300 LOC limit). - Zero Branch Guardrail: This issue is an architectural container. Creating branches or committing code directly on this Epic is strictly forbidden.
- Decomposition: P1 and P4 decompose this Epic into atomic child issues (< 300 diff lines each) via
.agent/templates/epic-spec.md. - Trunk-Based Release Suppression: Intermediate child PRs carry the
skip-releaselabel.
Metadata
Metadata
Assignees
Labels
Projects
- Status
Activity
nicolasvd commentedon Sep 25, 2026
Epic Architectural Spec: #7 — epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs
🎯 1. Vision & Strategic Objectives
L(Epic Gated)v1.0.0🏛️ 2. Architectural Bounds & Invariants
scripts/,.github/,docs/,.agent/hooks/,README.mdscripts/validate-docs.sh.scripts/validate-docs.shmust remain 100% green before and after each child PR.🗺️ 3. Sequential Decomposition DAG
Child issues must be implemented in topological order. Intermediate child PRs carry the
skip-releaselabel to merge silently without triggering tags or distribution builds.skip-release)chore(i18n): translate validation engine, issue templates, and operational scriptschoredocs(i18n): translate governance specifications and QA test guides to englishdocs📋 4. Child Issues Checklist
chore(i18n): translate validation engine, issue templates, and operational scripts(parent: epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs #7)docs(i18n): translate governance specifications and QA test guides to english(parent: epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs #7)✅ 5. Definition of Done (Epic Level)
mainwith 100% CI pass.scripts/validate-docs.shoutputs 100% in English with zero French echo strings..github/ISSUE_TEMPLATE/are 100% English.docs/is 100% English../scripts/validate-docs.shpass green.nicolasvd commentedon Sep 25, 2026
🔄 Epic Progress Update — Child Issue 2 Inception
chore(i18n): translate validation engine, issue templates, and operational scripts— MERGED via PR chore(i18n): translate validation engine, issue templates, and operational scripts #9.docs(i18n): translate governance specifications and QA test guides to english— CREATED & sealed at Gate 1.4 (Inception Spec comment posted).Updated Epic DAG
graph TD A[Epic #7: English-First Standard] --> B[Issue #8: Tooling, Templates & Scripts] A --> C[Issue #10: Governance Docs & QA Guides] B -->|Merged in PR #9| D[Phase 1 Complete] C -->|Gate 1.4 Inception| E[Phase 2 In Progress]nicolasvd commentedon Sep 25, 2026
🎉 Epic Completed — All Child Issues Merged & Closed
Both child stories under Parent Epic #7 have been successfully executed, validated via the Quality Airbag, and merged into
main:chore(i18n): translate validation engine, issue templates, and operational scripts— Merged via PR chore(i18n): translate validation engine, issue templates, and operational scripts #9 (commit941b643).docs(i18n): translate governance specifications and QA test guides to english— Merged via PR docs(i18n): translate governance specifications and QA test guides to english #11 (commit647d38f).🏆 Epic Deliverables & Hardening Achieved
scripts/validate-docs.shcompletely English-first with strict byte budgets intact..github/ISSUE_TEMPLATE/bug_report.ymlandfeature_idea.ymlstandardized in English with 4-pillar scoping.quality-check.sh,deploy-app-distribution.sh,generate-screenshots.sh, andscripts/README.mdtranslated.README.mdtranslated.docs/scripts-reference.md,docs/qa-classification-test-guide.md, anddocs/analytics-taxonomy.mdtranslated and generalized for reusable kernel consumption.Sprint 2 (Internationalisation) is 100% complete!