epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs

[nicolasvd]

📌 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.md and docs/qa-classification-test-guide.md (entire analytics contract and QA guide).
• L-05 (🟠 P1): GitHub Issue Templates (bug_report.yml, feature_idea.yml entirely 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.md French 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-release label.

[nicolasvd]

Epic Architectural Spec: #7 — epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs

Zero Branch Guardrail: This issue is an architectural container.
Creating branches or committing code directly on #7 is strictly forbidden.
Implementation proceeds exclusively via atomic child issues (< 300 diff lines) merged sequentially to main.

---

🎯 1. Vision & Strategic Objectives

• Goal: Full internationalization of the Agentic Android Kernel: translate all remaining French-language files (validation scripts, issue templates, operational script outputs, reference documentation, and README Mermaid diagram) to English-first.
• Priority: P1
• Size: L (Epic Gated)
• Estimate: 2.0d
• Target Milestone: v1.0.0

---

🏛️ 2. Architectural Bounds & Invariants

• Boundary Limits: scripts/, .github/, docs/, .agent/hooks/, README.md
• Expand/Contract Protocol: N/A — No database schemas or breaking API contracts affected.
• Byte Budgets: All translated files must strictly adhere to character and byte budgets enforced by scripts/validate-docs.sh.
• Quality Airbag: scripts/validate-docs.sh must 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-release label to merge silently without triggering tags or distribution builds.

Seq	Issue Title	Type	Target Diff	Depends On	Silent (skip-release)
01	chore(i18n): translate validation engine, issue templates, and operational scripts	chore	< 300 lines	None	✅ Yes
02	docs(i18n): translate governance specifications and QA test guides to english	docs	< 300 lines	Step 01	✅ Yes

---

📋 4. Child Issues Checklist

• Child 1 — 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)
• Child 2 — 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)

• All child issues merged sequentially into main with 100% CI pass.
• scripts/validate-docs.sh outputs 100% in English with zero French echo strings.
• Issue forms in .github/ISSUE_TEMPLATE/ are 100% English.
• Technical documentation in docs/ is 100% English.
• README Mermaid diagram labels are 100% English.
• All documentation contracts and byte budgets in ./scripts/validate-docs.sh pass green.
• Epic issue epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs #7 closed.

[nicolasvd]

🔄 Epic Progress Update — Child Issue 2 Inception

• ✅ Child Issue 1 (chore(i18n): translate validation engine, issue templates, and operational scripts #8): chore(i18n): translate validation engine, issue templates, and operational scripts — MERGED via PR chore(i18n): translate validation engine, issue templates, and operational scripts #9.
• 🟡 Child Issue 2 (docs(i18n): translate governance specifications and QA test guides to english #10): 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]

Loading

[nicolasvd]

🎉 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:

1. ✅ Child Issue 1 (#8): chore(i18n): translate validation engine, issue templates, and operational scripts — Merged via PR chore(i18n): translate validation engine, issue templates, and operational scripts #9 (commit 941b643).
2. ✅ Child Issue 2 (#10): 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 (commit 647d38f).

🏆 Epic Deliverables & Hardening Achieved

• Validation Engine: scripts/validate-docs.sh completely English-first with strict byte budgets intact.
• Issue Forms & Templates: .github/ISSUE_TEMPLATE/bug_report.yml and feature_idea.yml standardized in English with 4-pillar scoping.
• Operational Scripts: quality-check.sh, deploy-app-distribution.sh, generate-screenshots.sh, and scripts/README.md translated.
• Architecture Showcase: All Mermaid diagram labels in README.md translated.
• Technical Governance: docs/scripts-reference.md, docs/qa-classification-test-guide.md, and docs/analytics-taxonomy.md translated and generalized for reusable kernel consumption.
• Zero-PII Compliance: Telemetry contract strictly formalizes Zero-PII principles and cardinality bucketing.

Sprint 2 (Internationalisation) is 100% complete!