jtbd-analyze-topicmap

To extract Jobs-To-Be-Done records from documentation topic maps, you need to parse the `_topic_map.yml` file in your repository, process the AsciiDoc assemblies, and resolve includes to identify user needs. The skill automates this extraction and enriches the data with module provenance.

A topic map in AsciiDoc documentation is a `_topic_map.yml` file that structures books and topics within a repository. You need to parse it when you want to understand complex documentation sets and extract Jobs-To-Be-Done records to analyze user motivations for procedures like installing GitOps.

Yes, you can filter extracted JTBD data by distribution and list available books. During the topic map parsing process, the skill supports filtering by specific distributions and allows you to list available books within the documentation repository to target your analysis.

Asciidoctor-reducer works by processing AsciiDoc assemblies and resolving includes to reduce the content. This reduction is necessary to accurately analyze the documentation and extract Jobs-To-Be-Done records along with their source module provenance for comprehensive user need understanding.

To analyze user motivations for the Installing GitOps book, you use the skill to target the 'installing_gitops' book within your provided repository path. It parses the topic map, reduces AsciiDoc assemblies, and extracts JTBD records to reveal installation requirements.

Extracted JTBD records need provenance tracking to link user needs back to their specific source modules. Enriching the data with source module information provides comprehensive context, ensuring you understand exactly where and why specific user requirements exist within the documentation assemblies.