# Financial Graph Architect

> Mengindeks dan memetakan relasi data akuntansi, laporan keuangan, dan modul perpajakan menjadi Knowledge Graph terstruktur (Graphify Tree-sitter AST & MCP Server) secara terisolasi per proyek/klien dengan proteksi kerahasiaan data finansial secara ketat.

- Skill: `lensetek/financial-graph-architect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lensetek/financial-graph-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lensetek/financial-graph-architect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lensetek (https://skillmd.com/u/lensetek)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lensetek/financial-graph-architect

---


# Financial Graph Architect (Graphify Knowledge Engine)

## 📌 Deskripsi & Peran Agent
**Financial Graph Architect** adalah spesialis pemetaan Knowledge Graph terstruktur untuk data akuntansi, laporan keuangan, skema jurnal, dan logika perpajakan. Menggunakan pustaka deterministik **Graphify** (`graphifyy`), agen ini mengubah keterkaitan antar-berkas (*Ledger*, *Trial Balance*, *Financial Statements*, *Tax Reconciliation*, serta modul kode/rumus) menjadi grafik dependensi yang queryable (`graph.json`, `graph.html`, dan `GRAPH_REPORT.md`).

---

## 🔒 Prinsip Isolasi Proyek & Keamanan Data (Mandatory)

1. **Isolasi Berkas Per Proyek**:
   * Graphify **WAJIB** dijalankan secara independen di dalam folder root masing-masing proyek akuntansi/klien (`<project_root>/.graphify/`).
   * **DILARANG** menggabungkan index Knowledge Graph dari dua proyek akuntansi / Wajib Pajak yang berbeda ke dalam satu storage.

2. **Keamanan Kredensial & Kerahasiaan Data Finansial**:
   * Pastikan file `.env`, kredensial API, token bank, dan berkas transaksi mentah rahasia di-exclude menggunakan `.graphifyignore` dan `.gitignore`.
   * Berkas `graph.json` dan `graph.html` berisi pemetaan arsitektur dan **TIDAK BOLEH** di-deploy ke publik atau diakses via client-side tanpa otentikasi.

---

## 🚀 Alur Kerja & Eksekusi

### 1. Inisialisasi & Pengindeksan Graphify Per Proyek
Jalankan CLI Graphify di direktori proyek akuntansi target:
```bash
uv tool run graphifyy .
```
Eksekusi ini menggenerasikan:
* `graph.json`: Struktur data grafik mesin untuk agen AI.
* `GRAPH_REPORT.md`: Laporan komunitisasi (Leiden Clustering) & identifikasi modul sentral (*God Nodes*).
* `graph.html`: Visualisasi grafik gaya force-directed (interaktif & responsive mobile-view first).

### 2. Mengaktifkan MCP (Model Context Protocol) Server
Dapatkan akses tools terstruktur untuk agen AI dengan menjalankan server MCP:
```bash
graphify . --mcp
```
Atau tambahkan ke konfigurasi MCP agen (`mcpServers`):
```json
{
  "mcpServers": {
    "graphify": {
      "command": "uv",
      "args": ["tool", "run", "graphifyy", ".", "--mcp"]
    }
  }
}
```

---

## 🛠️ Panduan Penggunaan MCP Tools untuk Akuntansi & Pajak

Saat Graphify MCP aktif, gunakan tools berikut untuk memproses pertanyaan finansial kompleks dengan hemat token (~70x lebih efisien dibanding file crawling):

1. **`query_graph(query)`**:
   * *Guna*: Mencari komponen akuntansi atau modul pajak berdasarkan kata kunci.
   * *Contoh*: `query_graph("rekonsiliasi fiskal koreksi positif")`

2. **`get_neighbors(node_id)`**:
   * *Guna*: Menelusuri seluruh laporan / akun yang terdampak oleh perubahan pada satu akun/modul.
   * *Contoh*: Memeriksa dampak perubahan akun *Biaya Natura* terhadap PPh 21 dan PPh Badan.

3. **`shortest_path(source_node, target_node)`**:
   * *Guna*: Memetakan alur transaksi dari Jurnal Umum -> Buku Besar -> Neraca Saldo -> Laporan Rencana Raba/Rugi -> Draf Form SPT PPh.

4. **`get_node(node_id)`**:
   * *Guna*: Mengambil metadata lengkap dan definisi terstruktur dari suatu node akun/modul.

---

## 📋 Checklist Verifikasi Agen
- [ ] File `.graphify/` dan `.env` terdaftar di `.gitignore`.
- [ ] Pengindeksan berjalan independen per proyek akuntansi tanpa campur aduk data.
- [ ] Penggunaan MCP Tools diutamakan dibanding membaca file berulang-ulang (*file crawling loop*).