Skip to main content
Glama

๐Ÿ“ข Pernyataan Keterbukaan Informasi & Penafian (Disclaimer)

NOTE

Status Repositori: Repositori ini merupakan proyek independen komunitas sumber terbuka (open source) dan BUKAN repositori resmi yang dikelola langsung oleh Badan Pengembangan dan Pembinaan Bahasa maupun Kementerian Pendidikan Dasar dan Menengah Republik Indonesia (Kemendikdasmen RI).

Sumber Data & Keterbukaan Informasi: Seluruh kaidah kebahasaan, teks pasal, butir aturan, serta contoh kalimat yang ada di repositori ini disarikan langsung dari sumber publik resmi pemerintah:

  1. Laman Resmi Pedoman Ejaan Bahasa Indonesia: https://ejaan.kemendikdasmen.go.id/

  2. Keputusan Kepala Badan Pengembangan dan Pembinaan Bahasa Kemendikbudristek RI Nomor 0424/I/BS.00.01/2022 tentang Pedoman Umum Ejaan Bahasa Indonesia yang Disempurnakan (EYD Edisi Kelima).

  3. Kamus Besar Bahasa Indonesia (KBBI VI Daring) untuk rujukan kosakata dan leksikon baku.

Tujuan Proyek: Repositori ini dikembangkan untuk kepentingan edukasi, keterbukaan informasi publik, standardisasi kecerdasan buatan (AI Agents), dan kemudahan akses masyarakat terhadap pedoman berbahasa Indonesia yang baik dan benar. Logo Tut Wuri Handayani disertakan sebagai bentuk atribusi identitas sumber pedoman pendidikan Republik Indonesia.


Related MCP server: LexiLint MCP

๐Ÿ“‘ Daftar Isi


๐ŸŒŸ Keunggulan Utama

  • ๐Ÿ›๏ธ 100% Selaras Pedoman Resmi: Mencakup 38 menu tampilan dan 4 Bab utama EYD V (Penggunaan Huruf, Penulisan Kata, Penggunaan Tanda Baca, Penulisan Unsur Serapan), SK Penetapan resmi, serta Kata Pengantar Kepala Badan Bahasa.

  • ๐ŸŽฏ 4 Domain Penulisan Profesional: Modul khusus untuk UX Writing produk digital, Copywriting/Pemasaran (EPI), Penulisan SEO Organik, serta Karya Ilmiah/Akademik.

  • ๐Ÿ“– Glosarium Istilah Teknologi & AI (115+ Kata): Padanan baku resmi istilah komputasi awan, AI, dan rekayasa perangkat lunak beserta panduan alih kode (code-switching).

  • ๐Ÿค– Universal Agent Skill (SKILL.md) & Sub-Skills: Siap dipasang ke Google Antigravity, Claude Code, Cursor IDE, Windsurf, Copilot, Cline, dan agen AI lainnya.

  • โšก Model Context Protocol (MCP Server): Dilengkapi server MCP bawaan (npx eyd-v mcp) dengan tool check_spelling, search_rules, lookup_word, dan lookup_tech_term.

  • Server REST API & Cloud Native: REST API mandiri tanpa dependensi luar (npx eyd-v serve), Dockerfile multi-stage, docker-compose, Cloudflare Workers endpoint, dan GitHub Actions runner.

  • ๐Ÿ“Š Indeks Keterbacaan & DevEx: Fitur skor kemudahan membaca (--score), linting git staged (--staged), pemantau berkas (watch), pre-commit hook (hook), dan parser nilai file i18n JSON.

  • โœ๏ธ Panduan Penulisan Alami & Anti-Slop AI: Mengeliminasi klise robotik ("di era modern ini", "sangat krusial", "menyelami") serta koma subordinatif liar sebelum kata karena/sehingga.

  • ๐Ÿง  AI Fine-Tuning & Alignment Ready: Dilengkapi dataset SFT (ChatML, Alpaca), DPO (Direct Preference Optimization), UX microcopy, marketing copy, dan evaluasi penulisan ilmiah.


๐ŸŽฏ Domain Penulisan Profesional & Sub-Skill

Versi 5.2.0 menghadirkan modul penulisan domain khusus yang dapat diaktifkan melalui opsi CLI --mode=<domain> atau dipasang sebagai sub-skill independen:

Domain

Sub-Skill

Panduan Detail

Fokus Utama

UX Writing

skills/eyd-v-ux/

docs/profesional/01-ux-writing-dan-produk.md

Mikro-kopi ringkas, pesan galat solutif, CTA jelas, konsistensi sapaan (Anda vs kamu).

Pemasaran

skills/eyd-v-marketing/

docs/profesional/02-copywriting-dan-pemasaran.md

Etika Pariwara Indonesia (EPI), pencegahan klaim superlatif berlebihan, formula AIDA/PAS.

SEO Organik

skills/eyd-v-seo/

docs/profesional/03-penulisan-seo-organik.md

Panjang judul (50โ€“60 karakter), deskripsi meta (120โ€“155 karakter), struktur hierarki heading logis.

Karya Ilmiah

skills/eyd-v-academic/

docs/profesional/04-karya-ilmiah-dan-akademik.md

Register formal, objektivitas, eliminasi ragam lisan, sitasi standar APA Edisi ke-7 / IEEE.


๐Ÿ“– Glosarium Istilah Teknologi, AI & Komputasi Awan

Koleksi 115+ padanan baku resmi untuk istilah teknologi modern tersedia di data/glosarium-istilah-teknologi.json dan panduan komprehensif di docs/profesional/05-glosarium-istilah-teknologi-dan-ai.md.

Beberapa contoh padanan umum:

  • prompt engineering โž” rekayasa prompt

  • machine learning โž” pembelajaran mesin

  • cloud computing โž” komputasi awan

  • database โž” basis data

  • cache โž” tembolok

  • screenshot โž” tangkapan layar

  • download / upload โž” unduh / unggah


Penggunaan Instan via NPX

Tidak memerlukan instalasi global, cukup jalankan perintah berikut di terminal:

1. Memeriksa Teks atau Berkas Dokumen (Linter)

# Periksa kalimat langsung
npx eyd-v check "Dimana kamu kuliah pasca sarjana?"

# Periksa berkas teks/markdown dan perbaiki langsung di tempat (--fix)
npx eyd-v check artikel.md --fix

# Periksa berkas dengan analisis skor keterbacaan (--score)
npx eyd-v check artikel.md --score

# Periksa berkas dengan mode domain tertentu
npx eyd-v check panduan-aplikasi.md --mode=ux
npx eyd-v check landing-page.md --mode=marketing
npx eyd-v check artikel-blog.md --mode=seo
npx eyd-v check skripsi.md --mode=academic

# Periksa perubahan file yang sudah di-stage di git (--staged)
npx eyd-v check --staged

# Periksa berkas lokalisasi i18n JSON (hanya memeriksa nilai teks)
npx eyd-v check locales/id.json

# Format anotasi bawaan GitHub Actions (--format=github)
npx eyd-v check docs/ --format=github

# Dukungan Stdin / Pipeline Unix
cat naskah.txt | npx eyd-v check
git diff | npx eyd-v check

# Keluaran JSON terstruktur untuk bot / pipeline CI/CD
npx eyd-v check "Sistem analisa ini penting, karena baru." --json

2. Cek Cepat Kata Baku & Padanan Istilah

# Cek apakah kata baku atau nonbaku menurut KBBI/EYD V
npx eyd-v kata antri
# Keluaran: Kata "antri" NONBAKU. Bentuk baku yang benar: "antre".

# Cari padanan istilah teknologi resmi
npx eyd-v istilah cache
# Keluaran: Istilah: "cache" | Padanan: "tembolok" | Kategori: Komputasi

3. Mode Pemantau Berkas Otomatis (Watch Mode)

# Pantau berkas atau direktori secara otomatis saat disimpan
npx eyd-v watch docs/
npx eyd-v watch artikel.md --fix

4. Pemasang Git Pre-Commit Hook Otomatis

# Pasang git hook pre-commit otomatis di repositori Anda
npx eyd-v hook

5. Server REST API Bawaan

# Jalankan server REST API lokal (default port 3000)
npx eyd-v serve
PORT=8080 npx eyd-v serve

6. Mode Playground Interaktif di Terminal (REPL)

npx eyd-v repl

7. Salin System Prompt Otomatis ke Clipboard

npx eyd-v prompt --copy

8. Memasang Aturan ke AI IDE & Coding Agents

# Menu interaktif pemilihan IDE:
npx eyd-v install

# Pasang ke SEMUA platform sekaligus:
npx eyd-v install --all

# Pasang ke platform spesifik:
npx eyd-v install --antigravity   # Google Antigravity (~/.gemini/config/skills/eyd-v/)
npx eyd-v install --cursor        # Cursor IDE (.cursor/rules/ & .cursorrules)
npx eyd-v install --windsurf      # Windsurf / Cascade (.windsurfrules)
npx eyd-v install --claude        # Claude Code CLI (.claude/skills/eyd-v/ & CLAUDE.md)
npx eyd-v install --copilot       # GitHub Copilot (.github/copilot-instructions.md)
npx eyd-v install --cline         # Cline / Roo Code (.clinerules)

9. Mencari Kaidah & Pasal Resmi

npx eyd-v search "tanda koma konjungsi"
npx eyd-v search "huruf kapital jabatan"
npx eyd-v search "bentuk terikat"

10. Menjalankan MCP Server (Model Context Protocol)

npx eyd-v mcp

Konfigurasi claude_desktop_config.json atau Cursor MCP:

{
  "mcpServers": {
    "eyd-v": {
      "command": "npx",
      "args": ["-y", "eyd-v", "mcp"]
    }
  }
}

โ˜๏ธ Deployment Enterprise, Kontainer & Cloud Native

1. Docker & Docker Compose

Menjalankan REST API server EYD V dalam kontainer Docker:

# Menjalankan kontainer mandiri
docker build -t eyd-v .
docker run -d -p 3000:3000 --name eyd-v-api eyd-v

# Atau menggunakan Docker Compose
docker-compose up -d

Uji endpoint API:

curl -X POST http://localhost:3000/api/check   -H "Content-Type: application/json"   -d '{"text": "Dimana kamu membeli pasca sarjana?", "mode": "ux"}'

2. Cloudflare Workers

Deploy REST API serverless berkecepatan tinggi ke edge network Cloudflare:

# Masuk ke folder workers dan deploy via Wrangler
cd workers
npx wrangler deploy

3. GitHub Composite Action (CI/CD)

Tambahkan langkah pemeriksaan EYD V otomatis pada berkas .github/workflows/ci.yml:

name: Lint EYD V
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Jalankan EYD V Linter
        uses: ardianryan/eyd-v@v5.2.0
        with:
          target: "docs/"
          mode: "all"
          score: "true"

4. Konfigurasi Proyek (.eydvrc.json)

Buat berkas .eydvrc.json di akar direktori proyek Anda:

{
  "mode": "all",
  "score": true,
  "ignoreWords": ["webhook", "frontend", "backend"],
  "preferredPronoun": "Anda"
}

๐ŸŒ Progressive Web App (PWA) & Web Playground

Repositori ini menyertakan aplikasi web mandiri yang dapat digunakan secara luring (offline) berkat dukungan Progressive Web App (PWA):

  • ๐Ÿ–ฅ๏ธ Buka Langsung: Buka berkas demo/index.html di browser apa pun.

  • ๐Ÿ“ฑ PWA Offline: Dapat diinstal ke perangkat (Chrome/Edge/Safari) dan bekerja sepenuhnya tanpa sambungan internet.

  • ๐ŸŽฏ Selektor Domain & Skor Keterbacaan: Memilih mode UX, Marketing, SEO, atau Akademik dan menghitung indeks keterbacaan secara visual.

  • โ˜๏ธ GitHub Pages: Siap diakses langsung di https://ardianryan.github.io/eyd-v/.


๐Ÿ’ป Penggunaan Programmatic (Node.js & TypeScript SDK)

npm install eyd-v
const {
  checkEyd,
  checkSingleWord,
  lookupTechTerm,
  searchRules,
  getRuleById
} = require("eyd-v");

// 1. Memeriksa Teks
const result = checkEyd("Kita harus merubah sistem analisa ini.", {
  mode: "marketing",
  score: true
});
console.log(result.valid); // false
console.log(result.correctedText); // "Kita harus mengubah sistem analisis ini."
console.log(result.readability.readingEase); // Skor keterbacaan

// 2. Cek Cepat Kata Baku
const wordCheck = checkSingleWord("antri");
console.log(wordCheck.isBaku); // false
console.log(wordCheck.suggestion); // "antre"

// 3. Pencarian Padanan Istilah Teknologi
const term = lookupTechTerm("cache");
console.log(term.indonesian); // "tembolok"
console.log(term.category); // "Komputasi"

// 4. Mencari Kaidah EYD V
const rules = searchRules("tanda titik dua", { limit: 3 });
console.log(rules[0].title);

๐Ÿง  AI Learning, Fine-Tuning & RAG Hub

Dataset terkurasi untuk pelatihan dan evaluasi model AI tersedia di direktori data/ai-learning/:

  • instruction-tuning-chatml.jsonl (321 dialog): SFT ChatML kaidah ortografi & morfologi.

  • alpaca-instructions.json (271 entri): Format Alpaca standar.

  • dpo-preference.jsonl (75 pasang): Preferensi DPO kaidah dasar EYD V.

  • ux-microcopy-chatml.jsonl (50 dialog): SFT ChatML nada mikro-kopi UX produk digital.

  • marketing-copy-dpo.jsonl (50 pasang): DPO iklan etis vs bombastis sesuai EPI.

  • academic-writing-eval.jsonl (50 pengujian): Evaluasi register ilmiah baku.

  • qa-evaluation.jsonl (246 pasang): Ground-truth retrieval RAG.

  • eyd-v-chunks.jsonl (246 semantic chunks): Potongan semantis siap indeks ke Vector DB (Pinecone, Chroma, Qdrant, Vectorize).

Jalankan model lokal menggunakan Ollama:

ollama create eyd-v -f prompts/Modelfile
ollama run eyd-v "Sunting naskah ini: Dimana anda pasca sarjana?"

๐Ÿ… Lencana Kepatuhan EYD V (Compliance Badge)

Sematkan lencana resmi pada README.md dokumentasi proyek Anda:

[![EYD V Compliant](https://img.shields.io/badge/Bahasa%20Indonesia-EYD%20V%20Baku-28a745.svg?style=flat-square&logo=readme)](https://github.com/ardianryan/eyd-v)

๐Ÿ“‚ Struktur Repositori & Pengetahuan

eyd-v/
โ”œโ”€โ”€ Dockerfile                        # Kontainer Node Alpine siap produksi
โ”œโ”€โ”€ docker-compose.yml                # Orkestrasi Docker lokal
โ”œโ”€โ”€ action.yml                        # GitHub Composite Action
โ”œโ”€โ”€ .eydvrc.json                      # Berkas konfigurasi linter proyek
โ”œโ”€โ”€ SKILL.md                          # Definisi Universal Agent Skill
โ”œโ”€โ”€ package.json                      # Konfigurasi package & bin CLI
โ”œโ”€โ”€ bin/
โ”‚   โ””โ”€โ”€ cli.js                        # CLI executable (check, serve, watch, hook, dll)
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ index.js                      # Programmatic SDK Library
โ”‚   โ”œโ”€โ”€ index.d.ts                    # Definisi TypeScript lengkap
โ”‚   โ”œโ”€โ”€ linter.js                     # Mesin validasi ejaan, domain & keterbacaan
โ”‚   โ”œโ”€โ”€ server.js                     # Peladen HTTP REST API bawaan
โ”‚   โ””โ”€โ”€ mcp-server.js                 # Server Model Context Protocol (stdio)
โ”œโ”€โ”€ skills/                           # Sub-skill domain profesional
โ”‚   โ”œโ”€โ”€ eyd-v-ux/                     # Sub-skill UX writing
โ”‚   โ”œโ”€โ”€ eyd-v-marketing/              # Sub-skill Copywriting & EPI
โ”‚   โ”œโ”€โ”€ eyd-v-seo/                    # Sub-skill SEO organik
โ”‚   โ””โ”€โ”€ eyd-v-academic/               # Sub-skill karya ilmiah
โ”œโ”€โ”€ data/
โ”‚   โ”œโ”€โ”€ eyd-v-all-rules.json          # Dataset lengkap seluruh pasal EYD V
โ”‚   โ”œโ”€โ”€ eyd-v-chunks.jsonl            # 246 semantic chunks siap RAG
โ”‚   โ”œโ”€โ”€ leksikon-kata-baku.json       # Kamus leksikon kata baku & aturan KTSP
โ”‚   โ”œโ”€โ”€ glosarium-istilah-teknologi.json # 115+ istilah teknologi & AI
โ”‚   โ””โ”€โ”€ ai-learning/                  # 7 dataset SFT, DPO, dan evaluasi
โ”œโ”€โ”€ docs/
โ”‚   โ”œโ”€โ”€ profesional/                  # Panduan kepenulisan profesional
โ”‚   โ”œโ”€โ”€ 00-pendahuluan/               # SK & Kata Pengantar resmi
โ”‚   โ”œโ”€โ”€ 01-penggunaan-huruf/          # 8 subbab penggunaan huruf
โ”‚   โ”œโ”€โ”€ 02-penulisan-kata/            # 9 subbab penulisan kata
โ”‚   โ”œโ”€โ”€ 03-penggunaan-tanda-baca/     # 15 subbab tanda baca
โ”‚   โ””โ”€โ”€ 04-penulisan-unsur-serapan/   # Kaidah serapan umum & khusus
โ”œโ”€โ”€ prompts/                          # System prompts siap pakai
โ”œโ”€โ”€ templates/                        # Konfigurasi Cursor, Windsurf, Copilot, Cline
โ”œโ”€โ”€ workers/                          # Endpoint Cloudflare Workers
โ”œโ”€โ”€ tests/                            # Pengujian benchmark & fitur lanjutan
โ””โ”€โ”€ demo/                             # Web Playground interaktif & PWA luring

๐Ÿงช Evaluasi & Pengujian

Pengujian mencakup seluruh kasus benchmark ortografi dan fitur lanjutan v5.2.0:

npm test

Hasil pengujian:

========================================
Hasil Uji Benchmark: 33 Lulus, 0 Gagal (100% Sukses)
========================================
Seluruh 40 Pengujian Linter & Fitur Lanjutan Lulus 100%!

๐Ÿ’– Dukungan & Donasi

Ekosistem EYD V dikembangkan dan dipelihara secara mandiri sebagai proyek sumber terbuka (open source) demi memajukan teknologi kecerdasan buatan dan pemrosesan bahasa alami (NLP) Indonesia yang tertib, bernalar, dan berstandar ilmiah.

Jika repositori, dataset, pustaka, atau perkakas ini bermanfaat bagi pekerjaan atau riset Anda, Anda dapat mendukung keberlanjutan proyek ini melalui:


๐Ÿค Komunitas, Kontribusi & Tata Kelola

Proyek ini menjunjung tinggi standar tata kelola proyek sumber terbuka yang transparan dan tertib:


๐Ÿ“„ Lisensi & Hak Cipta

  • Seluruh konten teks pedoman ejaan merupakan dokumen publik resmi milik Badan Pengembangan dan Pembinaan Bahasa, Kementerian Pendidikan Dasar dan Menengah Republik Indonesia.

  • Perangkat lunak, skrip parsing, SDK, CLI, dan server MCP dilisensikan di bawah lisensi MIT.

  • Pengelola: Ardian Ryan (me@ardianryan.com).

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Enables AI clients to access official Indonesian statistical data from Badan Pusat Statistik (BPS) through natural language queries. It provides over 20 tools for retrieving demographic, economic, and trade data with support for bilingual responses and fuzzy domain matching.
    34
    41 npm
    6
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Offline spell check and BYOK grammar checking for AI assistants. 100% offline spell check via nspell (zero tokens, zero API calls). BYOK grammar checking with your own Gemini, OpenAI, or Claude API key. Works with Claude Desktop, Cursor, ChatGPT, and any MCP-compatible tool. 8 languages supported.
    -