Dify Document Synthesis Builder

Japanese documentation: README.ja.md

This repository contains Dify DSL YAML files for an AI app that turns multiple uploaded files, and optionally Dify knowledge-base context, into one structured Markdown document.

Files

• dify/document-synthesis-builder.yml
  • Primary import target.
  • Works with uploaded files only.
  • Accepts multiple document-like files and produces a structured synthesis report.
• dify/document-synthesis-builder-kb-template.yml
  • Knowledge-base template.
  • Includes a Knowledge Retrieval node, but the dataset must be selected inside Dify after import.
• tools/validate_dsl.py
  • Lightweight structural validator for the YAML files.
• docs/superpowers/specs/2026-07-07-document-synthesis-builder-design.md
  • Approved design spec.
• docs/superpowers/plans/2026-07-07-document-synthesis-builder.md
  • Implementation plan.

Import

1. Open Dify.
2. Create from DSL / import YAML.
3. Import dify/document-synthesis-builder.yml.
4. Configure the LLM node model provider if your Dify workspace uses a different provider.
5. Run the app with several uploaded files.

For knowledge-base use, import dify/document-synthesis-builder-kb-template.yml, open the Knowledge Retrieval node, select the target knowledge base, and publish the workflow.

Input Fields

• files: required file list. Use PDF, DOCX, XLSX, CSV, PPTX, TXT, Markdown, HTML, JSON, YAML, or similar text-bearing formats supported by Dify Document Extractor.
• topic: optional synthesis theme. Leave blank to synthesize all materials.
• template_type: optional output template. Examples: general, requirements, research_report, proposal, meeting_minutes, specification.
• output_language: default Japanese.

The KB template also includes:

• use_knowledge: set to true after selecting a knowledge base in Dify.

Validation

Run:

python tools/validate_dsl.py

The validator checks parseability, required Dify export keys, graph node and edge references, and key workflow variables.