Annotate Source Files

Add PUT workflow annotations to source files so putior can extract structured workflow data and generate Mermaid diagrams.

When to Use

• After analyzing a codebase with analyze-codebase-workflow and having an annotation plan
• Adding workflow documentation to new or existing source files
• Enriching auto-detected workflows with manual labels and connections
• Documenting data pipelines, ETL processes, or multi-step computations

Inputs

• Required: Source files to annotate
• Required: Annotation plan or knowledge of the workflow steps
• Optional: Style preference: single-line or multiline (default: single-line)
• Optional: Whether to use put_generate() for skeleton generation (default: yes)

Procedure