Processes core-processes

Derived: every BPMN process, with its own documentation, its lanes, and the skills its activities name. Sub-graph folio-assistant-core/processes.

This is an index, not the documentation. It says what exists and what each artefact declares about itself. What a process is for, when you would be in it, and what it is not, is authored beside it and reuses these entries rather than restating them — see the auto-docs skill.
ArtefactWhat it declares about itself
Getting started
folio-assistant-core/processes/conduct/getting-started.bpmn
Somebody said "create a folio": work out which request they meant, with the branch computed by a decision table that may answer "ask", and what has to be true before anything is written.
activities 13
lanes User (person) · Onboarding agent (system) · Work plan (beans) · Publish — GitHub Pages
skills dispatch-agent, document-intake, getting-started, interaction-modality, repo-conversion, todo-manager
Authoring a document
folio-assistant-core/processes/content/authoring-a-document.bpmn
How a document folio — structured prose and policy guidance, with no Lean and no required TeX — is authored, built and reviewed end to end.
activities 9
lanes Author (person) · Work plan — beans (shared by humans and agents) · Authoring agent (system) · Build pipeline — validate · render · publish · Reviewer / subject-matter expert
skills content-plan, content-publish, content-review, content-validate, document-authoring, document-publishing, document-structure, normative-statements, staging-review, todo-manager
Content Change and Review
folio-assistant-core/processes/content/content-change-review.bpmn
Getting a change to a folio's CONTENT from a request into a published rendering: the author says what they want, an agent works out its scope and makes it, a review committee accepts or refuses it, and the pipeline depl…
activities 30
lanes Content Author · Folio-Assistant Agent · Review Committee · CI/CD Pipeline · Review Coordinator
skills adjudication, before-after-preview, content-author, content-graph, content-publish, content-review, decision-audit, feature-staging, prepare-merge, prepare-merge-auto, rendered-impact, review-comments, review-heatmap, staging-review, todo-manager, uses-editorial-review, visual-diff, watch
Content lifecycle
folio-assistant-core/processes/content/content-lifecycle.bpmn
One cycle of a folio from plan to retirement, calling editing and the draft-to-publication path as call activities.
activities 8
lanes Programme manager · Work plan — beans (shared by humans and agents) · Editors + authoring agents · Validation and QA (mechanical + agents) · Review team and SMEs · Publication manager
skills content-author, content-feedback, content-plan, content-publish, content-retire, content-review, content-test, content-validate, todo-manager
Draft, review and publish
folio-assistant-core/processes/content/draft-to-publication.bpmn
How the corpus becomes an officially published folio: a draft publication, its review, and the release authority's decision.
activities 13
lanes Editors + authoring agents · Work plan — beans (shared by humans and agents) · Corpus + build pipeline (system) · Publication manager · Review team (content · QC · technical officer) · Public review (commenters, review committee, editor) · Clinical / scientific SMEs · Programme manager (release authority)
skills content-author, content-feedback, content-publish, content-review, content-test, content-validate, public-comment, quality-control, render-kg-to-cdn, staging-review, todo-manager
Editing and HCI validation
folio-assistant-core/processes/content/editing-hci-validation.bpmn
What happens to one proposed change to one content block: drafted, validated mechanically and by review, shown to the editor, and committed to the corpus only if accepted.
activities 17
lanes Editor / author (person) · Work plan — beans (shared by humans and agents) · Authoring agent (system) · HCI validation pipeline (system) · Mechanical validation (system) · Non-mechanical validation (review agent or SME) · Corpus (versioned store)
skills before-after-preview, content-author, content-review, content-test, content-validate, corpus-commit-contract, decision-audit, todo-manager
Evidence for a recommendation
folio-assistant-core/processes/content/evidence-retrieval.bpmn
Frame a question for a recommendation, retrieve and appraise evidence from trusted sources, and either attach it or record the gap.
activities 10
lanes Author / guideline developer (person) · Evidence agent (system) · Trusted registries and observatories (external) · Work plan — beans (shared)
skills content-author, content-review, document-intake, evidence-appraisal, registry-authority-contract, todo-manager
Public comment on a review draft
folio-assistant-core/processes/content/public-comment.bpmn
A frozen, line-numbered draft went out for public review.
activities 11
lanes Public commenter · Intake agent · Review coordinator · Review committee · Editor · Author (human or agentic) · Change set — feature branch and staging
skills block-actions, public-comment, staging-review
Shared steps (folio-assistant-core)
folio-assistant-core/processes/global-tasks.bpmn
1 global task(s) that this layer's processes call by id.
activities 0
global tasks 1
skills todo-manager
Deep document research
folio-assistant-core/processes/library/deep-document-research.bpmn
Answer a question from a corpus this folio ALREADY HOLDS, iteratively, stopping on a stated condition.
activities 4
lanes Deep researcher
skills deep-document-research
Ingestion subprocess — build the L1 knowledge graph
folio-assistant-core/processes/library/ingest-build-l1-kg.bpmn
Build the L1 knowledge graph from what ingestion derived: Dublin Core, the manifest, the assets, their binding and their links.
activities 5
lanes Ingestion Engine (agent, runs unattended) · Corpus — L1 source knowledge graph
skills document-intake
Ingestion subprocess — derive content from the assets
folio-assistant-core/processes/library/ingest-derive-content.bpmn
Derive content from an ingested source's assets: the archive, technical metadata, images, audio, tabular data and provenance.
activities 6
lanes Ingestion Engine (agent, runs unattended)
skills document-intake
Ingestion subprocess — extract structure
folio-assistant-core/processes/library/ingest-extract-structure.bpmn
Extract the structure of an uploaded source: its text layer, OCR where it has none, sections, structure and claim candidates.
activities 5
lanes Ingestion Engine (agent, runs unattended)
skills document-intake
Ingestion subprocess — the L1 completeness gate
folio-assistant-core/processes/library/ingest-l1-completeness-gate.bpmn
Decide whether the derived content is complete enough to promote to the L1 graph, and who says so.
activities 4
lanes Ingestion Engine (agent, runs unattended) · Reviewer (SME or editor)
skills adjudication, document-intake, translation-manager, untainted-verification
L1 document ingestion — a document to the L1 source knowledge graph
folio-assistant-core/processes/library/l1-document-ingestion.bpmn
folio-assistant — L1 document ingestion — a document to the L1 source knowledge graph.
activities 12
lanes Ingestion Engine (agent, runs unattended) · Work plan — beans (shared by humans and agents) · Corpus — L1 source knowledge graph
skills document-intake, l1-document-ingestion, library-ingestion, theme-art-intake, todo-manager
Board: open and close content
folio-assistant-core/processes/ui/board-open-close.bpmn
What a reader does to a board and what the renderer does back: every card rests as its avatar, a window opens onto the one the reader chose, and it closes back to where it came from.
activities 7
lanes Reader · Board renderer
skills board-windows
Board: place a note
folio-assistant-core/processes/ui/board-place-note.bpmn
Putting a note at a spot on a board: write the note into the folio, record where it was drawn on THIS board, and sweep any position whose note has gone.
activities 3
lanes Author · Layout layer
skills board-diagram-interchange
Board: relocate content to the trashcan
folio-assistant-core/processes/ui/board-relocate.bpmn
Moving open content to the trashcan from the board, with the reader's confirmation in front of the move and not behind it.
activities 5
lanes Reader · Board renderer
skills board-diagram-interchange, board-windows, deletion-requires-confirmation

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed b08c961 · 2026-10-23T23:11:09Z