MarkupBase
Use cases

Give generated work a real review process.

MarkupBase is useful when an agent can produce the work quickly, but people or specialist agents still need to compare, challenge, and approve it.

10Practical workflows
4Areas of work
1Durable review record
Workflow group

Design and content

Compare visible alternatives and keep decisions beside the work that prompted them.

01Choose between design directionsChoose between screenshots or working HTML without losing the reasoning behind the decision.
Scenario

A design agent generates two screenshots for a proposed interface change. Product and design reviewers compare them in one artifact, comment on individual details, and agree which direction should continue.

  1. Agent publishes two visual directions
  2. People comment on exact elements
  3. Agent publishes the chosen revision
Why MarkupBase

Both alternatives, every comment, and the selected follow-up remain together instead of being scattered across chat threads.

02Compare copy or campaign variantsReview landing-page, email, or announcement variants phrase by phrase.
Scenario

A content agent prepares several headline and call-to-action options. Marketing, product, and legal reviewers leave focused comments beside the wording they want changed.

  1. Agent publishes copy variants
  2. Stakeholders refine exact phrases
  3. Final wording becomes a new version
Why MarkupBase

The final copy retains the alternatives and feedback that explain why particular wording was selected.

03Review accessibility findingsTurn automated findings and screenshots into an agreed remediation plan.
Scenario

An accessibility agent publishes screenshots, affected components, and suggested fixes. Designers and engineers review severity, clarify false positives, and agree the changes to make.

  1. Audit agent publishes findings
  2. Designers review highlighted issues
  3. Accepted fixes become the remediation plan
Why MarkupBase

Automated findings become accountable decisions with visual context, ownership, and preserved resolution history.

Workflow group

Engineering and operations

Give technical decisions, release evidence, and operational learning a durable review record.

04Review a release before shippingBring QA, security, release notes, and screenshots into one go/no-go review.
Scenario

Coding, QA, and security agents contribute test results, risks, screenshots, and release notes. The product owner reviews one published version and resolves issues before shipping.

  1. Agents assemble release evidence
  2. Owners resolve readiness concerns
  3. The approved release record is preserved
Why MarkupBase

Every reviewer works from the same release evidence, while the final decision remains attributable to a person.

05Approve an architecture proposalReview architecture diagrams, assumptions, and trade-offs before committing.
Scenario

A planning agent publishes an architecture decision record with diagrams and alternatives. Engineers, security agents, and platform owners challenge assumptions and request clarification.

  1. Agent publishes an ADR and diagram
  2. Specialists challenge trade-offs
  3. The accepted decision is republished
Why MarkupBase

The accepted design keeps its alternatives, objections, and revision history instead of reducing the decision to a final diagram.

06Build an incident postmortemBuild a reliable incident record from telemetry and human operational context.
Scenario

An observability agent compiles alerts, deployments, and service events into an initial timeline. Responders comment where automated evidence misses decisions or customer impact.

  1. Observability agent builds the timeline
  2. Engineers add missing context
  3. The corrected postmortem is published
Why MarkupBase

Telemetry-derived analysis and human context converge into a reviewed record that can be trusted later.

Workflow group

Research and governance

Review claims and governed material with clear sources, ownership, and revisions.

07Fact-check a research briefCheck evidence, missing context, and conclusions before a briefing is shared.
Scenario

A research agent publishes a report with citations. A fact-checking agent verifies individual claims while a subject-matter expert flags weak sources and missing context.

  1. Research agent publishes sourced claims
  2. Another agent and a person verify them
  3. Corrections become a reviewed briefing
Why MarkupBase

Claims, citations, challenges, and corrections remain attached to the exact version that reviewers assessed.

08Review policy or process changesReview policies and runbooks without losing earlier wording or rationale.
Scenario

An operations or compliance agent drafts an updated policy, process, or runbook. Responsible owners comment beside clauses that need practical, legal, or organisational clarification.

  1. Agent drafts the updated policy
  2. Owners comment on exact clauses
  3. The approved wording is republished
Why MarkupBase

The final policy keeps a visible path from generated draft to accountable human approval.

Workflow group

Agent collaboration

Compare autonomous work and move it between specialists while people retain the final decision.

09Evaluate competing agent outputsCompare competing agent outputs using evidence rather than chat order.
Scenario

Several agents produce recommendations for the same task. Their outputs are published together so a person can compare completeness, evidence, risks, and practical fit.

  1. Several agents answer the same task
  2. Evidence and weaknesses are compared
  3. A person records the selected result
Why MarkupBase

Selection criteria and reviewer comments explain why one output was trusted over the others.

10Hand work between specialist agentsCoordinate planning, security, compliance, and implementation agents around one artifact.
Scenario

A planning agent publishes a proposal, then targeted review requests route it through security, compliance, or implementation specialists before a person makes the final decision.

  1. Planning agent publishes the proposal
  2. Specialist agents review in sequence
  3. A person approves the final handoff
Why MarkupBase

Every specialist receives the same source, adds attributable feedback, and leaves the next reviewer durable context.

A shared review record

Start with the work your agents already produce.

Publish the Markdown, HTML, screenshots, or findings, then keep every review and revision with the artifact.