# yha9806/academic-writing-toolkit architecture

> Architecture diagram of the GitHub repository yha9806/academic-writing-toolkit, 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/yha9806/academic-writing-toolkit
- Repository: https://github.com/yha9806/academic-writing-toolkit

## Overview

AWT is a local-first toolkit for evidence-controlled academic writing, operated through agent skills and deterministic local checks. The principal workflow moves from reading and noting sources, through mapping and integrating evidence into chapters, to auditing claims and references, then author review and export. The scaffold creates a thesis workspace; audit scripts provide internal validation. README-described skills are included, but their implementation is not present in the supplied tree. The experimental writing loop and archived governance tools are excluded because they are not part of the current main product.

Main entry points: [`.claude/skills`](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills) (Audit manuscript), [`scaffold/awt.mjs`](https://github.com/yha9806/academic-writing-toolkit/blob/main/scaffold/awt.mjs) (Workspace scaffold), [`scripts/audit-citations.py`](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-citations.py) (Citation audit), [`scripts/audit-logic.py`](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-logic.py) (Logic audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Writing workflow"]
  node_readnote["Read and note<br/>[skills]"]
  node_notes["Reading notes"]
  node_map["Map sources<br/>[skills]"]
  node_integrate["Integrate evidence<br/>[skills]"]
  node_chapters["Chapter drafts"]
  node_review["Clean-room review<br/>[skills]"]
  node_export["Export<br/>[skills]"]
  node_deliverables["Word and ZIP"]
end

subgraph group_assurance["Evidence assurance"]
  node_audit["Audit manuscript<br/>[skills]"]
  node_citation_audit["Citation audit<br/>[audit-citations.py]"]
  node_logic_audit["Logic audit<br/>[audit-logic.py]"]
  node_content_audit["Content audits"]
  node_english_audit["English audit"]
  node_verify["Verify references<br/>[skills]"]
end

subgraph group_workspace["Workspace setup"]
  node_scaffold["Workspace scaffold<br/>[awt.mjs]"]
  node_workspace_files["Thesis workspace"]
end

node_author(("Author"))
node_agent(("Agent host"))
node_reference_service["Online metadata"]

node_author -->|"directs work"| node_agent
node_agent -->|"runs skill"| node_readnote
node_readnote -->|"writes notes"| node_notes
node_agent -->|"runs skill"| node_map
node_map -->|"reads notes"| node_notes
node_map -->|"maps coverage"| node_chapters
node_agent -->|"runs skill"| node_integrate
node_integrate -->|"reads evidence"| node_notes
node_integrate -->|"updates drafts"| node_chapters
node_agent -->|"runs checks"| node_audit
node_audit -->|"runs audit"| node_citation_audit
node_audit -->|"runs audit"| node_logic_audit
node_audit -->|"runs audit"| node_content_audit
node_audit -->|"runs audit"| node_english_audit
node_audit -->|"reads draft"| node_chapters
node_audit -->|"checks evidence"| node_notes
node_agent -->|"runs skill"| node_verify
node_verify -.->|"checks metadata"| node_reference_service
node_agent -->|"runs skill"| node_review
node_review -->|"reviews draft"| node_chapters
node_author -->|"checks findings"| node_review
node_agent -->|"runs skill"| node_export
node_export -->|"produces files"| node_deliverables
node_author -->|"requests setup"| node_scaffold
node_scaffold -->|"creates workspace"| node_workspace_files

click node_readnote "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_map "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_integrate "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_audit "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_citation_audit "https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-citations.py"
click node_logic_audit "https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-logic.py"
click node_content_audit "https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-public-content.py"
click node_english_audit "https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-british-english.py"
click node_verify "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_review "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_export "https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills"
click node_scaffold "https://github.com/yha9806/academic-writing-toolkit/blob/main/scaffold/awt.mjs"

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_readnote,node_notes,node_map,node_integrate,node_chapters,node_review,node_export,node_deliverables toneBlue
class node_audit,node_citation_audit,node_logic_audit,node_content_audit,node_english_audit,node_verify toneAmber
class node_scaffold,node_workspace_files toneMint
class node_author,node_agent,node_reference_service toneIndigo
```

## Components

### Writing workflow

- [Read and note](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- **Reading notes**
- [Map sources](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- [Integrate evidence](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- **Chapter drafts**
- [Clean-room review](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- [Export](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- **Word and ZIP**

### Evidence assurance

- [Audit manuscript](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`
- [Citation audit](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-citations.py): `scripts/audit-citations.py`
- [Logic audit](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-logic.py): `scripts/audit-logic.py`
- [Content audits](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-public-content.py): `scripts/audit-public-content.py`
- [English audit](https://github.com/yha9806/academic-writing-toolkit/blob/main/scripts/audit-british-english.py): `scripts/audit-british-english.py`
- [Verify references](https://github.com/yha9806/academic-writing-toolkit/tree/main/.claude/skills): `.claude/skills`

### Workspace setup

- [Workspace scaffold](https://github.com/yha9806/academic-writing-toolkit/blob/main/scaffold/awt.mjs): `scaffold/awt.mjs`
- **Thesis workspace**

### Other components

- **Author**
- **Agent host**
- **Online metadata**

## Connections

- Author → Agent host: directs work
- Agent host → Read and note: runs skill
- Read and note → Reading notes: writes notes
- Agent host → Map sources: runs skill
- Map sources → Reading notes: reads notes
- Map sources → Chapter drafts: maps coverage
- Agent host → Integrate evidence: runs skill
- Integrate evidence → Reading notes: reads evidence
- Integrate evidence → Chapter drafts: updates drafts
- Agent host → Audit manuscript: runs checks
- Audit manuscript → Citation audit: runs audit
- Audit manuscript → Logic audit: runs audit
- Audit manuscript → Content audits: runs audit
- Audit manuscript → English audit: runs audit
- Audit manuscript → Chapter drafts: reads draft
- Audit manuscript → Reading notes: checks evidence
- Agent host → Verify references: runs skill
- Verify references → Online metadata: checks metadata
- Agent host → Clean-room review: runs skill
- Clean-room review → Chapter drafts: reviews draft
- Author → Clean-room review: checks findings
- Agent host → Export: runs skill
- Export → Word and ZIP: produces files
- Author → Workspace scaffold: requests setup
- Workspace scaffold → Thesis workspace: creates workspace