persian-research-writing

Persian Research Writing

This skill runs Hamid Alaei's course «از صفر تا صد نگارش و انتشار مقاله علمی با کمک مسئولانه هوش مصنوعی» as a working method. The course's central rule: the student learns the logic of research first, and AI is a controlled assistant that makes that path faster and more accurate. It is never the author, never the judge of science, and never a source of facts.

Start by locating the student

1. Mode. The default is an analytical, documented review article (the course core, 79 sessions). The other modes are a systematic review (path B: PRISMA 2020 and Rayyan, plan only), a data or questionnaire article (path C, handouts 21-1 to 21-8), and a thesis. A thesis is usually questionnaire-based, not a review: build chapters 1 and 2 with core parts 3 to 8, then follow path C, where 21-1 chooses the design from the research question and the supervisor approves it. A review thesis stays in the core, and a systematic review thesis goes to path B. For a thesis, also read references/thesis-questionnaire.md.
2. Station. Look in the project folder (01 to 10) to see which deliverables exist, or ask. Continue from the last station the student finished. If an earlier deliverable is missing, name it and ask whether to make it now; go back only when the next step depends on it (a gap needs the literature matrix). Do not jump ahead: at the topic stage the deliverable is the 3-2 sheet (حوزه، موضوع محدودتر، مسئله احتمالی، سؤال اولیه), not hypotheses or scales. A full research design delivered too early was discarded in real use.
3. Supervisor. In a thesis the supervisor decides the topic and the method. Prepare clear options and questions for the next meeting instead of deciding for them. Use the supervisor's own work as one input; options built only around their constructs were rejected in real use.

Rules that protect the student

• No invented sources, citations, quotes, numbers, data or results. Treat every source an AI tool suggests as unverified until its DOI or journal page has been opened. One fabricated reference can sink a defense.
• No claim of novelty or of a definite gap until the literature matrix and evidence bank support it. Until then write «نیاز به بررسی دارد».
• Claim strength follows evidence. A relationship is not an effect, and cross-sectional data are not causal. Sessions 12-2 and 15-4 teach this.
• Log every AI use with the ai-log form in folder 09: date, tool, stage, purpose, input, and what the human checked or changed. The thesis or journal AI disclosure is written from this log.
• "Systematic review" may only be claimed after path B was actually carried out.
• The student's voice stays. AI drafts are raw material checked against the evidence bank. Do not help disguise AI authorship or evade AI detectors; the prompt book's section on this was removed on purpose.
• Versions. Never overwrite or delete a previous version. Name files with the course pattern «… ـ نسخه ۱» and «نسخه ۲».
• Persian text. If the persian-writing skill is available, use it for orthography (ZWNJ, Persian digits, ی and ک) and right-to-left documents.

Project dossier

python -B -X utf8 "<skill>/scripts/new_project.py" "<project folder>" --mode article --name "<student name>"

Use --mode thesis for a thesis. The scripts need Python 3.9 or newer and python-docx (pip install python-docx). This creates the ten folders, or reuses numbered folders that already exist (also when written with Persian digits, as session 01-1 names them), and adds the status form (01), the topic sheet (02) and the AI log (09). It never overwrites a file. Folders: 01 وضعیت اولیه و برنامه مسیر · 02 ایده‌ها و انتخاب موضوع · 03 جستجو و کلیدواژه‌ها · 04 منابع علمی · 05 مطالعه و تحلیل منابع · 06 جدول‌ها و ماتریس تحلیل · 07 مجله هدف و ضوابط نگارش · 08 پیش‌نویس مقاله · 09 گزارش استفاده از هوش مصنوعی · 10 نسخه نهایی و ارسال. In thesis mode, 07, 08 and 10 become ضوابط دانشگاه و مجله هدف، پیش‌نویس پروپوزال و فصل‌ها، نسخه نهایی و دفاع.

The path

Session handouts are in references/sessions/PP-S.md (for example 03-2.md is session ۳-۲). The station pass criteria and every session's output are in references/course-plan.md (search «ایستگاه»). The plan lists the path decision (Decision Form) under 18-4, but the written 18-4 handout covers journal formatting; take the path decision at station 17, the end of the core.

Part	Question	Sessions	Station deliverables
1	What is an article, and what will I produce?	01-1 to 01-4	status form, article anatomy (station 0)
2	Where does AI help, and where is the ethical line?	02-1 to 02-3	ethics charter, prompt template, AI log (station 1)
3	How do I find a suitable topic?	03-1 to 03-7	idea list, topic sheet, limitations table, topic scoring, problem statement and exploratory question (station 2)
4	How do I search for and select sources?	04-1 to 04-6	keyword table and Boolean string, search log, selection criteria (station 3)
5	How do I get full texts and manage them?	05-2 to 05-4 (5-1 left out, see below)	PDFs, Zotero library, Word citations, manuscript master file (station 4)
6	How do I read and understand papers?	06-1 to 06-6	reading cards, method recognition, verification notes (station 5)
7	Which sources are stronger?	07-1 to 07-4	seed paper and citation network, quality form, core source set (station 6)
8	How do I get from sources to a gap and a final question?	08-1 to 08-5	literature matrix, themes, synthesis paragraphs, gap, final question, evidence bank (station 7)
9	Which journal am I writing for?	09-1 to 09-4	target journals, article type check, journal checklist (station 8)
10	How do I design the structure and the Method?	10-1 to 10-3	outline, method, evidence map (station 9)
11	How is the article table built?	11-1 to 11-4	table plan and verified table (station 10)
12	How do I write scientifically?	12-1 to 12-6	claim-level exercises, paraphrase and integrity, synthesis paragraph (station 11)
13	How is the Introduction written?	13-1 to 13-4	approved Introduction (station 12)
14	How is the analytical body written?	14-1 to 14-4	thematic body (station 13)
15	How is the Discussion written?	15-1 to 15-6	interpretation, conflicts, implications, limitations (station 14)
16	How is the Conclusion written?	16-1 to 16-2	Conclusion (station 15)
17	How are the Abstract, Title and Keywords prepared?	17-1 to 17-3	front matter (station 16)
18	How is the article audited and the next path chosen?	18-1 to 18-4	claim audit, final audit, decision form (station 17)
A	How do I prepare and submit?	19-1 to 19-5	submission package, AI disclosure, cover letter, reviewer response
B	How do I run a real systematic review?	plan only	see course-plan.md
C	How do I run and write my own data study?	21-1 to 21-8	research design map, data collection and ethics plan (Ethics Check after 21-2), reporting checklist and Methods, data dictionary and cleaning log, quantitative report, qualitative table (Analysis Approval after 21-6), results and figures, research manuscript (final station after 21-8); then submission through path A

Known gaps in the core handouts

The core handouts are the course text as written. Apply these corrections when you use them:

• Folders. Session 01-1 defines the ten folders, but later handouts name folders after course parts. Map them: «۰۵ ـ PDF منابع» to 04; «۰۶ ـ Reading Cards», «۰۷ ـ گسترش منابع و کیفیت شواهد» and «۰۴ ـ مطالعه و استخراج از منابع» to 05; «۰۸ ـ ماتریس و سنتز منابع» and «۱۱ ـ جدول‌ها و نمایش شواهد» to 06; «۰۹ ـ مقصد نگارش و ژورنال» to 07; «۱۰ ـ Method و Outline مقاله» and the writing folders «۱۲» to «۱۷» to 08; «۱۸ ـ ویرایش و ممیزی نهایی» to 10. Folders 02, 03 and «۰۹ ـ گزارش استفاده از هوش مصنوعی» keep their numbers.
• Station deliverables with no handout of that name (Verification Notes, Type Confirmation, Table Verification, Final Audit Report): accept the handout output that covers the same check and name the file that covers it. Station 17's Final Audit Report gathers the Content Review and Claim Audit (18-1), the Citation & Reference Check (18-3), the Journal Formatting Check (18-4) and a last check of the AI log.
• Path A after path B or C. Path A was written for the core's documented analytical review. For a systematic review or a data study, use the real article type in the journal fit, cover letter, statements and reviewer responses, and skip the checks that only concern a review.
• Full texts. Session 5-1 is left out of this skill because it teaches download services that get around publishers' paywalls. Get a full text from the publisher's page, a PDF link in Google Scholar, Unpaywall or CORE, an accepted manuscript or preprint in a repository, the author's page, the university library, or a short request to the author. Name each file AuthorYear_ShortTitle.pdf (one still missing as Pending_Topic_01.pdf) and save it in folder 04.
• Zotero duplicates (05-2, 18-3): merge them with Merge Items instead of deleting one, so citations already in Word, notes, tags and collections stay attached.
• Uploads to AI tools (06-4, 06-6, 09-4, 19-5): a full text goes into NotebookLM or another online tool only when its licence or the publisher's terms allow it, for example an open access copy under a CC licence; otherwise use the student's own notes and the abstract. Before giving a decision letter or reviewer report to an AI tool, check the journal's policy and remove identifying details.
• Design cues (07-3): the word "survey" alone does not show a cross-sectional design; confirm that the data were collected at one point in time.

Working through one step

1. Read that session's file. Every session follows the course pattern: why the skill matters, the concept, the standard method without AI, the AI-assisted method, error control, the instructor's demonstration on the course's fixed sample topic (night-time social media use and students' sleep quality), the student's own run, and the deliverable.
2. Apply it to the student's topic, not to the sample topic.
3. Produce the deliverable, either as a form (below) or as text, and save it in the right folder with a version number.
4. Add a row to the AI log, and list what the student must verify before relying on it.
5. Check the station's pass criteria before moving on. At the Ethics Check after 21-2, a pending ethics-code request is enough to go on to 21-3; only the pilot and data collection wait for the code. A path C row that does not apply to the approved design (no open-ended question, or a hypothesis the supervisor dropped) is marked «کاربرد ندارد» with its reason.

Forms

python -B -X utf8 "<skill>/scripts/make_form.py" list
python -B -X utf8 "<skill>/scripts/make_form.py" <form-id> "<out.docx>" [--rows N] [--font Vazirmatn]

These are right-to-left Word forms with fixed course columns (definitions in assets/forms.json, default font Vazir). The script never overwrites an existing file; give each new version its own name. The ids are: status-form (۱-۱), prompt-template and ai-log (۲-۳), topic-sheet (۳-۲), limitations (۳-۵), topic-scoring (۳-۶), keywords (۴-۲), search-log and selection-criteria (۴-۶), reading-card (۶-۱), quality (۷-۳), matrix (۸-۱), evidence-bank (۸-۵), journal-checklist (۹-۳), outline (۱۰-۱), and for path C research-design (د-۱), ethics-plan, instruments and the ethics-check station (د-۲), reporting-checklist (د-۳), data-dictionary and cleaning-log (د-۴), analysis-log (د-۵), codebook, qualitative-table and the analysis-approval station (د-۶), consistency-check (د-۷), final-audit (د-۸). Path C outputs go in the folder «مسیر C ـ مقاله پژوهشی دارای داده», which new_project.py --mode thesis creates; for an article student who chose path C in 18-4, run new_project.py again on the same folder with --path-c (existing files are kept). To fill a form with content, generate it first and then write the rows with python-docx, keeping the right-to-left helpers in scripts/docx_fa.py. If persian-writing's verify_docx.py reports that <w:bidi/> is not the first child of sectPr on these files, that is a false positive (it sits before docGrid, the schema order); do not run its --fix on them. On Windows keep full paths under 260 characters.

Tools the course uses

Stage	Tools
Assistant	ChatGPT; Claude, Gemini and Perplexity as alternatives
Search	Google Scholar and the field's own database; Search Smart for choosing databases; Elicit for semantic search; Consensus and scite as supplements
Full text and references	Unpaywall and CORE; Zotero for the library and Word citations
Reading	SciSpace, Scholarcy and NotebookLM; AetherBrain, Explainpaper and OnlineDocTranslator for difficult passages
Mapping	ResearchRabbit; Connected Papers and Litmaps as options
Writing and editing	ChatGPT Canvas or Claude; Paperpal or Writefull for academic language
Systematic review	PRISMA-P, PRISMA-S, PRISMA 2020 and Rayyan (path B only)

Persian sources for a thesis are in SID, Magiran, Noormags and IranDoc.

Prompt book

references/prompt-library.md holds the course's prompt book of 39 sections, from idea discovery to reviewer response. Its session numbers belong to the older course version. Prompts that match the final course are inside each session file.

Honest limits

The skill does not guarantee acceptance or publication. Complex analyses still need a methodologist. The researcher, not the AI, owns every claim, source and number.