DESIGN:OS Toolchain · DESIGN:OS Vietnamese (vi-VN)
Sovereign Vietnamese language, typography, 7-tier pedagogy, and 16-domain compliance suite for AI coding agents.
16 production skills, 31 audience registers, 131 deterministic AST/regex rules, and 18 UKMC.v1 verified modules for Vietnamese software and regulated copy.
DESIGN:OS Vietnamese v5.2: 16 industry skills, 31 audience registers, 7-tier pedagogy continuum, and 18 UKMC.v1 verified knowledge modules.
42+ unit & QA tests · 489/489 golden eval pairs · STOP_SUFFICIENTWhat it is
- Repository
- jangtrinh/
design-os-vietnamese - Requires
- Python 3.9+ stdlibZero external pip packages
- Interface
- 16 Skills & 3 CLIsClaude, Codex, Gemini & Antigravity
- Coverage
- 31 Registers · 131 Rules18 UKMC.v1 modules · 489 eval pairs
- Telemetry
- Zero Tracking100% local execution
- License
- PolyForm Shield 1.0.0
Why DESIGN:OS Vietnamese, compared with alternatives
Generic LLMs and prose-only prompt templates fail on Vietnamese software interfaces and regulated documents because they lack deterministic linters, vertical glyph metrics, and statutory citations.
131 deterministic AST & regex rules (validate_copy.py)
Enforces 22 universal rules (NFC001, ENC001, CAL001, SYN001, LAW001, DIA001, TONE001, NUM001–NUM004, ICU001–ICU002, PRO001–PRO002, DATE001, PHONE001, CTX001–CTX005) plus 109 domain rules with hardware chip guards (Apple M2/M3, SSD M.2), compound-word pronoun exemptions (bạn bè, quý giá), and negation-aware superlative detection.
Full 7-tier Vietnamese pedagogy continuum (Mầm non → Tiến sĩ & GS/PGS)
Covers Preschool (Nhà trẻ 3–36 tháng & Mẫu giáo 3–6 tuổi — VBHN 01/VBHN-BGDĐT qualitative domains), Primary (TT 27/2020), Secondary (TT 22/2021), TVET (TT 04/2022), Undergraduate VQF Level 6 (TT 08/2021), Master's VQF Level 7 (TT 23/2021), and Doctoral VQF Level 8 + GS./PGS. Academic Ranks (TT 18/2021 & QĐ 37/2018/QĐ-TTg).
Multi-industry statutory compliance across 16 domains
Validates Advertising Law 75/2025/QH15, Decree 30/2020/NĐ-CP *Công văn*, Circular 99/2025/TT-BTC accounting, Healthcare Law 2023, Commercial Law 8% penalty caps, Tourism Law 2017, Labor Code 2019, Real Estate Business Law 2023 (5% deposit cap), E-Commerce Decrees 52/2013 & 85/2021, E-Government Decree 42/2022 & VNeID, Insurance Business Law 2022 (21-day free-look), Decree 13/2023 72h breach notice, and Press Law 2016.
UKMC.v1 cryptographic provenance & 489 golden evaluation pairs
All 18 foundational knowledge documents carry SHA-256 source attribution and 65+ inline ease:source evidence anchors verified by tools/verify_ukmc.py (STOP_SUFFICIENT).
Where cloud Translation Management Systems (Crowdin, Lokalise, Phrase) win, and it is not close: Multi-seat human translator crowdsourcing, translation memory billing, and vendor invoicing across 50+ languages. If you manage external human translation agencies rather than AI coding agents and CI pipelines, use a cloud TMS alongside DESIGN:OS Vietnamese.
Install once
Clone the repository and run the zero-dependency verification suite from your terminal, or install directly into Claude Code, OpenAI Codex, Gemini CLI, and Google Antigravity.
git clone https://github.com/jangtrinh/design-os-vietnamese
cd design-os-vietnamese
python3 -m unittest discover -s tests -v
python3 scripts/self_check.py && python3 tools/verify_ukmc.pyFirst safe use
- List all active universal and domain rule codes across the linter engine.
python3 shared/scripts/validate_copy.py --list-rules - Run a read-only JSON audit on a Vietnamese file with domain and audience register enforcement.
python3 shared/scripts/validate_copy.py README.vi.md --domain edu --register edu-postgrad --json - Write NFC-normalized and tone-standardized output to a separate clean file without mutating the source in place.
python3 shared/scripts/validate_copy.py README.vi.md --fix-tone new --output /tmp/readme.clean.md
A practical loop
validate_copy.py
Lints UTF-8 NFC normalization, mojibake, English calques, syntactic translationese, superlatives, diacritics, tone marks, numbers, ICU plurals, 31 registers, and 109 domain rules.
check_i18n_parity.py
Compares en.json and vi.json catalogs for missing keys, placeholder parity, NFD corruption, ICU other-only plural compliance, and UI expansion character caps.
check_font_coverage.py
Audits CSS font stacks and @font-face unicode-range declarations for complete 134 precomposed Vietnamese glyph coverage across Latin Extended-A/B and Latin Extended Additional.
verify_ukmc.py
Verifies all 18 UKMC.v1 knowledge modules, 65+ inline ease:source SHA-256 anchors, and the STOP_SUFFICIENT epistemic gate.
16 Production Skills & Statutory Engines
Every skill is self-contained with its own SKILL.md router, domain rule module (rules_*.py), machine-readable glossary and banned-phrase tables, and golden evaluation pairs.
Frequently asked questions
What is DESIGN:OS Vietnamese?
DESIGN:OS Vietnamese is a sovereign, zero-dependency Vietnamese (vi-VN) language, typography, UX design system, 7-tier pedagogy (Preschool to Doctoral and GS/PGS), and 16-domain statutory compliance suite for AI coding agents. It ships 16 production skills, 31 audience registers, 131 deterministic AST/regex rules, 489 golden evaluation pairs, and 18 UKMC.v1 cryptographically verified knowledge modules.
How is DESIGN:OS Vietnamese installed?
Install via Claude Code plugin marketplace (/plugin marketplace add jangtrinh/design-os-vietnamese), or clone the repository and copy skills/* into ~/.claude/skills/, ~/.codex/skills/, ~/.gemini/config/skills/, or ~/.agents/skills/.
How does it cover the 7-tier Vietnamese pedagogy continuum?
The vietnamese-education-copy skill enforces statutory terminology and grading rules across all 7 educational tiers: Tier 1 Preschool (Nhà trẻ 3–36 months and Mẫu giáo 3–6 years under VBHN 01/VBHN-BGDĐT with qualitative-only assessment), Tier 2 Primary (Circular 27/2020/TT-BGDĐT), Tier 3 Secondary and High School (Circular 22/2021/TT-BGDĐT), Tier 4 TVET (Circular 04/2022/TT-BLĐTBXH), Tier 5 Undergraduate VQF Level 6 (Circular 08/2021/TT-BGDĐT), Tier 6 Master's VQF Level 7 (Circular 23/2021/TT-BGDĐT), and Tier 7 Doctoral VQF Level 8 plus GS/PGS Academic Ranks (Circular 18/2021/TT-BGDĐT and Decision 37/2018/QĐ-TTg).
Does DESIGN:OS Vietnamese send telemetry or require external pip packages?
No. Every linter (validate_copy.py, check_i18n_parity.py, check_font_coverage.py) and epistemic verifier (verify_ukmc.py, self_check.py) runs 100% offline using the Python 3.9+ standard library with zero external dependencies and zero telemetry.
What license is DESIGN:OS Vietnamese released under?
DESIGN:OS Vietnamese is released under the PolyForm Shield License 1.0.0. Source code and knowledge modules are available for inspection, local execution, and non-competing internal or commercial projects.
DESIGN:OS Ecosystem & Related Projects
Explore complementary developer tools and companion repositories in the DESIGN:OS suite.