Manuel B. Garcia

Manuel B. Garcia serves as the Senior Director for Educational Technology and Digital Learning at FEU Institute of Technology, Manila, Philippines. Read More

Contact Info

1607, FEU Tech Building,
P. Paredes St, Sampaloc,
Manila, Philippines
mbgarcia@feutech.edu.ph

Follow Me

Should Researchers Document AI System Instructions When They Are Available?

System instructions can influence an AI model's responses even when researchers submit identical prompts. Learn which instructions to document, how to preserve them, and how to report instructions that are unavailable.

886
Documenting AI System Instructions Guide 886 of 1196
01 · The Question

Should You Record the Instructions Governing an AI System You Study?

You submit the same research prompt to two AI systems. Both use comparable language models, yet their answers differ substantially. One refuses to complete the task, while the other provides a detailed response. Is the difference attributable to model capability, or could instructions operating behind the interface explain it?

Researchers studying generative AI often document their prompts and model names while overlooking the system-level instructions that may shape responses before the user's prompt is processed.

This raises a methodological question: when system instructions are available, should they become part of the research record, and what should researchers do when those instructions are inaccessible?

02 · The Short Answer

Document Available System Instructions When They May Affect the Study

In Brief

Researchers should generally document AI system instructions when they are available and relevant to the study because these instructions can influence model behavior, response content, safety restrictions, and the reproducibility of findings.

Documentation should distinguish instructions directly controlled by the researcher from those supplied by an application or provider. When instructions are hidden or inaccessible, researchers should report that limitation rather than assume the system has no additional instructions.

03 · What You Need to Know

Why AI System Instructions Matter for Research Methodology

What are AI system instructions?

System instructions are directives provided to an AI model or application to establish aspects of its expected behavior. Depending on the platform, they may specify the model's role, response format, operating constraints, or how certain categories of requests should be handled.

In systems that support multiple instruction levels, system messages may have higher priority than ordinary user messages. Some platforms also support developer instructions, application-specific configurations, and additional contextual material.

These mechanisms are not identical across AI providers. The terminology, implementation, and instruction hierarchy may differ.

System instructions Higher-priority instructions supplied through a system-level mechanism, where supported, to influence the model's behavior across interactions.
User prompts Task-specific requests submitted by the user or researcher, usually operating within the constraints established by higher-priority instructions.

A developer instruction may occupy a separate priority level between system and user instructions. Researchers should therefore avoid treating every instruction outside the visible user prompt as technically equivalent.

How can system instructions influence research results?

Instructions may influence how a model interprets a task, what information it includes, and which responses it considers appropriate.

For example, a system instruction might direct an AI assistant to answer questions as a mathematics tutor, avoid providing complete solutions, or return responses in a particular structure.

If researchers evaluate the system's ability to solve mathematics problems, those instructions could materially influence the observed performance.

Instructions may also affect refusal behavior, response length, the presentation of uncertainty, or the extent to which a model follows task-specific directions.

Consequently, two researchers using the same model and visible user prompt may not be testing equivalent conditions if their applications provide different higher-priority instructions.

This does not mean that every difference between AI outputs can be attributed to system instructions. Model updates, sampling configurations, conversation history, retrieval tools, and other implementation details may also contribute.

Which instructions should researchers document?

The appropriate documentation depends on the research question and the degree of control available to the researcher.

Instruction or configuration What to document Why it matters
Researcher-defined system message Exact text, including relevant formatting and delimiters Establishes an identifiable experimental condition
Developer instructions Exact text when accessible and disclosure is permitted May constrain how user prompts are interpreted
Application-level instructions Relevant configuration, role definitions, and behavioral settings May distinguish one application from another using the same model
Custom assistant configuration Instructions, configuration version, and relevant enabled capabilities May influence responses beyond the visible user prompt
Provider-controlled hidden instructions Known existence, accessibility limitations, and documented provider information Identifies an uncontrolled or incompletely observed condition

Instructions should be preserved in their original form when exact wording could affect interpretation. A paraphrase may be useful in a published methods section, but it should not replace the original text in the underlying research record when the original is available and can lawfully be retained.

What if the AI provider does not reveal its system instructions?

Many commercial AI interfaces do not expose every instruction governing their behavior. Researchers may be unable to inspect provider-controlled system messages, safety configurations, or other internal mechanisms.

This limitation should be reported explicitly.

A suitable methodological statement might explain that the researchers controlled the visible user prompts but did not have access to the provider's internal system instructions. The findings would therefore describe the behavior of the accessible AI service under the tested conditions rather than isolate the behavior of an unconstrained underlying model.

Researchers should not claim that a system had no hidden instructions merely because none appeared in the interface.

Nor should they treat a model's self-reported description of its internal instructions as independently verified evidence. AI-generated explanations about hidden configurations may be incomplete or inaccurate.

Should system instructions be included in the published paper?

When instructions are central to the experimental manipulation, their exact wording should generally be reported in the manuscript, supplementary materials, or an appropriately accessible research repository.

For studies where instructions are peripheral, a concise description may be sufficient, provided the underlying record preserves the necessary detail.

The reporting decision should consider whether another researcher could understand the tested condition, assess the interpretation, and reproduce the accessible elements of the procedure.

Documentation may also be constrained by confidentiality agreements, platform terms, institutional security requirements, or restrictions on disclosing proprietary information. Researchers should not publish protected instructions without authorization.

Can system instructions change without researchers knowing?

Yes. Commercial AI providers may revise application behavior or internal configurations without exposing every change to users.

Even when a publicly visible model identifier remains unchanged, researchers should not assume that all surrounding application instructions and service configurations remain constant.

This creates an important distinction between reproducing the original research procedure and obtaining identical model outputs.

Recording the accessible instructions, service identifier, configuration, and testing period improves methodological transparency. It does not guarantee identical future responses.

Researchers should therefore record the AI model version being studied and document when the AI system was tested.

How do system instructions relate to the broader prompt record?

System instructions should not be documented in isolation when other contextual information materially influences the response.

Depending on the study, relevant records may include the user prompt, developer instructions, previous conversation turns, model settings, available tools, and retrieved documents.

A complete record should preserve the distinction between these elements rather than combine them into one undifferentiated transcript.

This becomes especially important when preserving prompts used to study an AI model or evaluating how conversation history affects generative AI responses.

04 · A Practical Example

Testing How System Instructions Affect AI Feedback

Hypothetical Example

An experiment involving AI-generated writing feedback

A researcher evaluates an AI model's ability to provide feedback on undergraduate argumentative essays. The same model receives the same set of anonymized essays under two experimental conditions.

In Condition A, the system instruction directs the model to act as a supportive writing tutor and prioritize constructive guidance. In Condition B, the system instruction directs the model to act as a strict academic evaluator and identify weaknesses according to a specified rubric.

The researcher investigates whether the instruction condition influences the specificity, severity, and usefulness of the feedback.

Step 1: Preserve the exact instructionsThe researcher records the complete system message for each condition rather than merely labeling the conditions "supportive" and "strict."
Step 2: Control other observable conditionsThe researcher uses the same model identifier, essays, user prompts, and available configuration settings across conditions, while documenting any uncontrolled service-level factors.
Step 3: Record the testing procedureThe researcher preserves the request structure, testing dates, response records, and the procedure used to assign essays to conditions.
Step 4: Analyze the observed differencesFeedback is evaluated against prespecified criteria. The researcher examines whether the system-instruction conditions are associated with meaningful differences in the responses.
Step 5: Report the limits of the comparisonThe study describes the observed effects under the tested configuration without assuming that the results generalize to every model or future service version.

Without the exact system instructions, another researcher would know that two conditions existed but could not reliably reconstruct the experimental manipulation.

The instructions are therefore part of the method, not merely background information.

05 · What Researchers Often Get Wrong

Common Mistakes When Reporting AI System Instructions

Misconception

Only the User Prompt Matters

Higher-priority instructions may influence the interpretation and execution of user requests. Recording only the visible prompt can leave an important part of the experimental condition undocumented.

Misconception

If Instructions Are Hidden, the Model Has None

Inaccessibility is not evidence of absence. Researchers should identify the boundaries of their access and avoid unsupported claims about internal configurations.

Misconception

Identical System Instructions Guarantee Identical Answers

Response variation can arise from stochastic generation, model updates, conversation context, and other factors. Preserving instructions supports procedural reproducibility but does not guarantee output identity.

Misconception

A Short Summary Is Always Enough

When instruction wording is experimentally important, summaries may conceal consequential differences. Exact text is generally preferable in the underlying record.

Misconception

Every Hidden Instruction Must Be Extracted for the Study to Be Valid

Research can legitimately examine a commercial AI service as an observable system without obtaining proprietary internal instructions. The limitation should be acknowledged, and conclusions should remain within the scope of the tested service.

06 · What This Means for You

Deciding How Much System-Instruction Documentation Your Study Needs

The extent of documentation should reflect the methodological role of the instructions.

A simple decision framework

If you create or modify system instructions as an experimental variable
Preserve the exact wording and report how the instructions were assigned and applied.
If you use a configurable custom assistant
Record accessible instructions, relevant configuration settings, and the version or testing date.
If the commercial service hides its internal instructions
Describe the inaccessible configuration as a methodological limitation without speculating about its contents.
If instructions contain confidential or restricted information
Preserve records through an authorized process and disclose only what permissions and research-integrity obligations allow.

For studies comparing AI models, instruction transparency also affects the fairness of the comparison. Two systems receiving the same visible prompt may still operate under different application-level conditions.

Researchers planning fair comparisons between AI models should identify which instruction layers they controlled and which remained outside their observation.

07 · A Quick Checklist

What to Record About AI System Instructions

Before finalizing your research documentation, check:
Identify the system, developer, and user instruction levels supported by the AI platform.
Preserve the exact text of researcher-controlled instructions when relevant.
Document the AI model identifier, accessible configuration, and testing date.
Record whether instructions changed between experimental conditions or testing sessions.
Distinguish directly observed instructions from inferred or provider-described behavior.
State explicitly when provider-controlled instructions are inaccessible.
Check whether instruction records contain confidential, proprietary, or security-sensitive material.
Make sufficient methodological information available for others to evaluate the study within applicable disclosure restrictions.
08 · Frequently Asked Questions

Frequently Asked Questions About Documenting AI System Instructions

Are system instructions the same as prompts?

System instructions are a type of instruction supplied through a particular mechanism or priority level. The broader term "prompt" may refer to user requests or the complete input context. Researchers should identify the specific instruction layer rather than rely on ambiguous terminology.

Should researchers publish the exact system prompt?

When the system prompt is an important experimental variable and disclosure is permitted, publishing its exact text is generally preferable. It may appear in supplementary materials or a repository rather than the main manuscript.

Can researchers study AI models without knowing their hidden instructions?

Yes. Such studies can examine the behavior of accessible AI services. However, researchers should avoid attributing observed behavior exclusively to underlying model capabilities when application-level instructions remain unknown.

Can asking an AI model to reveal its system prompt provide reliable documentation?

No. A model's description of its own instructions is not necessarily complete or accurate. Directly accessible configuration records or authoritative provider documentation offer stronger evidence.

Do system instructions need to be recorded for every research interaction?

Not necessarily. If the same verified instruction configuration applies across a documented series of tests, a versioned master record with links to individual runs may be sufficient. Changes should be recorded when they occur.

Do hidden system instructions make an AI study irreproducible?

They may limit exact reconstruction, but they do not automatically invalidate a study. Researchers can preserve observable conditions, describe inaccessible elements, and frame their conclusions appropriately.

09 · The Bottom Line

Document the Instructions You Can Observe and the Limits You Cannot Remove

The Bottom Line

Researchers should document available AI system instructions when those instructions may influence the research procedure or findings. Exact instruction records are especially important when instructions form part of an experimental manipulation.

When higher-priority instructions are inaccessible, transparency means reporting that limitation rather than reconstructing their contents through speculation. Good methodological documentation distinguishes controlled instructions, observed behavior, and unknown system conditions.

10 · Sources and Further Reading

Sources on AI Instruction Hierarchies and Research Documentation

11 · Cite this Guide

How to Cite This Guide

This guide is intended to be read, shared, and used in research, teaching, and academic work. If you draw on its ideas, explanations, or other content, please acknowledge the source by citing the guide. Doing so gives appropriate credit and helps your readers locate the original resource.

Has the Field Guide helped your research?

If a guide helped clarify a question, inform a research decision, or move your work forward, I would love to hear about your experience. Your story may also help other researchers discover the Field Guide.

Share Your Experience
Takes only a few minutes