Skip to main content

​
Workflows

Tech Story Teller consists of four modular n8n workflows. Each can be imported directly into n8n and chained together or triggered independently.

​
Workflow A: GitHub Webhook Receiver

Purpose: Receives GitHub Action webhooks, extracts file paths, fetches content, and forwards to Workflow B.

​
Flow

Webhook Receiver → Parse File Paths → Fetch Rust File → Decode Content → Send to Workflow B

​
Nodes

NodeTypeFunction
Webhook ReceiverwebhookReceives POST with file list
Parse File PathsfunctionExtracts file array from payload
Fetch Rust FilehttpRequestCalls GitHub API for file content
Decode ContentfunctionBase64 decodes file content
Send to Workflow BexecuteWorkflowForwards to structural analysis

​
Workflow B: Structural Analysis

Purpose: Takes a Rust file and sends it to LLM for AST-like extraction.

​
LLM Task

The LLM analyzes the Rust source and outputs structured JSON: 
{
  "file_summary": "...",
  "functions": [
    {
      "name": "",
      "inputs": [],
      "return_type": "",
      "async": true,
      "impure": true,
      "side_effects": [],
      "calls": [],
      "called_by": [],
      "external_crates": []
    }
  ]
}

​
Configuration

  • Model: gpt-4o-mini
  • Temperature: 0 (deterministic output)

​
Workflow C: Deep LLM Analysis

Purpose: Generates comprehensive documentation from the structural analysis.

​
Output Components

  1. ELI5 explanation of the file
  2. Senior-system-engineer explanation
  3. Function-by-function explanation
  4. Real-world analogies
  5. Rust concepts used
  6. Component interaction map
  7. Mermaid diagram showing file relationships

​
Configuration

  • Model: gpt-4o
  • Temperature: Default (balanced creativity)

​
Workflow D: Test Coverage + Report

Purpose: Verifies tests, identifies gaps, and assembles the final report.

​
Tasks

  1. Run cargo test -- --nocapture
  2. Identify missing unit tests
  3. Map functions to existing tests
  4. Suggest fixes for failures
  5. Recommend high-value tests per function
  6. Produce final structured report

​
Output Delivery

  • Slack: Webhook integration
  • Notion: Page creation (configurable)
  • Email: SMTP integration (configurable)

​
Chaining Workflows

For full automation, chain all four workflows: 
A → B → C → D
Each workflow uses executeWorkflow nodes to pass data to the next stage.