Exercise: Context Engineering in the Writing Process

Learning Objectives

By the end of this exercise, you will be able to:

  • Understand and try out a workflow for an AI-assisted writing process.
  • Experience how relevant context influences the quality of a text.
  • Practice a human-in-the-loop workflow: review evidence, make decisions, and approve revisions.

Write a press release about a scientific paper you can evaluate. You will compare three versions: a first draft based on the paper alone, a draft using your prepared context, and a version improved through your review.

How to Work

Choose a full paper you understand well. Follow the time budget set in the workshop. Keep the preliminary draft in its own chat, use one working chat for Steps 1–6, and move the reviewed materials into a project in Step 7. Step 3 uses separate chats for prompt design and research.

Markdown (.md) is a text-file format with simple headings and lists. Download the requested files after checking them. If the tool cannot create a file, save its complete Markdown output with the stated filename. Update an existing file when a later step improves it.

Each step names its chat, required materials, and result. In a new chat, provide those materials again. If important information is missing, let the AI ask before proceeding.

Use the support approaches we discussed in the training. Their explanations are in the document on AI support approaches, especially the Reflection Assistant and Information Retrieval. The complete Reflection Assistant role prompt is included in Step 1.

For a reflection step, combine that role prompt with the step prompt in one message. Each later prompt explicitly changes the support approach. The tags organize the prompt; you do not need to write code.

Example: Combining a Role, a Goal, and Context

Prompt

<role>
Act as my Reflection Assistant. Ask one question at a time and leave the
decision to me.
</role>
<goal>
I am writing a press release about the attached paper. Help me clarify what I
want it to achieve and why I am communicating now.
</goal>
<context>
Use the attached full paper. If it is missing or unreadable, ask me to upload it
before starting.
</context>

Preliminary Exercise: Create a First Draft

Where: A separate chat.

Input: The full paper only.

Output: 00_initial_press_release.md.

Generate the draft, save it, and start a different chat for the workflow. Keep this draft outside the working chat and project until Step 10. Use the same AI model and 400-word length for the later draft.

Prompt

Write a 400-word press release in American English using only the attached
paper. Do not invent facts or quotations, or ask for additional communication
context. If the paper is missing or unreadable, ask me to upload it. Provide the
headline and body as 00_initial_press_release.md.

Workflow at a Glance

  1. Clarify the Goal and Reason for Communicating Now
  2. Identify the Audience
  3. Develop a Press Release Guideline
  4. Identify Stakeholders and Requirements
  5. Summarize and Check the Paper
  6. Develop the Main Message and Storyline
  7. Create a Project and Upload the Context
  8. Generate the Press Release
  9. Check and Revise the Text
  10. Discuss Context and Human Decisions

1. Clarify the Goal and Reason for Communicating Now

Where: A new working chat.

Input: Upload the same full paper again.

Output: 01_communication_brief.md: goal, reason for communicating now, and signs of success.

AI Support Approach: Reflection Assistant

Clarify the intended effect of the release. The paper gives the scientific context; it does not determine your communication goal.

Copy this complete role prompt for the reflection steps and add the relevant step prompt. Its explanations are in the document on AI support approaches. The step prompts set the specific goal and limit the dialogue for this exercise.

Show the Complete Reflection Assistant Role Prompt

Prompt (Rolle)

<role>
You act as my Reflection Assistant. You support me with targeted questions,
critical feedback, and perspective shifts so I can reflect on my goals, values,
priorities, and actions. Do not hand me ready-made solutions; instead, foster my
self-reflection to build clarity.

Core functions:
* Ask only one question at a time; proceed after I answer.
* Ask focused questions to clarify values, goals, and motives.
* Use systemic questioning techniques when useful, e.g.:
  - Circular questions ("How would person X see this?")
  - Scaling questions ("On a scale from 1–10, how close am I to my goal?")
  - Hypotheticals ("What would be different if I had already achieved it?")
  - Resource-oriented ("What strengths did I use in similar situations?")
  - Solution-focused ("What first steps are possible, even tiny ones?")
* Offer coaching methods if they fit.
* Give critical feedback by surfacing contradictions, blind spots, or patterns.
* Support decisions via pros/cons, scenarios, or matrices.
* Run retrospectives (e.g., end of week/project): "What went well? What did I
  learn? What will I change?"
* Check whether my current goals and actions align with long-term values.
* Offer alternative viewpoints without undermining my ownership.

Goal: Help me gain self-awareness, clarity, and orientation so I can act more
focused and values-based over time.

Important: Be neutral, respectful, and inquiry-driven. Your focus is to mirror
and probe, not to take over my decisions or deliver ready-made answers.
</role>

Prompt

<goal>
I am preparing a press release about the attached scientific paper. Help me
define what the release should achieve and why I am communicating now.
</goal>
<context>
Read the attached paper to understand its topic and main findings. If it is
missing or unreadable, ask me to upload it.
</context>
<instructions>
Use the Reflection Assistant approach. Ask one question at a time, starting with
what I want to achieve. Probe vague answers and examine tensions between
visibility, public understanding, and accuracy. After three to five questions,
summarize a provisional communication brief for me to check. Do not draft the
release. After my corrections, provide 01_communication_brief.md.
</instructions>
Your Check: Choose the goal yourself. Does it give you a useful basis for deciding what the text should emphasize?

2. Identify the Audience

Where: Continue in the working chat.

Input: Paper and approved communication brief.

Output: Update 01_communication_brief.md with the selected audience and implications for writing.

AI Support Approach: Reflection Assistant

Prompt

<goal>
For this press release, help me choose whom I want to reach and what that means
for the text.
</goal>
<instructions>
Continue as a Reflection Assistant using the paper and approved goal.
Distinguish the journalists or outlets I want to reach from the people who will
read their reports. Explore interests, prior knowledge, and likely questions;
distinguish evidence from assumptions. Ask one question at a time. After three
to five questions, propose a summary for my review. Once I confirm it, update
01_communication_brief.md with the audience profile and three consequences for
content or language. Ask for essential missing inputs only.
</instructions>
Your Check: Select a primary audience. Check whether it fits your goal and keep untested assumptions visible.

3. Develop a Press Release Guideline

Where: Separate chats for prompt design and research; bring the reviewed guideline back to the working chat.

Input: No uploads required; this step researches general guidelines for scientific press releases.

Output: 03_research_prompt.md and 03_press_release_guidelines.md.

AI Support Approach: Information Retrieval, prepared through metaprompting

Metaprompting means asking AI to design the prompt you will use for a later task. Start a separate prompt-design chat and use this short prompt:

Prompt

Create a self-contained research prompt for a comprehensive, practical guide to
scientific press releases, including understandable language. Make the decisions
needed to plan the research and structure the guide. If you are unsure about an
important decision, ask me and wait for my answer before producing the prompt.
Require the research result as 03_press_release_guidelines.md. Provide the
prompt as 03_research_prompt.md and also display its full text in the chat. Do
not conduct the research.

Review the generated prompt, then choose one research route:

  • Deep Research: Run the prompt in a separate chat with a tool that searches and compares sources.
  • Two AI Systems: Give both systems the same research prompt. Let them research independently, then give both reports and source links to one system for comparison.

Review the guide for completeness and verify its supporting sources. If the research cannot finish within the workshop time, keep a provisional guideline with unresolved points clearly marked.

Comparison Prompt — Only If You Use Two AI Systems

Prompt

Analyze the two research reports in detail and produce a verified, comprehensive
guide to scientific press releases. Ask for a missing report before starting.
Use web research to resolve contradictions and check completeness. If web access
is unavailable, tell me before proceeding.

1. Analyze the differences. Create a detailed comparison table showing what each
report says, substantive differences and omissions, supporting evidence, and the
implications for the guide. Distinguish contradictions from recommendations that
apply in different contexts.

2. Investigate contradictions. Research credible, relevant sources, prioritizing
original guidance from established science communication organizations, press
offices, and journalism organizations. Check the actual source passages. Decide
which claim is correct or best supported, or explain when both apply in
different contexts. Document each conclusion with its evidence, source links,
and relevant passages. Agreement between reports is not proof. Keep unresolved
contradictions visible if the evidence is insufficient.

3. Build the guide. Combine the supported findings into a comprehensive, clearly
structured guide with practical explanations, examples, and a checklist.

4. Run a final quality check. Search authoritative guidance beyond the two
reports to identify important topics missing from either or both. Check the
completed guide for completeness, accuracy, consistency, and practical
usefulness. Add missing content with sources and record any remaining gaps or
uncertainties.

Provide 03_press_release_guidelines.md with the guide first, followed by the
detailed comparison, evidence for resolving contradictions, and final
quality-check findings. I will review and approve it.
Your Check: Open the sources. Confirm that they support the recommendations you adopt; agreement between AI systems does not establish accuracy.

4. Identify Stakeholders and Requirements

Where: Working chat with web access.

Input: Paper, communication brief, guideline, institution, and relevant funding information.

Output: 04_stakeholders_and_requirements.md: interests, applicable rules, sources, and open questions.

AI Support Approach: Reflection, followed by Information Retrieval

Consider researchers, the press office, collaborating institutions, and any funder. Keep documented requirements separate from assumed interests.

Prompt

<goal>
Identify whose interests and requirements we must consider when writing this
press release.
</goal>
<instructions>
Start as a Reflection Assistant: ask up to three questions, one at a time, about
relevant stakeholders and competing interests. Then switch to Information
Retrieval and research applicable institutional and funder guidance using
official sources. Ask for the institution or funding program if missing. Check
required information, acknowledgments, writing guidance, timing, and approvals.
Record each item as a requirement, recommendation, documented objective, or
assumption, with its source, date, and applicability. Flag conflicts for my
decision. If information is unavailable, record a question to clarify. Provide
one file, 04_stakeholders_and_requirements.md.
</instructions>
Your Check: Check the applicable sources and decide on priorities. For this exercise, an unresolved requirement can remain an open question; if needed, agree on a clearly labeled workshop assumption. It must not appear as a verified rule.

5. Summarize and Check the Paper

Where: Working chat.

Input: Full paper, supplements if needed, and communication brief.

Output: 05_checked_paper_summary.md: reviewed summary, central claims with evidence, and expert corrections.

AI Support Approach: Information Retrieval from supplied material and Automation

You are the experts on the content. Check the summary before using it to build the story.

Prompt

<goal>
Prepare a summary of the attached paper that I can check before writing the
press release.
</goal>
<instructions>
Switch to summarizing the supplied material. Use only the paper and supplied
supplements; ask for missing essential files. Provide the main scientific
message, a summary of up to 250 words, and up to five central claims with
locations in the paper and their important conditions and limitations.
Separately explain which findings may matter to our goal and audience.
Distinguish results, the authors' interpretation, and possible applications.
Preserve decisive numbers and uncertainty. Provide 05_checked_paper_summary.md;
identify it as awaiting my expert review until I approve it.
</instructions>
Your Check: Verify the main claims, numbers, conditions, and limitations in the paper. Correct misleading emphasis or overstated applications. Confirm the audience relevance yourself.
Correction Prompt — If the Summary Needs Changes

Prompt

Use my expert corrections to revise 05_checked_paper_summary.md. Ask for them if
I have not provided them. Flag any conflict with the original paper and give its
location. Update the summary and include a short correction record. Ask me to
confirm the reviewed version.

6. Develop the Main Message and Storyline

Where: Working chat.

Input: Checked paper summary, communication brief, guideline, and stakeholder requirements.

Output: 06_storyline.md: chosen main message, sequence of points, and important conditions and limitations.

AI Support Approach: Idea Generator, followed by Reflection

The main message is the single most important point readers should understand and remember. The storyline is the order in which you explain it.

Copy this role prompt and add the step prompt below. Its explanations are in the document on AI support approaches.

Show the Complete Idea Generator Role Prompt

Prompt (Rolle)

<role>
You act as my Idea Generator. The point is not to analyze or organize my
thinking but to spark creativity and broaden my horizon. Offer new perspectives,
develop unusual ideas, break patterns, and connect across domains.

Approach:
* Provide surprising and unconventional thoughts, even if they seem unusual at
  first.
* Use second/third-order associations and analogies from other fields.
* Challenge norms, routines, and assumptions; offer alternative views.
* Vary, combine, and evolve ideas, not just list isolated suggestions.
* Present multiple possible directions to choose from.
* Cluster ideas by themes when helpful for overview.

Important Notes:
* Do not repeat or paraphrase my prompt.
* Be exploratory, not final—this is about impulses, not finished solutions.
* Keep a professional tone even for unconventional ideas.
* One-liners or brief lists are fine if they have substance.
</role>

Prompt

<goal>
Develop a scientifically accurate main message and storyline for our press
release.
</goal>
<instructions>
Switch to Idea Generator. Use the reviewed materials to propose three distinct
angles, each with a one-sentence main message, an opening, and the order of the
main points. Preserve important conditions and limitations. Ask for essential
missing materials rather than inventing them. Let me choose an angle. Then
switch to Reflection Assistant and ask up to three questions, one at a time, to
test its relevance and scientific accuracy. After my decision, provide
06_storyline.md with only the selected story, its rationale, and the limitations
to preserve.
</instructions>
Your Check: Choose the story and check its central claim against the paper. Keep the alternatives in the chat; the selected story goes into the project.

7. Create a Project and Upload the Context

Where: A new AI project.

Input: Full paper and all reviewed context from Steps 1–6.

Output: The populated project and 07_project_instructions.md, including an overview of its materials.

AI Support Approach: Structuring & Organizing Assistant

Create a project and upload the paper, reviewed communication brief, guideline and research prompt, stakeholder requirements, checked summary, and selected storyline. Keep the first draft outside this project. If your tool has no project feature, use a dedicated chat with the same materials.

Copy this role prompt and add the step prompt below. Its explanations are in the document on AI support approaches.

Show the Complete Structuring & Organizing Assistant Role Prompt

Prompt (Rolle)

<role>
You act as my Structuring & Organizing Assistant. Your job is to help me
turn messy tasks, projects, and information into clear, actionable structures.

Core functions:
* Decompose complex endeavors into manageable steps phrased so I can execute
  them.
* Expose task dependencies and logical sequences.
* Help assess importance and urgency to derive clear priorities.
* Develop structured plans (e.g., day plans, weekly overviews, roadmaps) that
  consider deadlines, buffers, and sensible flows.
* Translate unstructured inputs (e.g., brainstorming notes, meeting minutes,
  idea dumps) into concrete to-dos with owners and dates.
* Present results in clear, easy-to-read formats such as to-do lists, tables,
  roadmaps, or text-based visualizations (e.g., Gantt/mind map structures).

Goal: Reduce complexity, create overview and clarity, and provide a reliable
working base.

Important: You focus exclusively on organization, structuring, and
prioritization—not on doing the content work. Your plans remain flexible and
adapt to my constraints (available time, parallel projects, deadlines).
</role>

Prompt

<goal>
Organize our reviewed materials into a coherent basis for writing the press
release.
</goal>
<instructions>
Switch to Structuring & Organizing Assistant. List the files you can access
and what each contributes. Check for missing materials, conflicting
instructions, and unclear versions; ask me to resolve substantive conflicts. Use
the full paper as the scientific reference and our checked summary to guide
emphasis. Propose short project instructions covering the goal, audience, story,
writing criteria, applicable requirements, and missing information. Include the
materials overview in 07_project_instructions.md. Wait for my approval before
drafting.
</instructions>
Your Check: Verify the file overview and instructions. Upload corrections and adopt the approved instructions in the project settings.

8. Generate the Press Release

Where: Inside the project.

Input: Reviewed project materials and approved instructions.

Output: 08_context_draft.md: the 400-word release, followed by separate editorial notes.

AI Support Approach: Automation Assistant

Prompt

<goal>
Write our scientific press release using the approved context and decisions.
</goal>
<instructions>
Generate a 400-word release in American English with a headline and body. Apply
the selected story, audience, guideline, and requirements. Preserve checked
claims and limitations. Use only scientific claims supported by our materials
and verified, approved quotations. Mark missing details as TO CONFIRM. Ask
before drafting if an essential input or substantive conflict remains
unresolved. Provide 08_context_draft.md. After the release, add a separate
Editorial Notes section with locations supporting the main scientific claims and
any open items. These notes are not part of the release. Keep this version
unchanged for the comparison later.
</instructions>
Your Check: Read the draft against your goal and record the main issues for the next step. This is the version produced with context, before revision.

9. Check and Revise the Text

Where: Inside the project.

Input: 08_context_draft.md, original paper, guideline, brief, and requirements.

Output: 09_review_record.md and 09_final_press_release.md.

AI Support Approach: Reflection Assistant for text review, followed by Automation

Prompt

<goal>
Identify the changes this release needs before I approve a final version.
</goal>
<instructions>
Check scientific accuracy against the paper; assess the main message, audience
fit, and understandable language; check applicable requirements. Ask for missing
materials if needed. List material issues with the passage, evidence or
criterion, suggested change, and priority. Highlight the three most important
improvements. Provide 09_review_record.md and wait for my decisions. Do not
revise the text yet.
</instructions>
Your Check: Verify substantive findings in the paper. Decide which changes to adopt. Where possible, ask another participant to read for clarity.
Revision Prompt — After You Have Chosen the Changes

Prompt

Switch to Automation Assistant and apply only the changes I approved. Ask for my
decisions if they are missing. Flag a requested change that conflicts with the
paper before applying it. Provide 09_final_press_release.md and update
09_review_record.md with the approved changes and remaining open items. Preserve
08_context_draft.md for comparison.

Complete the revision after your review. For actual publication, follow the institution’s approval process.

10. Discuss Context and Human Decisions

Where: Group discussion.

Input: Initial draft, context draft, final release, and review record.

Output: Three shared observations; no additional file is required.

Compare the initial draft with the context draft to discuss context and instructions. Compare the context draft with the final release to discuss human review. Use scientific accuracy, clarity, and the main message as shared criteria. Consider audience fit in light of the context each version actually received. One comparison helps you explore changes; it does not isolate their causes.

  1. Which differences between the initial and context drafts can you connect to specific context or instructions, and what examples support your interpretation?
  2. Where did your scientific judgment or communication decisions improve the context draft, and what might have gone wrong without your review?
  3. How would you build a similar workflow for another writing process, and what would you need to change?

Further Reading