Note

    ../../DOCS/features/workflows.md

    Source Summary title: Workflows description: Public list/detail pages for workflow entries with Mermaid diagrams sourced from the merged content catalog stat...

    Source Summary

    --- title: Workflows description: Public list/detail pages for workflow entries with Mermaid diagrams sourced from the merged content catalog status: evolving lastUpdated: 2026-02-23 owner: Product/Engineering --- # Workflows ## Routes - Canonical index: /workflows - Canonical entry: /workflows/:slug ## Purpose - Publish workflow definitions as first-cla

    Imported Context

    title: Workflows description: Public list/detail pages for workflow entries with Mermaid diagrams sourced from the merged content catalog status: evolving lastUpdated: 2026-02-23 owner: Product/Engineering

    Workflows

    Routes

    • Canonical index: /workflows
    • Canonical entry: /workflows/:slug

    Purpose

    • Publish workflow definitions as first-class entities with required diagrams.
    • Link workflows back to related projects, notes, or chats.
    • Highlight when workflows are reused across multiple projects and when workflows chain together.
    • Keep content aligned with Constellation by treating workflows as first-class nodes.

    Data Source Contract

    • Server-side catalog readers:
      • getWorkflows()
      • getWorkflowBySlug(slug)
    • Diagrams are rendered with Mermaid using buildWorkflowMermaidChart.
    • Pages are rendered with dynamic = "force-dynamic" so updates appear at runtime.
    • Workflow steps are persisted in kb_workflows / kb_workflow_steps and can be seeded from meta.workflow_steps during intake:sync:knowledge.
    • Related project context is derived from relatedProjectSlugs (single project = “part of project”; multiple = reused) and rendered as text-only project links.
    • Workflow chains are declared via relatedWorkflowSlugs and rendered as linked sequences on the detail page.
    • The workflow detail page includes a context box that surfaces project links plus the workflow chain sequence.

    Primary Files

    • src/app/workflows/page.tsx
    • src/app/workflows/[slug]/page.tsx
    • src/lib/workflows/diagram.ts
    • src/lib/server/content-catalog.ts
    • src/content/workflows.ts
    • scripts/intake/workflow/sync-workflow-intake-to-knowledge-backbone.ts

    Provenance