03 · What You Need to Know
What Makes an AI-Assisted Coding Workflow Reproducible?
What Does Reproducibility Mean in AI-Assisted Coding?
Reproducibility concerns whether a research procedure and its results can be reconstructed or repeated using sufficiently documented materials. In AI-assisted coding, the term requires care because different forms of reproduction may be possible.
A researcher may be able to reproduce the final category frequencies from a preserved coded dataset even when the original AI service is no longer available. Another researcher may be able to repeat the coding procedure with the same model version but obtain slightly different classifications. A third may apply the documented procedure to new data to evaluate whether the findings generalize.
These are related but distinct activities.
| Objective |
What Must Be Available |
Principal Limitation |
| Reproduce reported analyses |
Final coded dataset, analysis rules, and relevant scripts or calculations. |
Does not independently establish that the original codes were correct. |
| Reconstruct coding decisions |
Original data, codebook versions, AI outputs, human corrections, and decision records. |
Some contextual judgments may require further explanation. |
| Repeat the AI coding procedure |
Prompts, model information, settings, preprocessing rules, and accessible model environment. |
Outputs may vary or the original model may no longer be available. |
| Replicate findings on new data |
Documented methodology and an independently collected or selected dataset. |
Different data may legitimately produce different results. |
Terminology differs across disciplines, particularly in how reproducibility and replicability are distinguished. Researchers should state what they mean rather than assuming that every reader uses the same definitions.
Why Is Saving the Prompt Not Enough?
A prompt does not fully describe the computational or analytical conditions under which AI coding occurred.
Two researchers could use identical visible instructions but obtain different results because they use different model versions, conversation histories, preprocessing procedures, or generation settings.
Even when those factors are controlled, a hosted model may produce variable outputs.
Researchers should therefore document the complete input and processing context as far as the system permits, including instructions that were supplied separately from the main prompt.
The possibility that AI coding changes across repeated prompt executions makes it particularly important to preserve the actual outputs used in the published analysis.
What Model Information Should Researchers Record?
The model or service used is part of the research procedure. A general statement such as "ChatGPT was used for coding" may be insufficient to reconstruct the workflow.
Where available, researchers should record the provider, model identifier, version or snapshot, interface or API, execution dates, and relevant generation settings.
Some systems expose temperature, output limits, seeds, or other parameters. Others do not provide these controls or may change their availability over time.
Researchers should document what was actually available and used rather than inventing settings that the system did not expose.
When a hosted service does not reveal its exact model configuration, the limitation should be acknowledged. Reproducibility does not require researchers to claim access to technical details they were never given.
Why Should Researchers Preserve the Exact Codebook Version?
A codebook defines how research material is classified. If its definitions change during analysis, the meaning of an assigned code may also change.
Suppose an initial codebook includes a broad category called "technical problems." After examining the first 500 responses, the researcher separates this into internet connectivity, device limitations, and platform usability.
If the first 500 responses remain coded under the original category while subsequent responses use the revised framework, the dataset contains classifications generated under different rules.
Researchers should therefore preserve each relevant codebook version and record when it was applied.
Version records should identify additions, deletions, renaming, changes in definitions, and the rationale for consequential revisions.
When a revised framework materially changes category meanings, affected records may require reassessment.
What Should Be Documented About Data Preparation?
AI coding often begins with preprocessing. Researchers may remove identifiers, correct formatting problems, divide long responses into segments, translate material, or exclude unusable records.
These operations can influence what the model receives and how it interprets the data.
For example, removing an interview question may eliminate context needed to interpret the participant's answer. Translating a culturally specific expression may change its meaning. Combining several statements into one input may alter the coding unit.
A reproducible workflow should record the preprocessing rules, their sequence, and any exclusions.
Researchers should preserve stable identifiers linking processed text to the original records. This makes it possible to investigate whether an unexpected code reflects model behavior or an earlier data transformation.
Should Researchers Preserve Raw AI Outputs?
Yes, where ethically and technically appropriate. Raw outputs provide evidence of what the model actually returned before researchers corrected, reorganized, or summarized the classifications.
Suppose AI assigns "time management" to a statement about mandatory evening classes. A researcher later changes the assignment to "institutional scheduling constraints."
If only the final code is preserved, another researcher cannot determine whether the classification originated from AI or from subsequent human review.
Retaining both the original AI assignment and the final approved decision creates a clearer analytical record.
Raw outputs should be stored securely when they contain or reproduce confidential research material. Preserving records for audit purposes does not automatically authorize public disclosure.
How Can Researchers Record Human Corrections?
Human review should be documented as part of the coding procedure rather than treated as an invisible adjustment after AI processing.
A coding log might contain the response identifier, original AI code, reviewer-approved code, reason for change, review date, and applicable codebook version.
For example:
| Record |
AI Code |
Final Code |
Reason |
| R-014 |
Time management |
Institutional scheduling |
Response describes a timetable imposed by the institution. |
| R-027 |
Positive platform experience |
Platform performance problem |
Original statement contains sarcasm. |
| R-041 |
Technical support |
Unresolved |
Insufficient evidence to identify the type of support. |
The log need not become unnecessarily elaborate, but it should preserve consequential decisions that affect interpretation.
Researchers should also distinguish independent reference coding from human review conducted after seeing AI suggestions. The latter may be influenced by the model's proposed labels.
How Should Researchers Document Validation?
Validation records should describe how coding quality was evaluated and why the chosen procedure was appropriate for the research design.
For structured classification, documentation may include the sampling strategy, reference coding process, agreement or accuracy measures, category-specific errors, and treatment of ambiguous cases.
If researchers use a probability sample, they should explain the sampling unit and selection procedure. If they deliberately review difficult cases, they should identify the targeted selection criteria.
The two forms of review should not be confused. A targeted sample may reveal important errors without providing a representative estimate of overall performance.
Researchers should document the basis for deciding how much AI-coded data required manual verification.
Can Version Control Improve AI Coding Reproducibility?
Yes. Version control helps researchers preserve changes to prompts, codebooks, scripts, and processing configurations.
For example, a researcher might maintain a project repository containing dated codebook files, prompt templates, processing scripts, and a change log.
Each coding batch can then be associated with the exact versions used during processing.
Version control does not require every researcher to use a particular software platform. The important requirement is that relevant changes can be reconstructed reliably.
For confidential data, repositories should not expose participant responses or identifying information without authorization. Access controls and separate secure storage may be necessary.
What Is a Reproducibility Manifest?
A reproducibility manifest is a structured record describing the materials and conditions used to produce a dataset or analysis.
For AI-assisted coding, a manifest might identify the input dataset, codebook version, prompt version, model identifier, relevant settings, processing date, output file, and validation record.
It can also include cryptographic checksums, which help determine whether files have changed since they were recorded.
A checksum does not establish that a file contains correct classifications. It provides evidence about file identity or integrity when compared with a previously recorded value.
The manifest is a practical documentation recommendation rather than a universally mandated research standard. Its structure can be adapted to the study's complexity and institutional requirements.
Can a Reproducible Workflow Still Produce Invalid Coding?
Yes. Reproducibility and validity address different questions.
A researcher may preserve every prompt, model setting, and output while using a conceptually flawed coding framework. Another researcher could reproduce the same classifications without establishing that they adequately represent participants' meanings.
Similarly, a model may consistently apply an inappropriate code to culturally specific expressions.
Researchers should therefore evaluate coding validity separately from consistency and reproducibility.
A transparent record makes errors easier to identify and investigate. It does not eliminate them.
What Does Research and Official Guidance Suggest?
The National Institute of Standards and Technology's AI Risk Management Framework provides a broader foundation for documenting and evaluating AI systems. Its measurement guidance emphasizes documenting test sets, metrics, evaluation tools, and performance under conditions relevant to deployment.
The framework is voluntary and is not a specific mandatory protocol for qualitative research coding. Nevertheless, its principles support systematic documentation of AI-assisted analytical workflows. The official framework guidance describes these evaluation and documentation expectations.
Schroeder, Roy, and Kabbara (2025) examined human interaction with AI-generated annotation suggestions. Their preregistered study found that AI suggestions influenced human labels and could affect subsequent evaluation results. This provides a specific reason to document whether reference coding was independent of AI suggestions.
Lee, Hong, and Thorne (2025) investigated consistency in language-model evaluation and found that strong models were not necessarily consistent evaluators. Their findings reinforce the importance of evaluating stability rather than inferring it from model capability.
These sources support transparent and task-specific evaluation. They do not establish that recording technical settings alone guarantees reproducible qualitative interpretation.
What If Research Data Cannot Be Shared Publicly?
Reproducibility does not require researchers to violate participant confidentiality or data protection obligations.
When original responses cannot be publicly released, researchers may share permitted documentation, coding definitions, analysis scripts, and non-sensitive examples while retaining restricted data in an approved environment.
Depending on the study, controlled-access arrangements or appropriately constructed synthetic examples may help others understand the procedure. Synthetic examples should not be represented as original participant data.
Watch Out
Do not publish raw prompts, AI outputs, or coding logs without checking whether they contain confidential participant information. A reproducibility package should preserve methodological transparency while respecting consent, ethics approval, institutional requirements, and applicable data protection law.
Researchers should explain any restrictions that prevent independent access to the original material and identify which parts of the workflow remain reproducible.
04 · A Practical Example
Creating an Audit Trail for 3,000 AI-Coded Survey Responses
Hypothetical Example
Documenting an AI-Assisted University Survey Analysis
A researcher classifies 3,000 open-ended student survey responses using a predefined codebook. The project involves pilot testing, a codebook revision, automated classification, and human verification.
The researcher wants to preserve enough information to reconstruct the procedure and explain the final dataset.
Step 1: Establish a Project Record
The researcher assigns stable identifiers to every response and stores the original dataset in an approved secure environment.
The initial codebook is saved as version 1.0, with definitions and examples. The prompt is also preserved as a versioned file.
Step 2: Document Pilot Testing and Revisions
During pilot coding, the researcher discovers that the model frequently confuses internet connectivity with platform usability.
The codebook is revised to version 1.1, with clearer exclusion criteria. The prompt is updated accordingly, and the revised procedure is evaluated on separate material.
The change log records why the revision was necessary and which earlier classifications required reassessment.
Step 3: Record the Production Configuration
Each processing batch is linked to the relevant model, prompt, codebook, and output records.
| Record Element |
Illustrative Entry |
| Dataset |
student-responses-v1.csv |
| Codebook |
codebook-v1.1 |
| Prompt |
coding-prompt-v2 |
| Model |
Recorded provider and model identifier |
| Processing |
Documented batch identifiers and execution dates |
| Raw outputs |
Preserved separately from corrected classifications |
| Validation |
Independent reference coding and error analysis |
Step 4: Preserve Human Corrections
The researcher records which AI assignments were accepted, corrected, or left unresolved. Consequential corrections include the reason for the decision and the applicable codebook version.
The final dataset retains response identifiers so that every classification can be traced to the original evidence.
Step 5: Reproduce the Reported Analysis
Using the preserved final coded dataset and documented analysis procedure, the researcher recalculates the category frequencies.
The reproduced frequencies match the original report. This establishes that the reported summary can be reconstructed from the preserved analytical materials.
It does not independently prove that every classification is valid. That question depends on the coding framework and validation evidence.
The project is more reproducible because the researcher preserved how the classifications were produced, changed, checked, and ultimately used.