PaperAssist

PaperAssist is a model-free research runtime and an OpenClaude / Claude Code plugin. It plans research, defines controlled experiments, prepares LaTeX writing tasks, reviews manuscripts and verifies releases — while the only language model is the AI harness you already run. PaperAssist ships no provider client, no API key handling and no model selection.

⚠️ Disclaimer: this project is for learning and research. Do not use it commercially. You are responsible for anything you produce with it.

Contents

• What changed in v4

• How it works

• Install as OpenClaude plugin

• Using the plugin

• Writing a paper: AI Harness → Paper-Assist

• Skills included

• Workspace layout

• Scientific integrity

• License

Related MCP server: FronyBoard

What changed in v4

How it works

flowchart LR
    U["Researcher / agent"] --> S["OpenClaude skill / MCP tool"]
    S --> P["Task pack<br/>plan.json + tasks + agent-brief.md"]
    P --> H["AI harness<br/>(OpenClaude, Claude Code)"]
    H --> R["Result file<br/>ideas.json / review.json / experiment.json / draft.tex"]
    R --> G["Import gate<br/>deterministic validation"]
    G --> A["Artifacts + SQLite memory"]

PaperAssist never generates text. It owns:

• Planning: packs, task lists, briefs, acceptance rules.

• Binding: protected experiment blocks, citations.

• Verification: citation keys, score ranges, artifact hashes, release gates.

Install as OpenClaude plugin

Tambahkan ke direktori plugin user OpenClaude:

cp -r . /c/Users/<you>/.openclaude/plugins/paper-assist

Atau clone langsung:

git clone https://github.com/mahdyarief/paper-assist.git ~/.openclaude/plugins/paper-assist

Lalu aktifkan:

cd ~/.openclaude/plugins/paper-assist
python -m pip install -r requirements-core.txt

Verifikasi MCP server:

python mcp_servers/stdio.py

Using the plugin

Plugin ini dideklarasikan oleh .claude-plugin/plugin.json. Skill dibaca dari skills/, dan MCP server paperassist berada di mcp_servers/stdio.py (JSON-RPC over stdio).

MCP tools (10):

Writing a paper: AI Harness → Paper-Assist

PaperAssist bukan generator teks. Alurnya:

1. Harness memanggil pack_scaffold (ideation / experiment / review / writing).

2. Harness membaca plan.json + agent-brief.md + tasks/*.json dari pack.

3. Harness melakukan pekerjaan (ide, uji, review, draft LaTeX).

4. Hasil diimpor kembali lewat pack_import / writing_import — gate deterministik dijalankan sebelum catatan disimpan ke SQLite dan .paperassist/.

Contoh (dari harness/agent, bukan konsol CLI):

# 1. Scaffold pack ideation
pack_scaffold { "workspace": "<ws>", "kind": "ideation", "topic": "...", "venue": "NeurIPS" }

# 2. Harness kerjakan task dari pack, lalu impor hasil
pack_import { "workspace": "<ws>", "run_id": "<id>", "import": "ideas.json" }

# 3. Writing pack untuk draft LaTeX
writing_pack   { "workspace": "<ws>", "topic": "...", "title": "..." }
writing_import { "workspace": "<ws>", "run_id": "<id>", "import": "draft.tex" }

Catatan: tool pack_scaffold, pack_task, pack_import, writing_pack, writing_import, dst. dipanggil assistant (OpenClaude / Claude Code) melalui MCP server paperassist yang sudah aktif sebagai plugin.

Skills included

Workspace layout

<workspace>/
├── .paperassist/
│   ├── paperassist.db          # workflows, claims, evidence, artifacts
│   ├── packs/<kind>/<run-id>/  # plan.json, agent-brief.md, tasks/, target
│   ├── ideation/<run-id>/      # validated ideas.json
│   ├── experiments/<run-id>/   # validated result.json
│   ├── review/<run-id>/        # validated review.json
│   ├── publication/
│   └── release_manifest.json
├── artifacts/
├── main.tex
└── references.bib

Scientific integrity

• No invented metrics, datasets, baselines, hardware or citations.

• Every quantitative claim must trace to a run, artifact or bibliography entry.

• Protected experiment blocks are author-owned and byte-preserved.

• Secrets are rejected at input, never written into a workspace.

License

MIT. See LICENSE.