← Back to Course Hub

AI-assisted Review β€” The Plan

A three-part assessment: a Moodle quiz on writing + AI critical use, an agentic AI revision UI, and a teacher review with plain-text reports. Built to answer the AY 2025-26 evaluation feedback.

πŸ“… Fall 2025 β€” What We Did (and Learned)

A quick look back at the original AI-edit module and what last year's data told us, before the plan for this year.

The original module (AY 2025–26)

A Nuxt-based AI-assisted Review tool with three modes (briefing / training / assessment), student login, and manual rubric + API-key setup. Students revised their point-of-view essays with an AI and submitted their chat history.

ORIGINAL
Open the original app (live demo on Railway) β†’

What the data showed

  • 581 student sessions; 429 complete and analyzable.
  • Mean essay score rose +14.4 points (65.7 β†’ 78.9) after AI-assisted revision.
  • Deeper AI engagement correlated with bigger gains: the AI-rated interaction quality tracked essay improvement at Spearman ρ = +0.44 (p < 0.001), and the association held even after controlling for starting writing strength (partial ρ = +0.37) β€” so it isn't just that stronger writers engaged more.
  • Starting writing strength worked the other way: stronger writers improved less in absolute terms (ρ = βˆ’0.66), an expected ceiling effect.

Caveat: both the engagement and essay scores were AI-rated, and the result is correlational rather than causal β€” treat it as promising and worth re-checking against human-rated essays.

Presented at AI3L 2026 (Japan) β€” β€œStructured AI-Guided Essay Revision with Dual-Rubric Assessment” (Wang & Deng).

Honest verdict: moderately successful β€” we can do better

Last year worked: students improved and the β€œcritical review of AI suggestions” idea held up. But the evaluation also told us the module was fragmented (three modes, login, manual setup), the rubrics were vague, and the revision was unfocused. This year's design targets exactly those three weaknesses.

πŸ—ΊοΈ The Three-Part Flow

Everything is submitted through Moodle: a compulsory quiz, the AI revision activity, and a Moodle assignment that collects the work. Each stage feeds the next.

1

Moodle Quiz (5%)

Compulsory quiz with MC + short objective questions (understanding + API-key readiness).

PLANNED
2

Agentic AI Revision UI

Students paste their essay, pick one writing aspect, and get guided revision from an AI tutor that never writes for them β€” it coaches with questions and requires critical decisions.

LIVE (prototype)
3

Moodle Assignment (5%)

Students submit their revision work β€” revised essay, rubric-mapped report, and chat history β€” to a Moodle assignment in the main course room. Teachers download the cohort's submissions and review per section.

PLANNED

Assessment weighting (10% total)

πŸ“ Quiz (5%) β€” compulsory Moodle quiz on writing + AI critical use (Part 1)
πŸ“„ Assignment (5%) β€” Moodle assignment collecting the revised essay + report + chat history (Part 2)

πŸ“ Part 1 β€” The Moodle Quiz (5%)

A compulsory quiz of mostly multiple-choice and short objective questions: it checks understanding of the writing rubric and AI critical use, and confirms each student has their HKBU GenAI API key ready. The revision work itself is submitted via the Part 2 Moodle assignment.

Question types (auto-graded)

Multiple choice & short objective

Checks understanding of the writing rubric and how to use AI critically β€” e.g. β€œWhich is a strong thesis?” / β€œWhen should you reject an AI suggestion?”

API-key confirmation

A readiness gate, not a knowledge test β€” confirms each student has their own HKBU GenAI API key ready before they start revising.

How it works

1 Β· Compulsory (5%) β€” every student completes it before the revision activity.

2 Β· Auto-graded β€” MC and short objective questions are marked automatically, no manual marking.

3 Β· Checks readiness β€” confirms they understand the rubric and have their own HKBU GenAI API key.

4 Β· Leads into the revision β€” once done, students move to the revision UI, then submit via the assignment.

Accommodating different backgrounds

  • Getting the API key β€” every student sets up their own HKBU GenAI API key (one-time setup); the quiz confirms it's ready. The shared test code is for staff only, not students.
  • Less confident with AI? β€” the in-house tutor guides step-by-step; more confident students can use their own tool + the prompt pack.
  • Weaker writers? β€” they pick ONE aspect to work on, so the task is focused and achievable.

How many revision rounds?

A clear minimum keeps marking fair and the task focused:

Minimum 2 rounds β€” two AI suggestions, each followed by a decision (ACCEPT / REJECT / ADAPT) with a one-sentence reason, within the ONE chosen aspect. More rounds are welcome and strengthen the report, but 2 is the floor.

πŸ€– The Agentic AI Revision UI (the activity)

The activity students do before submitting. Students work with an AI tutor that guides them through targeted revision β€” never writing for them.

The student journey

1
Setup β€” choose question set, paste essay
2
Focus β€” pick ONE writing aspect (Content / Organisation / Vocabulary / Grammar)
3
Revise β€” AI tutor makes one suggestion at a time; student decides ACCEPT / REJECT / ADAPT with a reason
4
Submit β€” get the rubric-mapped report, then submit it + the revised essay + chat history to the Moodle assignment

The agent (six blocks)

1. Job β€” revise your point-of-view essay (bounded task)
2. Knowledge β€” rubrics + module material + your essay
3. Tools β€” chat turns (future: essay parsing, rubric matching)
4. Workflow β€” diagnose β†’ targeted revision β†’ report (revision-first, quiz-aligned)
5. Guardrails β€” hints-not-answers, Socratic 2-attempt rule, scaffolding
6. Evaluation loop β€” rubric-mapped report + teacher review

How the agentic AI tutor works

The revision-first workflow (quiz-aligned)

Students already completed the Moodle quiz on the writing rubric + critical AI use β€” so the tutor goes straight to revising.

  1. Diagnose β€” read the essay, give a short diagnostic, then ask the student to pick ONE writing aspect to revise (Content & Ideas / Organisation / Vocabulary / Grammar)
  2. Revise β€” targeted revision within that aspect only:
    • Offer ONE suggestion at a time (never a rewrite)
    • After each suggestion, ask the student to state their decision: ACCEPT, REJECT, or ADAPT, with a one-sentence reason
    • The critical-pickup of suggestions IS the learning goal β€” do not move on until the student has made and justified a decision
    • Repeat for at least a second suggestion β€” minimum 2 rounds within the same aspect
  3. Report β€” produce a structured revision summary mapped to the three AI-assisted Review rubric criteria, with CRITERION B (Critical Review) AS THE PRIMARY FOCUS

The guardrails (anti-ghostwriting)

  • Hints-not-answers β€” the tutor never rewrites the student's essay, paragraph, or sentence
  • Socratic 2-attempt rule β€” if asked "where is the thesis?" or "can you rewrite this?", guide them to find/attempt it first; only after 2 genuine attempts give a structural hint
  • Scaffolding dial β€” high (guided, step-by-step) / medium / low (independent)
  • Step-gating β€” the agent can't proceed to the next step until the student has genuinely completed the current one

Why this is an agent, not a chatbot

A chatbot responds to prompts. An agent has a bounded job, grounded knowledge, connected tools, a designed workflow, guardrails, and an evaluation loop. The tutor drives the student through a deterministic pipeline β€” it doesn't just chat.

Try the prototype

Open the revision UI β†’ Try it embedded on this site β†’

Hosted on Railway. Bring your own HKBU GenAI key (BYOK), or enter the test access code test2026 (staff only) to try it with our key. Anonymous β€” no login needed.

πŸ“„ Part 2 β€” The Moodle Assignment (5%)

After revising with an AI, each student submits their work to a single Moodle assignment in the main course room (all sections together).

What each student submits

1 Β· Revised essay

The final version, focused on their ONE chosen aspect (Content / Organisation / Vocabulary / Grammar).

2 Β· Rubric-mapped report

Generated by the in-house tutor (or written following the prompt pack's REPORT step) β€” mapped to criteria A / B / C with quoted evidence.

3 Β· Chat history (appendix)

The full student–AI transcript, so markers can verify the report against the conversation.

One submission per student: a single file upload (PDF) or Moodle online text with the three parts pasted in.

Why the main course room

  • One assignment for the whole cohort β€” all sections together, not per-section rooms.
  • Monitor everyone at once β€” a single completion + gradebook view across the cohort.
  • Bulk download β€” pull all submissions in one go for processing.

Then what happens

Download the submissions β†’ run them through a programme that parses each report β†’ send each teacher their own sections' preliminary reports.

πŸ–ΌοΈ Embedded Live β€” Right on This Page

We can embed the tutor directly here. GitHub Pages serves this page; the tutor's backend runs on Railway and is shown inside an iFrame. Try it below β€” no install needed.

The one-line embed code

<iframe src="https://stellar-nourishment-production.up.railway.app" width="100%" height="800px" style="border:none; border-radius:12px;" title="LANG0036 AI-assisted Review"></iframe>

Paste this into a Moodle Page, a course website, or any HTML editor. The UI runs on Railway; the iFrame is just a window onto it.

Why the backend isn't on GitHub Pages

GitHub Pages is a static file host β€” it can serve HTML, CSS, and JavaScript, but it cannot run a Node.js server or safely hold the HKBU GenAI API key. So the "brain" of the tutor runs on Railway, and any page (this one included) just displays it through an iFrame.

The iFrame is only a window β€” the agentic work happens on the other side.

🌐 Doing the Same Activity on Other Platforms

The revision activity isn't locked to our UI. Students can do it in any AI chat platform β€” including the HKBU GenAI chatbot UI β€” using a portable prompt pack.

πŸ€–

HKBU GenAI Chatbot UI

Students paste the portable prompt pack into the HKBU GenAI chat interface. Same workflow, same rubric, no extra setup.

OPTION
πŸ‹

DeepSeek / Doubao

Students paste the prompt pack into DeepSeek or Doubao. The AI follows the same three-step revision + critical-pickup workflow.

OPTION
πŸ’¬

ChatGPT / Claude / Gemini

Any OpenAI-compatible chat UI works. The prompt pack is platform-agnostic β€” the pedagogy travels with the text.

OPTION

Why offer multiple platforms?

βœ… No lock-in β€” students use what they have access to
βœ… Convenience is the differentiator β€” our UI adds the guided workflow + report; the prompt pack is the fallback
βœ… HKBU GenAI is the default β€” students already have accounts; no extra signup
βœ… Same rubric everywhere β€” the assessment criteria don't change with the platform

πŸ“‹ The portable prompt pack (copy-paste)

Paste this whole block into any AI chat, then replace the two placeholders. It encodes the same job, workflow, guardrails, and rubric as the in-house tutor.

You are my English writing tutor for the LANG0036 EEGC "AI-assisted Review" activity. I am revising MY OWN point-of-view essay. You coach me β€” you NEVER write for me. THE JOB Guide me through targeted revision of ONE writing aspect: Content & Ideas, Organisation, Vocabulary, or Grammar. We improve it one suggestion at a time. WORKFLOW β€” follow strictly, in order: 1. DIAGNOSE β€” read my essay, give a short diagnostic, then ask me to choose ONE aspect. 2. REVISE β€” within that aspect only: - Give ONE suggestion at a time (never a rewrite). - I must reply ACCEPT, REJECT, or ADAPT + a one-sentence reason. - Do NOT move on until I have decided and justified it. Do at least two. 3. REPORT β€” report mapped to three criteria, with B as PRIMARY: A. In-Depth Conversation β€” how deep our exchanges were. B. Critical Review of AI Suggestions (PRIMARY) β€” quote 1-2 of my decision statements. C. Refining Process β€” quote one before/after pair in my chosen aspect. End with one clear next step. GUARDRAILS β€” non-negotiable: - Never rewrite my essay, paragraph, or sentence. - Coach with questions, hints, and short example fragments (never my full text). - If I ask "can you rewrite this?", first ask me to attempt it; only after two genuine attempts give a structural hint. - Keep replies concise; end most replies with one question. MY ESSAY TASK: <PASTE YOUR TASK> MY ESSAY: <PASTE YOUR ESSAY> Begin with DIAGNOSE.

Full version (incl. a stepped 4-prompt variant and the two question sets) β†’ generic-chatbot-tutor-prompts.md

How similar is the learning experience?

A prompt reproduces the pedagogy, not the enforcement or tooling. Roughly 60–70% of the learning experience transfers for a motivated student.

Block Agentic platform Prompt-only chatbot
Jobβœ… enforced⚠️ soft β€” model may drift
Knowledgeβœ… injected⚠️ only what student pastes
Tools (report / submit / diff)βœ… automatic❌ manual copy-paste
Workflowβœ… step-gated⚠️ prompted, can be skipped
Guardrails (no ghostwriting)βœ… hard⚠️ soft β€” easily overridden
Evaluation loopβœ… link β†’ teacher β†’ data❌ no automatic loop

Recommendation: ship both. The platform is the recommended path (convenience + integrity + teacher review); the prompt pack is the equity fallback and an AI-literacy lesson (the prompt is the tutor's program).

πŸ‘©β€πŸ« Teacher Review (after submission)

Submissions land in the main course room assignment. A programme parses them and produces a preliminary report per section, which each teacher reviews in Moodle.

1 Β· Download

Pull the whole cohort's submissions from Moodle in one go.

2 Β· Parse

Run them through a programme that maps each to the rubric.

3 Β· Distribute

Send each teacher their own sections' preliminary reports.

What the teacher sees

πŸ“„ Rubric-mapped report

A. Conversation depth Β· B. Critical pickup (PRIMARY) Β· C. Refining process β€” with quoted evidence from the chat

πŸ’¬ Chat transcript

Full conversation between student and AI tutor

πŸ“₯ Plain-text download

One-click .txt export for records or Moodle feedback

The plain-text report format

LANG0036 AI-assisted Review Report ===================================== Student: [name / ID] Focus: Vocabulary Date: 2026-08-06 A. In-Depth Conversation (3/5) - 8 meaningful exchanges across diagnostic + revision - Student asked follow-up questions on word choice B. Critical Review of AI Suggestions (5/5) β˜… PRIMARY - "I reject this suggestion because it changes my meaning" - "I accept this because it makes the thesis clearer" - Student evaluated every suggestion with a reason C. Refining Process (3/3) - Before: "Climate change is a very serious problem" - After: "While individual actions alone cannot solve climate change, they are not completely useless" - Clear improvement in the targeted aspect Overall: 11/11 β†’ mapped to 10% of Writing assessment

βš–οΈ The Rubric (3 criteria Γ— 5 bands)

Weights A = 3 Β· B = 5 (PRIMARY) Β· C = 3 β†’ total 11, scaled to the 5% assignment. Full version in the Google Doc.

Criterion Weight What it scores
A. Negotiating with the AI 3 How actively the student engages the AI as a thinking partner β€” follow-ups, pushback, alternatives
B. Critical Review of AI Suggestions β˜… PRIMARY 5 Whether the student decides (ACCEPT / REJECT / ADAPT) and justifies each suggestion, instead of accepting blindly
C. Refining Process 3 Visible improvement in the ONE targeted writing aspect, shown as a before/after pair
A. Negotiating with the AI (weight 3)
BandDescriptor
1 β€” LimitedPastes the essay and accepts the first response; asks no questions; no real conversation.
2 β€” BasicOne or two brief exchanges; at most one simple question; mostly follows the AI's lead.
3 β€” DevelopingA few relevant follow-up questions; occasionally asks "why?" or for an example; some back-and-forth.
4 β€” ProficientSustained back-and-forth; asks "why?" and "what if I…?"; pushes back at least once; requests an alternative.
5 β€” ExcellentDrives a genuine negotiation β€” challenges suggestions with their own reasoning, proposes alternatives, and builds on earlier turns.
B. Critical Review of AI Suggestions β˜… PRIMARY (weight 5)
BandDescriptor
1 β€” LimitedAccepts every suggestion without comment; no reasons; no sign of evaluation.
2 β€” BasicAccepts most suggestions with only vague or generic reasons ("sounds good").
3 β€” DevelopingMakes decisions (ACCEPT / REJECT / ADAPT) on some suggestions, with brief reasons that may be generic.
4 β€” ProficientDecides on most suggestions with clear, text-specific reasons; justifies at least one rejection or adaptation.
5 β€” ExcellentDecides on every suggestion with a thoughtful, evidence-based reason; rejects or adapts where appropriate and explains how that preserves their own meaning and voice.
C. Refining Process (weight 3)
BandDescriptor
1 β€” LimitedNo genuine revision; the essay is unchanged, or the changes are copied straight from the AI.
2 β€” BasicMinimal, surface changes (a word or two); improvement is unclear.
3 β€” DevelopingSome revision in the chosen aspect; improvement is partial or inconsistent.
4 β€” ProficientClear improvement in the chosen aspect, shown by a before/after pair; the changes are the student's own.
5 β€” ExcellentStrong, meaningful improvement in the chosen aspect; the before/after shows real gains and the student can explain the change.

Why B is primary

The core skill of the AI-assisted Review is critical thinking about AI advice β€” not the AI doing the work. The tutor requires a decision (ACCEPT / REJECT / ADAPT) with a reason after every suggestion, and the report quotes those decisions as evidence. This is the anti-ghostwriting guarantee.

Targeted editing

Students focus on one writing aspect at a time (Content & Ideas, Organisation, Vocabulary, or Grammar). This makes the improvement visible and answers the evaluation feedback about insufficient scaffolding.

πŸ“‹ Platform-Neutral Instructions

The activity works with any AI chatbot of the student's choice β€” HKBU GenAI, ChatGPT, Claude, Gemini, DeepSeek, Doubao, and others. The rubric is identical; only the tool changes. Full version in the Google Doc.

For students

  1. Complete the Moodle quiz (Part 1, 5%).
  2. Open your AI tool and paste the tutor prompt.
  3. Paste your essay, then choose ONE aspect.
  4. Negotiate β€” for each suggestion reply ACCEPT / REJECT / ADAPT + a reason. Minimum 2 rounds.
  5. Ask for the report (rubric-mapped, quotes your decisions).
  6. Answer the reflection β€” aspect Β· a rejected/adapted suggestion Β· a before/after Β· what you learned.
  7. Submit to Moodle β€” chat history + revised essay (with original) + reflection.
Guardrails: the AI must never rewrite for you; you make every decision; keep the full chat β€” it is the evidence.

For teachers

The rubric is platform-neutral β€” A / B / C apply no matter which tool the student used.

Assess β€” run the Gen AI rater prompt over each submission, then review and adjust.

Look for β€” B: decisions + reasons Β· A: follow-ups & pushback Β· C: a genuine before/after.

Anti-ghostwriting checks

Verify the changes are the student's own; the reflection should explain them. Watch for AI rewrites accepted wholesale.

You are an assessment assistant for LANG0036 EEGC. Score this submission (chat + revised essay + reflection) on A. Negotiating with the AI (3), B. Critical Review (5, PRIMARY), C. Refining Process (3). For each: a score, a quoted piece of evidence, and a one-sentence justification. Then one comment (strength + improvement). Base every score on observable evidence only.

πŸ’¬ Feedback & Next Steps

This plan is ready for a small-group pilot. Share your thoughts.

Questions, suggestions, or concerns about the AI-assisted Review plan? We review all feedback.

Open GitHub Discussions β†’

Or email the course team directly.