⚖MikeWatch Forks of the Mike legal-AI codebase, distilled for legal-tech readers
Home · nforum/mike · this thread

Declarative workflow pack format proposed (docs and schema only)

nforum's amiel-35 proposes a YAML-based workflow pack format checked into the repo, with a JSON Schema and two example files. No importer exists yet - this is a design artifact for a future build.

workflowknowledge-management

The two commits add docs/workflows.md (162 lines), schemas/workflow.schema.json, and two example packs (simple-assistant.workflow.yaml, simple-tabular-review.workflow.yaml). No code changes. The proposed fields map directly to the current workflow DB columns: id, title, type (assistant or tabular), practice, jurisdiction, language, version, is_system, prompt_md, and columns_config. Required fields are id, title, type, and prompt_md; tabular workflows additionally require columns_config with at least one column including name, format, and prompt.

The id field is explicitly a stable file-level identifier, not a database PK. A follow-up commit clarifies this in the docs and adds a description to the schema: a future importer can use the pack id directly or derive a deterministic UUID from it when the DB requires UUID primary keys.

The suggested directory layout is workflow-packs/<language>/<jurisdiction>/<practice>/<id>.workflow.yaml, with schemas/ and docs/ at the repo root. Nothing about this proposal changes runtime behavior or the existing DB schema.

So what Worth pulling if you want to start versioning prompt content as reviewable files rather than opaque database rows. The cost is three doc/schema files and two examples - essentially free. The real work is the importer, which is explicitly deferred. Pulling the schema now locks in a format so any future implementation stays compatible, whether done in this fork or yours.

View this fork on GitHub →

Spotted something wrong? Or know the PR text has fresher detail than the writeup above?

Commits in this thread

3 commits from nforum/mike, oldest first. Source extracted verbatim from the harvested git log.

SHA Subject Author Date
f36519a0 docs(workflows): add declarative workflow pack format Amiel Lavon 2026-05-05 ↗ GitHub
557a990c docs(workflows): add declarative workflow pack format Amiel Lavon 2026-05-05 ↗ GitHub
0a70bada Merge PR #34: docs(workflows): declarative workflow pack format Bojan Plese 2026-05-07 ↗ GitHub

Capture this thread into my fork

Download a single Markdown prompt that tells Claude how to port every commit above into your working tree — adapting paths and structure to match your repo. Run it via claude -p < capture-thread-54.md from inside the repo you want the changes in.

⬇ Download capture-thread-54.md