# Eyd V

> 🇮🇩 Ekosistem Pengetahuan, Dataset Terstruktur, AI Agent Skill & Linter Ejaan Bahasa Indonesia yang Disempurnakan (EYD Edisi Kelima) resmi Kemendikdasmen RI.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ardianryan-eyd-v`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ardianryan](https://agentstack.voostack.com/s/ardianryan)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ardianryan](https://github.com/ardianryan)
- **Source:** https://github.com/ardianryan/eyd-v
- **Website:** https://ejaan.kemendikdasmen.go.id

## Install

```sh
agentstack add mcp-ardianryan-eyd-v
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

EJAAN BAHASA INDONESIA YANG DISEMPURNAKAN (EYD V)

  Universal AI Agent Skill, Domain-Specific Writing Engine, Dataset Terstruktur & Linter Ekosistem Berbasis EYD Edisi Kelima

  
  
  
  
  
  
  
  

---

## 📢 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/](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.

---

## 📑 Daftar Isi

- [📢 Pernyataan Keterbukaan Informasi & Penafian](#-pernyataan-keterbukaan-informasi--penafian-disclaimer)
- [🌟 Keunggulan Utama](#-keunggulan-utama)
- [🎯 Domain Penulisan Profesional & Sub-Skill](#-domain-penulisan-profesional--sub-skill)
- [📖 Glosarium Istilah Teknologi, AI & Komputasi Awan](#-glosarium-istilah-teknologi-ai--komputasi-awan)
- [Penggunaan Instan via NPX](#penggunaan-instan-via-npx)
  - [1. Memeriksa Teks atau Berkas Dokumen (Linter)](#1-memeriksa-teks-atau-berkas-dokumen-linter)
  - [2. Cek Cepat Kata Baku & Padanan Istilah](#2-cek-cepat-kata-baku--padanan-istilah)
  - [3. Mode Pemantau Berkas Otomatis (Watch Mode)](#3-mode-pemantau-berkas-otomatis-watch-mode)
  - [4. Pemasang Git Pre-Commit Hook Otomatis](#4-pemasang-git-pre-commit-hook-otomatis)
  - [5. Server REST API Bawaan](#5-server-rest-api-bawaan)
  - [6. Mode Playground Interaktif di Terminal (REPL)](#6-mode-playground-interaktif-di-terminal-repl)
  - [7. Salin System Prompt Otomatis ke Clipboard](#7-salin-system-prompt-otomatis-ke-clipboard)
  - [8. Memasang Aturan ke AI IDE & Coding Agents](#8-memasang-aturan-ke-ai-ide--coding-agents)
  - [9. Mencari Kaidah & Pasal Resmi](#9-mencari-kaidah--pasal-resmi)
  - [10. Menjalankan MCP Server (Model Context Protocol)](#10-menjalankan-mcp-server-model-context-protocol)
- [☁️ Deployment Enterprise, Kontainer & Cloud Native](#️-deployment-enterprise-kontainer--cloud-native)
  - [1. Docker & Docker Compose](#1-docker--docker-compose)
  - [2. Cloudflare Workers](#2-cloudflare-workers)
  - [3. GitHub Composite Action (CI/CD)](#3-github-composite-action-cicd)
  - [4. Konfigurasi Proyek (.eydvrc.json)](#4-konfigurasi-proyek-eydvrcon)
- [🌐 Progressive Web App (PWA) & Web Playground](#-progressive-web-app-pwa--web-playground)
- [💻 Penggunaan Programmatic (Node.js & TypeScript SDK)](#-penggunaan-programmatic-nodejs--typescript-sdk)
- [🧠 AI Learning, Fine-Tuning & RAG Hub](#-ai-learning-fine-tuning--rag-hub)
- [🏅 Lencana Kepatuhan EYD V (Compliance Badge)](#-lencana-kepatuhan-eyd-v-compliance-badge)
- [📂 Struktur Repositori & Pengetahuan](#-struktur-repositori--pengetahuan)
- [🧪 Evaluasi & Pengujian](#-evaluasi--pengujian)
- [💖 Dukungan & Donasi](#-dukungan--donasi)
- [🤝 Komunitas, Kontribusi & Tata Kelola](#-komunitas-kontribusi--tata-kelola)
- [📄 Lisensi & Hak Cipta](#-lisensi--hak-cipta)

---

## 🌟 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=` atau dipasang sebagai sub-skill independen:

| Domain | Sub-Skill | Panduan Detail | Fokus Utama |
|:---|:---|:---|:---|
| **UX Writing** | [`skills/eyd-v-ux/`](skills/eyd-v-ux/) | [`docs/profesional/01-ux-writing-dan-produk.md`](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/`](skills/eyd-v-marketing/) | [`docs/profesional/02-copywriting-dan-pemasaran.md`](docs/profesional/02-copywriting-dan-pemasaran.md) | Etika Pariwara Indonesia (EPI), pencegahan klaim superlatif berlebihan, formula AIDA/PAS. |
| **SEO Organik** | [`skills/eyd-v-seo/`](skills/eyd-v-seo/) | [`docs/profesional/03-penulisan-seo-organik.md`](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/`](skills/eyd-v-academic/) | [`docs/profesional/04-karya-ilmiah-dan-akademik.md`](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`](data/glosarium-istilah-teknologi.json) dan panduan komprehensif di [`docs/profesional/05-glosarium-istilah-teknologi-dan-ai.md`](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)
```bash
# 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
```bash
# 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)
```bash
# 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
```bash
# Pasang git hook pre-commit otomatis di repositori Anda
npx eyd-v hook
```

### 5. Server REST API Bawaan
```bash
# 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)
```bash
npx eyd-v repl
```

### 7. Salin System Prompt Otomatis ke Clipboard
```bash
npx eyd-v prompt --copy
```

### 8. Memasang Aturan ke AI IDE & Coding Agents
```bash
# 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
```bash
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)
```bash
npx eyd-v mcp
```

Konfigurasi `claude_desktop_config.json` atau Cursor MCP:
```json
{
  "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:
```bash
# 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:
```bash
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:
```bash
# 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`:
```yaml
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:
```json
{
  "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/](https://ardianryan.github.io/eyd-v/).

---

## 💻 Penggunaan Programmatic (Node.js & TypeScript SDK)

```bash
npm install eyd-v
```

```javascript
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/`](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:
```bash
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:

  

```markdown
[](https://github.com/ardianryan/eyd-v)
```

---

## 📂 Struktur Repositori & Pengetahuan

```text
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
│

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ardianryan](https://github.com/ardianryan)
- **Source:** [ardianryan/eyd-v](https://github.com/ardianryan/eyd-v)
- **License:** MIT
- **Homepage:** https://ejaan.kemendikdasmen.go.id

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ardianryan-eyd-v
- Seller: https://agentstack.voostack.com/s/ardianryan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.