# el-kizmi/jurnal-jkt architecture

> Architecture diagram of the GitHub repository el-kizmi/jurnal-jkt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/el-kizmi/jurnal-jkt
- Repository: https://github.com/el-kizmi/jurnal-jkt

## Overview

JKT Writing System is an AI-hosted skill for producing, auditing, and analyzing manuscripts against empirical Jurnal Kelautan Tropis patterns. The main workflow is a user request and research material or manuscript → mode selection → mode-specific instructions and reference rules → written draft, audit report, or corpus profile. AUDIT and DETECT also use the metrics script. The README documents the major capabilities; unsampled mode instructions mean internal links beyond those documented are omitted.

Main entry points: [`skill/jkt-writing-system/references/mode_write.md`](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_write.md) (WRITE workflow), [`skill/jkt-writing-system/scripts/jkt_metrics.py`](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/scripts/jkt_metrics.py) (Metrics engine), [`skill/jkt-writing-system/SKILL.md`](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/SKILL.md) (Mode selector), [`skill/jkt-writing-system/references/mode_audit.md`](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_audit.md) (AUDIT workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Skill runtime"]
  node_skill["Mode selector<br/>[SKILL.md]"]
end

subgraph group_write["Writing"]
  node_write_mode["WRITE workflow<br/>[mode_write.md]"]
  node_write_rules["Writing rules"]
  node_style["Style profile<br/>[style_profile.yaml]"]
  node_patterns[("Pattern database")]
  node_draft["JKT draft"]
end

subgraph group_audit["Audit"]
  node_audit_mode["AUDIT workflow<br/>[mode_audit.md]"]
  node_audit_rules["Audit rules<br/>[audit_rules.yaml]"]
  node_metrics["Metrics engine<br/>[jkt_metrics.py]"]
  node_audit_report["Audit report"]
end

subgraph group_detect["Corpus analysis"]
  node_detect_mode["DETECT workflow<br/>[mode_detect.md]"]
  node_annotation["Annotation codebook"]
  node_pattern_codes["Pattern codebook"]
  node_corpus_profile["Corpus profile"]
end

node_user(("Researcher"))
node_ai{{"AI platform"}}
node_article_corpus["JKT article corpus"]

node_user -->|"submits request"| node_ai
node_ai -->|"provides request"| node_skill
node_skill -->|"selects WRITE"| node_write_mode
node_skill -->|"selects AUDIT"| node_audit_mode
node_skill -->|"selects DETECT"| node_detect_mode
node_write_mode -->|"applies rules"| node_write_rules
node_write_mode -->|"uses profile"| node_style
node_write_mode -->|"uses patterns"| node_patterns
node_write_mode -->|"produces text"| node_draft
node_audit_mode -->|"applies rules"| node_audit_rules
node_audit_mode -->|"runs measurements"| node_metrics
node_metrics -->|"formats metrics"| node_audit_report
node_audit_mode -->|"adds findings"| node_audit_report
node_detect_mode -->|"uses annotations"| node_annotation
node_detect_mode -->|"uses codes"| node_pattern_codes
node_detect_mode -->|"runs corpus analysis"| node_metrics
node_article_corpus -->|"provides articles"| node_metrics
node_metrics -->|"writes summary"| node_corpus_profile
node_draft -->|"returns draft"| node_user
node_audit_report -->|"returns report"| node_user
node_corpus_profile -->|"returns profile"| node_user

click node_skill "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/SKILL.md"
click node_write_mode "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_write.md"
click node_write_rules "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/generation_rules.yaml"
click node_style "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/style_profile.yaml"
click node_patterns "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/pattern_database.yaml"
click node_audit_mode "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_audit.md"
click node_audit_rules "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/audit_rules.yaml"
click node_metrics "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/scripts/jkt_metrics.py"
click node_detect_mode "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_detect.md"
click node_annotation "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/annotation_codebook.yaml"
click node_pattern_codes "https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/pattern_codebook.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill toneBlue
class node_write_mode,node_write_rules,node_style,node_patterns,node_draft toneAmber
class node_audit_mode,node_audit_rules,node_metrics,node_audit_report toneMint
class node_detect_mode,node_annotation,node_pattern_codes,node_corpus_profile toneRose
class node_user,node_ai,node_article_corpus toneIndigo
```

## Components

### Skill runtime

- [Mode selector](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/SKILL.md): `skill/jkt-writing-system/SKILL.md`

### Writing

- [WRITE workflow](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_write.md): `skill/jkt-writing-system/references/mode_write.md`
- [Writing rules](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/generation_rules.yaml): `skill/jkt-writing-system/references/generation_rules.yaml`
- [Style profile](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/style_profile.yaml): `skill/jkt-writing-system/references/style_profile.yaml`
- [Pattern database](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/pattern_database.yaml): `skill/jkt-writing-system/references/pattern_database.yaml`
- **JKT draft**

### Audit

- [AUDIT workflow](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_audit.md): `skill/jkt-writing-system/references/mode_audit.md`
- [Audit rules](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/audit_rules.yaml): `skill/jkt-writing-system/references/audit_rules.yaml`
- [Metrics engine](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/scripts/jkt_metrics.py): `skill/jkt-writing-system/scripts/jkt_metrics.py`
- **Audit report**

### Corpus analysis

- [DETECT workflow](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/mode_detect.md): `skill/jkt-writing-system/references/mode_detect.md`
- [Annotation codebook](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/annotation_codebook.yaml): `skill/jkt-writing-system/references/annotation_codebook.yaml`
- [Pattern codebook](https://github.com/el-kizmi/jurnal-jkt/blob/master/skill/jkt-writing-system/references/pattern_codebook.yaml): `skill/jkt-writing-system/references/pattern_codebook.yaml`
- **Corpus profile**

### Other components

- **Researcher**
- **AI platform**
- **JKT article corpus**

## Connections

- Researcher → AI platform: submits request
- AI platform → Mode selector: provides request
- Mode selector → WRITE workflow: selects WRITE
- Mode selector → AUDIT workflow: selects AUDIT
- Mode selector → DETECT workflow: selects DETECT
- WRITE workflow → Writing rules: applies rules
- WRITE workflow → Style profile: uses profile
- WRITE workflow → Pattern database: uses patterns
- WRITE workflow → JKT draft: produces text
- AUDIT workflow → Audit rules: applies rules
- AUDIT workflow → Metrics engine: runs measurements
- Metrics engine → Audit report: formats metrics
- AUDIT workflow → Audit report: adds findings
- DETECT workflow → Annotation codebook: uses annotations
- DETECT workflow → Pattern codebook: uses codes
- DETECT workflow → Metrics engine: runs corpus analysis
- JKT article corpus → Metrics engine: provides articles
- Metrics engine → Corpus profile: writes summary
- JKT draft → Researcher: returns draft
- Audit report → Researcher: returns report
- Corpus profile → Researcher: returns profile