Po mnoho let byly hlavním výstupem analytické práce dokumenty, prezentace nebo diagramy uložené v různých nástrojích. Takové artefakty byly dobře čitelné pro člověka, ale obtížně zpracovatelné pro další systémy. S nástupem AI asistentů, automatizace a principů Documentation as Code se stále více ukazuje, že budoucnost patří strojově čitelným výstupům. Strukturované informace zapsané v Markdownu, PlantUML, Mermaid, OpenAPI nebo Gherkinu mohou být snadno čteny lidmi i nástroji současně.
Z pohledu analytika nejde o změnu cíle, ale o změnu formy. Smyslem analýzy stále zůstává pochopení problému, strukturování informací a podpora společného porozumění. Rozdíl je v tom, že místo statických dokumentů vznikají artefakty, které lze verzovat v Gitu, automaticky validovat, generovat z nich další dokumentaci nebo je použít jako kontext pro AI asistenty. Markdown se tak stává univerzálním nosičem znalostí a jediným zdrojem pravdy pro tým.
Velkou roli v tomto přístupu hrají textové notace pro modelování. PlantUML nebo Mermaid umožňují zapisovat diagramy jako textový kód, který je možné spravovat stejným způsobem jako zdrojové kódy aplikací. Use Case, Activity, Sequence nebo Component diagramy tak nevznikají kreslením obrázků, ale zápisem strukturovaného modelu. Výsledkem jsou diagramy, které lze snadno upravovat, verzovat, sdílet v Confluence, zobrazovat ve Visual Studio Code a především využívat jako vstup pro AI nástroje. Místo práce s obrázkem pracujeme přímo s významem a strukturou informace.
Skutečná hodnota machine readable přístupu však nespočívá jen v efektivnější dokumentaci. Spočívá v možnosti orchestrací znalostí napříč celým životním cyklem řešení. Z jednoho zdroje dat lze generovat diagramy, akceptační kritéria, integrační kontrakty, testovací scénáře nebo podklady pro AI asistenty. Dokumentace se tak mění z pasivního úložiště informací na aktivní součást vývoje. A právě v tom spočívá jedna z největších příležitostí pro moderní analýzu: méně času věnovaného přepisování informací a více času věnovaného pochopení problému a návrhu správného řešení.