# nanaism/yomiyasu architecture

> Architecture diagram of the GitHub repository nanaism/yomiyasu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nanaism/yomiyasu
- Repository: https://github.com/nanaism/yomiyasu

## Overview

yomiyasu is an agent skill for revising AI-generated Japanese into clearer, denser prose, especially practical and technical writing. The main workflow is a user asking an AI coding agent to revise a draft; the skill applies its editing principles and optional domain guidance, then returns revised text. The repository also provides standalone linting and rewrite-diff tools. The README documents the skill and domain capabilities; source excerpts show the lint and diff tools, but not the skill prompt or reference-file contents.

Main entry points: [`SKILL.md`](https://github.com/nanaism/yomiyasu/blob/main/SKILL.md) (Yomiyasu skill), [`references/gemini-syntax.md`](https://github.com/nanaism/yomiyasu/blob/main/references/gemini-syntax.md) (Revision principles), [`references/slop-catalog.md`](https://github.com/nanaism/yomiyasu/blob/main/references/slop-catalog.md) (Slop catalog), [`references/domains/tech.md`](https://github.com/nanaism/yomiyasu/blob/main/references/domains/tech.md) (Tech guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Revision workflow"]
  node_skill["Yomiyasu skill<br/>[SKILL.md]"]
  node_revised["Revised text"]
end

subgraph group_guidance["Editing guidance"]
  node_principles["Revision principles<br/>[gemini-syntax.md]"]
  node_slop["Slop catalog<br/>[slop-catalog.md]"]
  node_tech["Tech guidance<br/>[tech.md]"]
  node_business["Business guidance<br/>[business.md]"]
  node_essay["Essay guidance<br/>[essay.md]"]
end

subgraph group_tools["Review tools"]
  node_lint["Text linter<br/>[yomiyasu_lint.py]"]
  node_diff["Rewrite diff<br/>[yomiyasu_diff.py]"]
end

node_writer(("Writer"))
node_agent["AI agent"]

node_writer -->|"requests revision"| node_agent
node_agent -->|"uses skill"| node_skill
node_skill -->|"applies principles"| node_principles
node_skill -->|"checks patterns"| node_slop
node_skill -->|"uses when selected"| node_tech
node_skill -->|"uses when selected"| node_business
node_skill -->|"uses when selected"| node_essay
node_agent -->|"returns revision"| node_revised
node_writer -->|"checks text"| node_lint
node_writer -.->|"compares drafts"| node_diff

click node_skill "https://github.com/nanaism/yomiyasu/blob/main/SKILL.md"
click node_principles "https://github.com/nanaism/yomiyasu/blob/main/references/gemini-syntax.md"
click node_slop "https://github.com/nanaism/yomiyasu/blob/main/references/slop-catalog.md"
click node_tech "https://github.com/nanaism/yomiyasu/blob/main/references/domains/tech.md"
click node_business "https://github.com/nanaism/yomiyasu/blob/main/references/domains/business.md"
click node_essay "https://github.com/nanaism/yomiyasu/blob/main/references/domains/essay.md"
click node_lint "https://github.com/nanaism/yomiyasu/blob/main/scripts/yomiyasu_lint.py"
click node_diff "https://github.com/nanaism/yomiyasu/blob/main/scripts/yomiyasu_diff.py"

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,node_revised toneBlue
class node_principles,node_slop,node_tech,node_business,node_essay toneAmber
class node_lint,node_diff toneMint
class node_writer,node_agent toneIndigo
```

## Components

### Revision workflow

- [Yomiyasu skill](https://github.com/nanaism/yomiyasu/blob/main/SKILL.md): `SKILL.md`
- **Revised text**

### Editing guidance

- [Revision principles](https://github.com/nanaism/yomiyasu/blob/main/references/gemini-syntax.md): `references/gemini-syntax.md`
- [Slop catalog](https://github.com/nanaism/yomiyasu/blob/main/references/slop-catalog.md): `references/slop-catalog.md`
- [Tech guidance](https://github.com/nanaism/yomiyasu/blob/main/references/domains/tech.md): `references/domains/tech.md`
- [Business guidance](https://github.com/nanaism/yomiyasu/blob/main/references/domains/business.md): `references/domains/business.md`
- [Essay guidance](https://github.com/nanaism/yomiyasu/blob/main/references/domains/essay.md): `references/domains/essay.md`

### Review tools

- [Text linter](https://github.com/nanaism/yomiyasu/blob/main/scripts/yomiyasu_lint.py): `scripts/yomiyasu_lint.py`
- [Rewrite diff](https://github.com/nanaism/yomiyasu/blob/main/scripts/yomiyasu_diff.py): `scripts/yomiyasu_diff.py`

### Other components

- **Writer**
- **AI agent**

## Connections

- Writer → AI agent: requests revision (evidence: `README.md`)
- AI agent → Yomiyasu skill: uses skill (evidence: `README.md`)
- Yomiyasu skill → Revision principles: applies principles (evidence: `README.md`)
- Yomiyasu skill → Slop catalog: checks patterns (evidence: `README.md`)
- Yomiyasu skill → Tech guidance: uses when selected (evidence: `README.md`)
- Yomiyasu skill → Business guidance: uses when selected (evidence: `README.md`)
- Yomiyasu skill → Essay guidance: uses when selected (evidence: `README.md`)
- AI agent → Revised text: returns revision (evidence: `README.md`)
- Writer → Text linter: checks text (evidence: `README.md`)
- Writer → Rewrite diff: compares drafts
