AI / human / edited modes
How each paragraph in the report can be AI-drafted, hand-written, or AI-then-edited, and what changes between them.
Every AI-written paragraph in the report carries a mode that says who actually authored the words on the page. This page is the short reference for what each mode means and when to use it.
The three modes
| Mode | Who wrote it | Regenerate available | Show source available |
|---|---|---|---|
| AI draft | AI from start | Yes | Yes |
| AI draft, edited | AI then edited by a human | No (use Edit again) | Yes |
| Human authored | Human from scratch | No | Yes |
Show source works in all three modes because the observation input set stays attached to the paragraph regardless of who wrote the prose. Defensibility does not drop when you switch to human.
When to switch to human
A few patterns where switching to human pays off:
- Executive summary for a practice that always wants the opening paragraph in the senior assessor's voice. Switch the slot to human, the AI never overwrites it, and the next regenerate skips it.
- Section comments on a section the AI is consistently bad at (rare but it happens, especially for sections with zero observations where the AI pattern-matches to similar observations elsewhere in the building).
- Limitations when the standard AI phrasing does not match your tenant's house style.
Tap Switch to human on the paragraph card. The textarea opens empty (the AI draft is discarded). Type the paragraph. Save. The mode chip flips to "Human authored".
When to edit instead
If the AI draft is mostly right but a sentence needs tightening or a specific risk needs more weight, Edit is faster than rewriting from scratch. The paragraph mode flips to "AI draft, edited" on save. Show source still works.
The original AI text is replaced by your edit; we do not maintain a per-keystroke history pre-pilot. If you need to revert, regenerate is the path back to a fresh AI draft.
Regenerate
Tap the regenerate button on a paragraph card. A confirm dialog opens (current text will be replaced). Confirm. The single-slot regenerate runs server-side and the new paragraph swaps in within a few seconds.
Regenerate is hidden when the slot is in human mode. The AI should not silently overwrite text you wrote. To regenerate a human slot, use Edit to clear it back to AI mode first.
Tenant-level defaults
If a slot should always start in human mode for your practice (e.g. you never accept the AI for executive summaries), set a tenant-level default. This is an admin setting, not a per-slot toggle on every assessment. The assessor still sees the option to flip individual slots back to AI; the default just controls the starting state.
What the audit trail records
The mode is stamped on every paragraph at sign-off. Years later the trail shows:
- AI draft → "Generated by AI on date X, signed off without human edit".
- AI draft, edited → "Generated by AI on date X, edited by reviewer, signed off".
- Human authored → "Written from scratch by reviewer".
The model fingerprint is recorded for AI and AI-then-edited slots; for human-authored slots it is intentionally blank because no AI was involved in the final words.
The audit trail covers the full metadata set.
Where to go next
- Source linking for the Show source panel, which works in all three modes.
- How AI drafts work for the generation pipeline that produces the AI draft.
- Hallucination guards for the pre-sign-off checks that run regardless of mode.