feat: add workflow-architect bundle — workflow discovery and skills bundle generator #43

Merged
magnus merged 1 commit from feat/workflow-architect-bundle into main 2026-05-29 21:30:17 -04:00
Contributor

Summary

A meta-skill bundle that helps users discover their actual workflow through conversation or passive observation, then generates a tailored skills bundle that encodes it as loadable agent skills with trigger conditions.

File Listing

bundles/workflow-architect/
├── AGENTS.md                          # Agent loading protocol
├── SKILL.md                           # Umbrella: two modes, loading instructions
├── references/
│   ├── kanban-decision-criteria.md    # When to include kanban
│   ├── trigger-condition-patterns.md  # Trigger format spec
│   ├── workflow-archetypes.md         # 8 common patterns for convergence detection
│   └── example-output/
│       └── developer-triage/          # Worked example of generated output
├── templates/
│   ├── decision-map.md.tmpl           # Mermaid flowchart template
│   ├── kanban-board.yaml.tmpl         # Kanban definition template
│   ├── manifest.yaml.tmpl             # Bundle manifest template
│   └── skill-skeleton.md             # SKILL.md output template
└── skills/
    ├── interviewer/SKILL.md           # Active interrogation protocol
    ├── observer/SKILL.md              # Passive observation protocol
    └── bundle-builder/SKILL.md        # Synthesis engine

Features

Two Modes

  • Active interrogation — guided 8-15 question interview that adapts based on answers. Builds a structured model of workflow phases, branching signals, tool preferences, and friction points.
  • Passive observation — loads silently, then on trigger phrase scans current session context to infer workflow patterns from what actually happened.

Output Bundle

  • Sub-skills per workflow phase (each a valid Agent Skills SKILL.md with trigger conditions)
  • Manifest mapping skills to trigger conditions (keyword, context, signal, or compound)
  • Mermaid decision map visualizing the workflow flow
  • Optional kanban board definition (only if workflow is deterministic/linear)

Reference Material

  • 8 workflow archetypes with signature signals, typical phases, branching points, exit patterns, and kanban affinity
  • Canonical trigger condition patterns (keyword, context, signal, time-based)
  • Decision criteria for kanban inclusion

Base Fixes

Also fixes broken table formatting in AGENTS.md — the trigger table had double and triple pipe characters causing misaligned cells for the last 7 skill entries.

## Summary A meta-skill bundle that helps users discover their actual workflow through conversation or passive observation, then generates a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. ## File Listing ``` bundles/workflow-architect/ ├── AGENTS.md # Agent loading protocol ├── SKILL.md # Umbrella: two modes, loading instructions ├── references/ │ ├── kanban-decision-criteria.md # When to include kanban │ ├── trigger-condition-patterns.md # Trigger format spec │ ├── workflow-archetypes.md # 8 common patterns for convergence detection │ └── example-output/ │ └── developer-triage/ # Worked example of generated output ├── templates/ │ ├── decision-map.md.tmpl # Mermaid flowchart template │ ├── kanban-board.yaml.tmpl # Kanban definition template │ ├── manifest.yaml.tmpl # Bundle manifest template │ └── skill-skeleton.md # SKILL.md output template └── skills/ ├── interviewer/SKILL.md # Active interrogation protocol ├── observer/SKILL.md # Passive observation protocol └── bundle-builder/SKILL.md # Synthesis engine ``` ## Features ### Two Modes - **Active interrogation** — guided 8-15 question interview that adapts based on answers. Builds a structured model of workflow phases, branching signals, tool preferences, and friction points. - **Passive observation** — loads silently, then on trigger phrase scans current session context to infer workflow patterns from what actually happened. ### Output Bundle - Sub-skills per workflow phase (each a valid Agent Skills SKILL.md with trigger conditions) - Manifest mapping skills to trigger conditions (keyword, context, signal, or compound) - Mermaid decision map visualizing the workflow flow - Optional kanban board definition (only if workflow is deterministic/linear) ### Reference Material - 8 workflow archetypes with signature signals, typical phases, branching points, exit patterns, and kanban affinity - Canonical trigger condition patterns (keyword, context, signal, time-based) - Decision criteria for kanban inclusion ## Base Fixes Also fixes broken table formatting in AGENTS.md — the trigger table had double and triple pipe characters causing misaligned cells for the last 7 skill entries.
A new Agent Skills bundle that helps users discover their actual workflow
through two modes:

- Active interrogation: guided 8-15 question interview that adapts based on
  answers, building a structured model of the user's workflow phases,
  branching signals, tool preferences, and friction points

- Passive observation: loads silently, then on trigger phrase scans session
  context to infer workflow patterns from what actually happened

The output is a skills bundle: sub-skills per workflow phase with trigger
conditions, a manifest, a Mermaid decision map, and optionally a kanban
board if the workflow is deterministic/linear.

Ships 3 sub-skills (interviewer, observer, bundle-builder), 3 reference
documents (workflow archetypes, trigger condition patterns, kanban
decision criteria), 4 templates, and a worked example output bundle.

Also fixes broken table formatting in AGENTS.md (extra pipe characters
in trigger table rows).
magnus force-pushed feat/workflow-architect-bundle from 6efa514261 to 79cf37a44a 2026-05-29 21:30:02 -04:00 Compare
magnus merged commit 5c4e0618e7 into main 2026-05-29 21:30:17 -04:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
magnus/agent-skills!43
No description provided.