Generate workflow audit docs from JSON with Claude Sonnet and Notion

Description

Quick overview
This workflow collects an exported n8n workflow JSON via an n8n Form, audits it for common reliability and security issues, uses Anthropic Claude to draft a business summary and technical report, and then creates a formatted documentation page in Notion.

How it works
Receives a form submission with a workflow JSON file, client name, and a Notion parent page ID.
Parses and validates the uploaded JSON to confirm it contains nodes and connections and extracts the workflow metadata.
Analyzes the workflow graph to determine execution order, detect cycles and unreachable nodes, and generate a scored list of audit findings.
Sends the audit context to Anthropic Claude (Sonnet) to generate a business-facing workflow summary and a developer-facing audit report.
Converts the generated text into Notion blocks, including an audit score callout and optional warnings for cycles or unreachable nodes.
Creates a new Notion page under the provided parent page and appends the blocks in batches with a short wait to avoid Notion rate limits.

Setup
Import the workflow and connect your Anthropic account credential to the Claude Sonnet node. No additional configuration is needed on the Anthropic side.
Connect your Notion account credential to both the Create Notion Page and Append Blocks nodes. In Notion, open the page you want to use as the parent, go to Connections in the page settings, and add your integration so it has access.
Activate the workflow and open the form URL. Upload an exported n8n workflow JSON file, enter the client name, and paste the 32-character Notion page ID (found in the page URL, without dashes). Submit the form and your documentation page will appear in Notion within 30 to 60 seconds depending on workflow size.

Requirements
Anthropic API account with access to Claude Sonnet
Notion integration token with write access to the target workspace

Customization
Swap Claude Sonnet for any other model supported by n8n's LangChain nodes by changing the model field on the Claude Sonnet sub-node
Adjust the audit scoring weights in the Audit Workflow code node to match your team's priorities, for example increasing the penalty for CRITICAL findings or adding new secret patterns to the detection list
Modify the system prompt in Build Prompt to change the tone, length, or structure of the generated documentation