AI-Powered Medical Content Review and Revision at Scale

flo_health · Healthcare · 2026 · source Agentic: no · promotional bias: med · source-backed · extracted with prompt 0.5.4 (schema v2)

Generated from extraction.json — do not edit by hand. Every claim cites verbatim source evidence; stated means the quote directly asserts the claim, implied means it supports it indirectly.

Problem

Domain: Medical content review and revision

Flo Health needed to keep a large library of women's-health articles medically accurate as guidelines changed, while reducing manual expert workload and preserving editorial quality.

Constraints:

Architecture

Flo Health and AWS built MACROS, an AI-assisted medical content review system around Amazon Bedrock and AWS orchestration. Content and guidelines enter through a Streamlit frontend on ECS, direct S3 uploads, or API-style integration. Step Functions orchestrate Lambda-hosted preprocessing, rule optimization, content review, revision, and statistics computation. Textract extracts PDF text. The review pipeline optionally filters irrelevant rules, chunks source text, reviews each section against rules, revises only non-adherent sections, and post-processes revisions back into the document. CloudWatch monitors the system, while medical experts review outputs in the UI and provide feedback.

Diagram confidence: explicit (topology described by the source).

flowchart LR
  streamlit-frontend["streamlit-frontend"] --> api-gateway-auth["api-gateway-auth"]
  streamlit-frontend --> s3-content-store["s3-content-store"]
  streamlit-frontend --> step-functions-workflow["step-functions-workflow"]
  step-functions-workflow --> preprocessing-lambda["preprocessing-lambda"]
  preprocessing-lambda --> textract-parser["textract-parser"]
  preprocessing-lambda --> s3-content-store
  step-functions-workflow --> rule-optimizer["rule-optimizer"]
  step-functions-workflow --> content-review["content-review"]
  step-functions-workflow --> content-revision["content-revision"]
  rule-optimizer --> bedrock-models["bedrock-models"]
  content-review --> bedrock-models
  content-review --> content-revision
  content-revision --> bedrock-models
  content-revision --> post-processing["post-processing"]
  post-processing --> s3-content-store
  s3-content-store --> compute-stats["compute-stats"]
  compute-stats --> streamlit-frontend
Drag to pan · scroll or use +/− to zoom · reconstructed from the source's described component topology

Components

Component Role Interacts with
streamlit-frontend ECS-hosted UI for document upload, content review statistics, interaction with changes, and manual adjustment. api-gateway-auth, s3-content-store, step-functions-workflow
api-gateway-auth Authentication layer for file upload through the UI. streamlit-frontend
s3-content-store Stores uploaded files, custom JSON files, rules, and review/revision outputs. streamlit-frontend, preprocessing-lambda, rule-optimizer, content-review, content-revision, compute-stats
step-functions-workflow Orchestrates preprocessing, rule optimization, content review, revision, and statistics computation. streamlit-frontend, preprocessing-lambda, rule-optimizer, content-review, content-revision, compute-stats
preprocessing-lambda Extracts text from uploaded files and prepares content for downstream review. step-functions-workflow, textract-parser, s3-content-store
textract-parser Extracts text from PDF files. preprocessing-lambda
rule-optimizer Uses Bedrock to extract, classify, prioritize, and refine guidelines from unstructured medical documents. step-functions-workflow, bedrock-models, s3-content-store
content-review Reviews chunks or sections against relevant rules and emits adherence/non-adherence findings. step-functions-workflow, bedrock-models, content-revision, s3-content-store
content-revision Generates style-preserving revisions for sections flagged as non-adherent. content-review, bedrock-models, post-processing
post-processing Combines original text with revised sections without changing adherent sections. content-revision, s3-content-store
compute-stats Combines individual review and revision runs into review statistics for the UI. s3-content-store, streamlit-frontend
bedrock-models Foundation-model layer for rule extraction, content review, filtering, and revision. rule-optimizer, content-review, content-revision
cloudwatch-monitoring System monitoring and log-management layer for the deployment. —

Data flow

A user prepares medical content and guidelines, then uploads PDF, TXT, JSON, or pasted text through the ECS-hosted Streamlit UI or directly to S3. Step Functions starts preprocessing in Lambda; Textract extracts PDF text when needed. Rule Optimizer and Content Review/Revision Lambda functions call Bedrock to extract rules, review chunks, and propose revisions. The system stores intermediate and final outputs in S3. A Compute Stats Lambda reads and combines review/revision results, and medical experts use the UI to inspect statistics, adjust changes, and validate output.

“Users begin by gathering and preparing content that must meet medical standards and rules.”article, stated
“Alternatively, custom Flo Health JSON files can be directly uploaded to the [Amazon Simple Storage Service (S3)](https://aws.amazon.com/pm/serv-s3/?gclid=CjwKCAiApsm7BhBZEiwAvIu2Xza-GMFJz1HVX3CuKCtvX_ibpGFo8f_WT1NbYPd_1blGICSLs7FTNhoCSxUQAvD_BwE&trk=518a7bef-5b4f-4462-ad55-80e5c177f12b&sc_channel=ps" — *article, stated* "This Lambda has access to Amazon Textract for extracting text from PDF files." — *article, implied* "X8mFh0FTJbfi_i4Ckodc91-VhGac7ctz4R_0e7OXfo0aLkQmQN1nDBoCeEwQAvD_BwE:G:s&s_kwcid=AL!4422!3!651541907473!e!!g!!amazon%20lambda!19836375769!150670855801), Rule Optimizer, Content Review and Revision functions are orchestrated via AWS Step Function.”article, stated

Why this architecture

MACROS is split into workflow steps because medical review needs traceable, bounded changes rather than free-form rewriting. Optional filtering avoids unnecessary calls when rules are irrelevant. Chunking helps review long articles section by section and prevents unintended edits elsewhere. Multi-call mode trades more model calls for higher detection accuracy by evaluating one rule per call. Model tiers separate simple chunking from complex review and revision to balance cost and quality. The UI keeps experts in control for validation and adjustment.

4 supporting quotes
“Only the paragraphs flagged as non-adherent move forward to the revision stage, streamlining the process and maintaining the integrity of adherent content.”article, stated
“This Review step iterates over the sections in the text to make sure that the LLM pays attention to each section separately, which led to more robust results in our experimentation.”article, stated
“instead of one Amazon Bedrock call assessing adherence of the article against all rules, we have one independent call per rule.”article, implied
“Different steps of the flow require different levels of LLM model complexity.”article, implied

Models used: Amazon Bedrock foundation models · Claude Haiku models family · Claude Sonnet models family · Claude Opus models family · large language models

Scale

Alternatives considered (roads not taken)

Manual review of every article

Rejected because: Manual review was time-consuming and prone to human error for a large, changing medical content library.

“Medical knowledge evolves continuously, and manual review of each article is not only time-consuming but also prone to human error.”article, stated

One Bedrock call assessing an article against all rules

Rejected because: Multi-call mode can improve non-adherent section detection by using one independent call per rule.

“To facilitate higher non-adherent section detection accuracy, the user can also use the Multi-call mode, where instead of one Amazon Bedrock call assessing adherence of the article against all rules, we have one independent call per rule.”article, stated

LLM filtering for every relevance check

Rejected because: The source notes non-LLM alternatives such as embedding similarity or keyword overlap can support filtering.

“Further, non-LLM approaches can be feasible to support the Filtering step:”article, stated
“Encoding the rules and the articles into dense embedding vectors and calculating similarity between them.”article, stated

Use the same model size for every step

Rejected because: The architecture assigns simpler work to smaller models and complex reasoning/revision to larger models for cost efficiency.

“While simpler tasks like chunking can be done efficiently with a relatively small model like Claude Haiku models family, more complex reasoning tasks like content review and revision require larger models like Claude Sonnet or Opus models family”article, stated

Patterns

prompt-chaining (orchestration)

MACROS decomposes content review into filtering, chunking, review, revision, and post-processing stages, with Bedrock calls for different subtasks.

“The Content Review and Revision block consists of five major components: 1) The optional Filtering stage 2) Chunking 3) Review 4) Revision and 5) Post-processing, depicted in Figure 3.”article, stated

structured-output-contract (integration)

The review step emits XML with section text, adherence flags, rule names, and non-adherence reasons so outputs can be parsed reliably.

“Content review, as already mentioned, is conducted on a text section basis against group of rules and leads to response in XML format, such as:”article, stated
“Using XML format helps to achieve reliable parsing of the output.”article, stated

model-routing (model-operations)

The solution chooses smaller models for simpler steps such as chunking and larger Claude families for review and revision.

“Different steps of the flow require different levels of LLM model complexity.”article, stated
“simpler tasks like chunking can be done efficiently with a relatively small model like Claude Haiku models family”article, stated

human-in-the-loop-gate (governance)

Medical experts remain in the loop through the UI, manual editing, review sessions, and final validation of AI suggestions.

“The UI support enables medical experts to directly see the content review statistics, interact with changes, and do manual adjustments.”article, stated
“human-AI collaboration – not full automation – is key to successful implementation.”article, stated

eval-driven-development (evaluation)

The PoC used explicit success metrics and regular expert feedback to guide system refinement.

“Success Metrics: * Accuracy: Content piece recall of 90% * Efficiency: Reduce detection time from hours to minutes per guideline”article, stated
“Regular expert feedback and clear performance metrics guided system refinements and incremental improvements.”article, stated

Tradeoffs

Use AI as augmentation, not final authority.

Chose human-AI collaboration with expert validation over full automation of medical content updates.

Rationale: AI can streamline review, but medical experts remain necessary for final validation and clinical precision.

“human-AI collaboration – not full automation – is key to successful implementation.”article, stated
“medical experts remaining essential for final validation, creating a more efficient hybrid approach to medical content management.”article, stated

Revise only non-adherent paragraphs.

Chose targeted revision after review over rewriting the whole article.

Rationale: Targeted revision preserves adherent sections and reduces the chance of introducing unrelated changes.

“Only the paragraphs flagged as non-adherent move forward to the revision stage, streamlining the process and maintaining the integrity of adherent content.”article, stated

Offer multi-call mode for higher detection accuracy.

Chose one independent Bedrock call per rule over one call assessing the whole article against all rules.

Rationale: Separate calls improve attention to each rule but increase call volume and cost.

“instead of one Amazon Bedrock call assessing adherence of the article against all rules, we have one independent call per rule.”article, stated

Use model tiers by task complexity.

Chose smaller models for simple steps and larger models for complex review/revision over one high-end model for every step.

Rationale: The tiered approach balances performance, accuracy, and cost efficiency.

“This tiered approach to model selection optimizes both performance and cost-efficiency of the solution.”article, stated

Gotchas (what bit them)

Medical content review needs standardized inputs before AI review works well.

Root cause: Content and guidelines can arrive in inconsistent formats and structures.

Resolution: Standardize input formats and document structures, and create diverse test sets across medical topics.

“We learned the importance of standardizing input formats for both medical content and guidelines while maintaining consistent document structures.”article, stated
“Creating diverse test sets across different medical topics proved essential for comprehensive validation.”article, stated

Long medical articles are hard for LLMs to assess safely in one piece.

Root cause: The model can miss sections or alter unrelated text if context is not segmented.

Resolution: Chunk source text into paragraphs or semantically complete sections and revise only flagged non-adherent sections.

“Content chunking was essential for accurate assessment across long documents, and expert validation of parsing rules helped medical experts to maintain clinical precision.Most importantly, the project confirmed that human-AI collaboration – not full automation – is key to successful implementation.”article, stated
“Only the paragraphs flagged as non-adherent move forward to the revision stage, streamlining the process and maintaining the integrity of adherent content.”article, stated

Medical AI needs strict compliance and expert oversight.

Root cause: The content is sensitive and subject to medical, ethical, and regional requirements.

Resolution: Use robust documentation, strict guideline version control, regional regulatory consideration, and continuous medical expert oversight.

“Given the sensitive nature of medical content, strict regulatory and ethical safeguards were critical.”article, stated
“implemented strict version control for medical guidelines and continuous human medical expert oversight for the AI-generated suggestions.”article, stated

Cost management quickly becomes important for multi-step review workflows.

Root cause: Review, revision, filtering, and multi-call modes can multiply token usage.

Resolution: Track token usage and optimize prompt design, batch processing, and model selection.

“Monitoring and optimizing cost quickly became a key priority. We implemented token usage tracking and optimized prompt design and batch processing to balance performance and efficiency.”article, stated

Evaluation

Flo defined PoC success metrics for recall, efficiency, workload reduction, quality, and speed; medical experts and content teams reviewed the system with AWS specialists through regular sessions.

Metrics: 90% content-piece recall target · hours-to-minutes detection time target · 10x faster than manual review target · 80% accuracy preliminary result · over 90% recall preliminary result · expert workload reduction

3 supporting quotes
“Success Metrics: * Accuracy: Content piece recall of 90% * Efficiency: Reduce detection time from hours to minutes per guideline”article, implied
“Flo Health’s medical experts and content teams were working closely with AWS technical specialists through regular review sessions”article, stated
“The solution exceeded target processing speed improvements while maintaining 80% accuracy and over 90% recall in identifying content requiring updates.”article, implied

Outcomes

Flo creates thousands of medical articles each year for millions of users; MACROS targets hours-to-minutes guideline review and 10x speed improvement over manual review.

3 supporting quotes
“The solution exceeded target processing speed improvements while maintaining 80% accuracy and over 90% recall in identifying content requiring updates.”article, stated
“Most notably, the AI-powered system applied medical guidelines more consistently than manual reviews and significantly reduced the time burden on medical experts.”article, stated
“Flo Health creates thousands of medical articles every year, providing millions of users worldwide with medically credible information on women’s health.”article, stated