external-lesson

To write an incident lesson from web research, you can use a tool that performs targeted web searches, fetches authoritative sources, and extracts concrete evidence to generate a structured markdown file with source attribution.

The best way to generate structured markdown for best practices is to provide a brief topic prompt to an automated research tool that produces a complete document with required frontmatter and sections like Context, Key Insights, and Recommendations.

Web searching extracts evidence for external lessons by performing multiple targeted queries, fetching the most relevant results, and pulling concrete details from authoritative sources to ground the claims within the generated markdown.

You do not need to manually format frontmatter for lesson writing, as the generation process automatically creates the required fields including title, summary, date, phase, lesson_type, tags, and original_source.

You can automatically publish incident learnings by using a generation process that writes the resulting structured markdown file directly into a specified data directory using a slugified filename for site harvesting.

You should not use automated external lesson generation for topics lacking publicly available authoritative sources, as the tool relies entirely on web searching and fetching concrete evidence to ground its claims.