# AI-Updated Markdown Workflow

**Status:** Draft
**Last updated:** 2026-08-22

This ordinary Markdown file can be edited by a person, an AI coding agent, a command-line tool, or a script. Keep it open in Telescopo with Live Monitoring enabled to follow clean external changes.

## Prompt for an AI Tool

> Update `examples/telescopo-ai-workflow.md`. Add a concise architecture summary, a Mermaid sequence diagram, three implementation risks, and an owner for every action item. Preserve the existing headings.

## Architecture Summary

The workflow keeps Markdown as the shared artifact. External tools write the file, Telescopo detects the filesystem change, and Reader or Split view displays the updated document.

```mermaid
sequenceDiagram
    participant User
    participant Agent as AI tool
    participant File as Local .md file
    participant Telescopo
    User->>Agent: Request documentation update
    Agent->>File: Write Markdown changes
    File-->>Telescopo: Filesystem change detected
    Telescopo-->>User: Refresh or conflict notice
```

## Implementation Risks

1. An external write can conflict with unsaved local edits.
2. Generated diagram syntax can contain an error that needs source correction.
3. External AI tools have their own privacy and network behavior.

## Action Items

- [ ] Review generated changes - **Owner: Documentation lead**
- [ ] Resolve any file conflict - **Owner: Current editor**
- [ ] Export the approved document - **Owner: Project lead**

## Conflict Boundary

When there are no conflicting local edits, Telescopo can refresh the externally changed file. When local edits and an external write overlap, Telescopo surfaces a conflict rather than silently replacing the active work.