Activity

1. nicolasvd

   self-assigned this

   on Sep 25, 2026
2. nicolasvd

   added

   documentationImprovements or additions to documentationImprovements or additions to documentation

   governanceGovernance, lifecycle, and metadata policiesGovernance, lifecycle, and metadata policies

   source:internal

   scope:i18n

   on Sep 25, 2026
3. github-project-automation

   added this to Agentic Delivery Boardon Sep 25, 2026
4. github-project-automation

   moved this to Backlog in Agentic Delivery Boardon Sep 25, 2026
5. nicolasvd commented on Sep 25, 2026

   

   nicolasvd

   on Sep 25, 2026

   OwnerAuthor

   More actions

   4-Pillar Inception Spec — Issue #10: docs(i18n): translate governance specifications and QA test guides to english

   Parent Epic: #7 epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs
   Milestone: v1.0.0 · Priority: P1 · Size: S · Estimate: 0.5d
   Gate Status: Gate 1.4 — Inception Halt Active

   ---

   P1 · Product Spec & User Story (P1 — Product Planner)

   User Story (Gherkin)

   Feature: English-First Governance Documents and QA Guides
   
     Scenario: Reading scripts reference documentation
       Given an engineer, international contributor, or AI agent opens "docs/scripts-reference.md"
       When reviewing the operational tools, arguments, and orchestration skills
       Then all descriptions, CLI flags, output formats, and sequence diagrams are presented in standard English
   
     Scenario: Reviewing QA test scenarios and classification guidelines
       Given a QA engineer or agent consults "docs/qa-classification-test-guide.md"
       When executing test suites, triaging issues, or verifying severity criteria
       Then all test procedures, severity taxonomies, and expected results are in standard English
   
     Scenario: Inspecting Zero-PII analytics taxonomy
       Given a privacy engineer or developer reads "docs/analytics-taxonomy.md"
       When auditing event schemas and parameters
       Then all privacy invariants, parameter tables, and naming conventions are in standard English

   3-State Access Matrix

   State	Behavior
   Guest	Read-only access to all documentation in English.
   Solo	Development and test execution adhering to English-first conventions.
   Duo	Collaborative review and PR walkthroughs using English-first documentation baseline.

   Acceptance Criteria

   • docs/scripts-reference.md translated to 100% standard English.
   • docs/qa-classification-test-guide.md translated to 100% standard English.
   • docs/analytics-taxonomy.md translated to 100% standard English.
   • Byte budgets in scripts/validate-docs.sh strictly respected for all three documents.
   • ./scripts/validate-docs.sh exits 0.
   • ./scripts/quality-check.sh exits 0.

   ---

   Pillar 1 · Design Spec (P2 — Design Lead)

   Conditional Gate: N/A — No visual/UI changes (Governance, documentation, and QA guides translation).

   ---

   Pillar 2 · Privacy & Data Spec (P3 — Privacy & Data Lead)

   • Zero-PII Preservation: The English translation of docs/analytics-taxonomy.md rigorously preserves the core Zero-PII invariants (no emails, user IDs, or personal payload fields).
   • Telemetry Contract Integrity: Event taxonomy names and parameter keys remain identical to avoid breaking analytics telemetry contracts.

   ---

   Pillar 3 · System Architecture Spec (P4 — System Architect)

   • Architecture Integrity: Preserve relative links, anchors, and references across docs/, scripts/, .agent/rules/, and .agent/skills/.
   • Atomic Diff Budget: ~250–300 lines diff across 3 markdown files (< 300 LOC diff).
   • Quality Airbag: Contract verification via ./scripts/validate-docs.sh and code sanity checks via ./scripts/quality-check.sh.

   ---

   Important

   Gate 1.4 Verification (STOP & WAIT): In accordance with AGENTS.md §1.1, execution is strictly halted. Zero git branches will be cut and zero documentation files will be modified until explicit human written approval is granted.
6. nicolasvd

   added this to the v1.0.0 milestone on Sep 25, 2026
7. nicolasvd

   moved this from Backlog to In progress in Agentic Delivery Boardon Sep 25, 2026
8. nicolasvd

   added a parent issue on Sep 25, 2026

   • epic(i18n): establish english-first standard across validation engine, issue forms, and governance docs #7
9. nicolasvd

   added a commit that references this issue on Sep 25, 2026

   docs(i18n): generalize analytics taxonomy and QA test guide for kerne…

   ...

   561a774
10. nicolasvd

    closed this as completedin #11on Sep 25, 2026