Scheduled Research Refresh — Prompt Template
What this is. The prompt block for a scheduled research refresh that tracks ONE specific topic you care about and reports what changed — and what explicitly did not change — since the last run.
How to use. Fill in your topic, your diff contract (include / exclude / what counts as new), and your source cadence (four named sources). The zero-state behavior and honesty rails are pre-written; leave them intact.
Read every source every run.
The prior-run summary does not excuse re-checking the sources. Paraphrasing yesterday is not research.
Prompt — copy this block
You are producing a research refresh for query <QUERY_ID>, topic “<ONE_SENTENCE_TOPIC>”.
The idempotency key is the run timestamp; the artifact filename stem is “run-<ISO_TIMESTAMP>”.
After writing the artifact, update <LATEST_SYMLINK_PATH> to point at this run.
OUTPUT CONTRACT
Produce a single Markdown file with exactly four sections, in this order:
1. Header line — run timestamp (ISO-8601 with offset), task name “Research refresh”, query ID, topic, prior-run timestamp (from <LATEST_SYMLINK_PATH> if it exists, else “none — this is the baseline”).
2. What changed since last run — a short, ranked list. No more than 8 sentences total across the section. Rank by relevance, not recency. If this is the baseline run (no prior), produce a one-paragraph snapshot of the topic as it stands today, 8 sentences maximum.
3. What explicitly did not change — one to three sentences naming points from the prior-run summary that are still accurate. This section prevents the “everything is new every week” bias.
4. Health footer — list the sources you searched and how many items you read per source. One line per source. If any source returned an error, say so.
DIFF CONTRACT <!-- fill this in for your topic -->
- Include: <SPECIFIC_INCLUDE_TYPES — e.g., “new primary-source filings, decisions, or hearings; new analyses from recognized scholars or national news outlets; official statements from named parties”>
- Exclude: <SPECIFIC_EXCLUDE_TYPES — e.g., “opinion columns in regional news; reposts or syndications of items already covered last week; commentary on commentary”>
- What counts as ‘new’: published or materially updated after <PRIOR_RUN_TIMESTAMP>. A piece updated since last run counts only if the update is substantive (new section, substantive correction, reversal) — not a minor edit.
SOURCE CADENCE
Every run, search ALL of the following. Do not shortcut by reading only the prior run’s summary.
- <SOURCE_1>
- <SOURCE_2>
- <SOURCE_3>
- <SOURCE_4>
Report in section 4 how many items you read per source.
ZERO-STATE BEHAVIOR
If after reading all sources no item matches the Include criteria, write:
“No meaningful changes since last run.”
Do not invent items to fill the section. Do not elevate items that match Exclude or do not count as ‘new’ to fill space. An empty section-2 is a valid and useful output.
HONESTY RAILS
- Read every source every run. The presence of a prior-run summary in <LATEST_SYMLINK_PATH> does not excuse you from re-checking the sources. If you only read the prior summary and skipped the sources, the run is invalid.
- Do not paraphrase the prior run in a way that makes it look like new work. New items come from this week’s reading, not from last week’s summary.
- Cite each item in section 2 with source and date. No uncited claims.
- If a source is unreachable, note the error in section 4 and continue with the other sources.
DELIVERY
Write the artifact to <ARTIFACT_PATH> (filename uses the run timestamp).
Update <LATEST_SYMLINK_PATH> to point at the artifact just written.
LOG
Append one line to <LOG_PATH>:
<ISO-8601 timestamp>, research-refresh, <query ID>, <status>, <artifact path>, $<cost>, <one-sentence message>
Fill-in checklist
- <QUERY_ID> — short, specific, not likely to collide with future queries. Examples: q-supreme-court-patel, q-ohio-bill-hb-42, q-electric-aircraft-certification.
- <ONE_SENTENCE_TOPIC> — what you are tracking. Specific. Not “AI news” — instead, “the specific proposed rulemaking from the FAA on civilian eVTOL type certification.”
- <LATEST_SYMLINK_PATH> — e.g., ~/ai-architect-academy/automation/research/q-supreme-court-patel/latest.md.
- <SPECIFIC_INCLUDE_TYPES> — for your topic specifically. Write in concrete terms: primary sources, named scholars, specific outlets.
- <SPECIFIC_EXCLUDE_TYPES> — likewise concrete: the genres of content that always feel relevant but rarely are.
- <PRIOR_RUN_TIMESTAMP> — the agent reads this from the prior-run file at runtime; leave the placeholder.
- <SOURCE_1..4> — list four specific sources the agent should query. Use specific URLs, site names, or research tools, not “the internet.”
- <ARTIFACT_PATH> — ~/ai-architect-academy/automation/research/q-<your-id>/run-<ISO_TIMESTAMP>.md.
- <LOG_PATH> — ~/ai-architect-academy/automation/research/q-<your-id>/log.txt.
Three example diff contracts (reference — adapt to your topic)
Example A — tracking a specific court case
- Include: new filings, orders, or decisions in the docket; coverage in major national or legal press (e.g., SCOTUSblog, Reuters legal, major law school blogs) by named attorneys or legal scholars.
- Exclude: opinion columns in regional or partisan news outlets; social-media commentary; aggregator sites that repost without original analysis.
- What counts as ‘new’: filed, entered, or published after the prior-run timestamp.
Example B — tracking a specific legislative bill
- Include: committee hearings, markups, votes, new amendments, CBO scores, named-sponsor statements, analysis by established think tanks.
- Exclude: advocacy-group press releases; partisan blog commentary; re-posts of earlier items.
- What counts as ‘new’: the legislative action occurred after the prior-run timestamp, or the analysis was published after that timestamp.
Example C — tracking a fast-moving technical topic
- Include: peer-reviewed papers, official company or agency announcements, reviews from named experts, reports from established research organizations.
- Exclude: marketing material; speculative commentary without data; reposts.
- What counts as ‘new’: publication date after the prior-run timestamp; preprints count if from recognized repositories.
A good diff contract is boring to write. Vague topics produce vague refreshes.