Magnus Hedemarkandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
c0c7690724
Move the 8 directories under bundles/ to the repo root via git mv and remove the now-empty bundles/ directory. Replace the "bundles" entry in pyproject.toml [tool.deptry] extend_exclude with the 8 moved dir names so the moved trees stay excluded from Python dependency analysis. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2.9 KiB
Workflow Architect Bundle — Agent Instructions
Loading
Active Mode (Interview)
- Load
workflow-architectumbrella SKILL.md for context - Then load
skills/interviewer/SKILL.md— the interview protocol - After convergence, load
skills/bundle-builder/SKILL.mdto generate the bundle - Clean up
workflow-architect:state:*memory entries after generation
Passive Mode (Observation)
- Load
workflow-architectumbrella SKILL.md for context - Then load
skills/observer/SKILL.md— the observation protocol - Wait for trigger phrase before taking any action
- On trigger, scan session context and infer workflow
- Load
skills/bundle-builder/SKILL.mdto generate the bundle - Clean up
workflow-architect:state:*memory entries after generation
Output Location
Generated bundles are written to ~/.hermes/skills/<category>/<bundle-name>/ via the
write_file tool. The umbrella SKILL.md is registered via skill_manage(action='create')
and sub-skills are registered individually so they appear in skills_list() and can be
loaded with skill_view().
Registration
The umbrella SKILL.md is registered with skill_manage(action='create') in step 0 of the
bundle-builder. Each generated sub-skill is also registered (step 8) so it's immediately
discoverable by the agent's skill system. Verify with skill_view(name='<bundle-name>')
and skill_view(name='<bundle-name>-<first-phase-name>').
Registration
Both the umbrella SKILL.md and each sub-skill .md file in the generated
bundle are registered via skill_manage(action="create") so they appear in
skills_list() and are discoverable by the agent. Registration happens
during generation — no manual step required.
- Umbrella — registered under
<bundle-name>(the bundle root skill) - Sub-skills — registered under
<bundle-name>/<phase-name>
The umbrella's description frontmatter contains broad trigger conditions
that let the agent auto-detect the bundle in future sessions when the user's
conversation cues match a known workflow phase.
Environment
No environment variables required. State is stored via memory tool with
the prefix workflow-architect:state:.
Reference Files
| File | Purpose |
|---|---|
references/workflow-archetypes.md |
Pattern library for convergence detection |
references/trigger-condition-patterns.md |
Trigger condition format spec |
references/kanban-decision-criteria.md |
When to include kanban |
references/example-output/developer-triage/ |
Worked example of a generated bundle |
templates/skill-skeleton.md |
Template for generated sub-skills |
templates/manifest.yaml.tmpl |
Template for bundle manifest |
templates/kanban-board-setup.sh.tmpl |
Template for board creation script |
templates/kanban-task-blueprints.yaml.tmpl |
Template for phase-to-task mappings |
templates/decision-map.md.tmpl |
Template for Mermaid decision map |