siesa-agents 2.1.39 → 2.1.41

package/_bmad/bmb/reference/workflows/meal-prep-nutrition/templates/profile-section.md

@@ -1,47 +0,0 @@
-## 🎯 Your Nutrition Goals
-
-### Primary Objective
-
-[User's main goal and motivation]
-
-### Target Timeline
-
-[Realistic timeframe and milestones]
-
-### Success Metrics
-
-- [Specific measurable outcomes]
-- [Non-scale victories]
-- [Lifestyle improvements]
-
----
-
-## 👤 Personal Profile
-
-### Basic Information
-
-- **Age:** [age]
-- **Gender:** [gender]
-- **Height:** [height]
-- **Weight:** [current weight]
-- **Activity Level:** [activity description]
-
-### Lifestyle Factors
-
-- **Daily Schedule:** [typical day structure]
-- **Cooking Frequency:** [how often they cook]
-- **Cooking Skill:** [beginner/intermediate/advanced]
-- **Available Time:** [time for meal prep]
-
-### Food Preferences
-
-- **Favorite Cuisines:** [list]
-- **Disliked Foods:** [list]
-- **Allergies:** [list]
-- **Dietary Restrictions:** [list]
-
-### Budget & Access
-
-- **Weekly Budget:** [range]
-- **Shopping Access:** [stores available]
-- **Special Considerations:** [family, social, etc.]

package/_bmad/bmb/reference/workflows/meal-prep-nutrition/templates/shopping-section.md

@@ -1,37 +0,0 @@
-## Weekly Shopping List
-
-### Check Pantry First
-
-- [List of common staples to verify]
-
-### Produce Section
-
-- [Item] - [Quantity] - [Used in]
-
-### Protein
-
-- [Item] - [Quantity] - [Used in]
-
-### Dairy/Alternatives
-
-- [Item] - [Quantity] - [Used in]
-
-### Grains/Starches
-
-- [Item] - [Quantity] - [Used in]
-
-### Frozen
-
-- [Item] - [Quantity] - [Used in]
-
-### Pantry
-
-- [Item] - [Quantity] - [Used in]
-
-### Money-Saving Tips
-
-- [Personalized savings strategies]
-
-### Flexible Swaps
-
-- [Alternative options if items unavailable]

package/_bmad/bmb/reference/workflows/meal-prep-nutrition/templates/strategy-section.md

@@ -1,18 +0,0 @@
-## Weekly Meal Framework
-
-### Protein Rotation
-
-- Monday: [Protein source]
-- Tuesday: [Protein source]
-- Wednesday: [Protein source]
-- Thursday: [Protein source]
-- Friday: [Protein source]
-- Saturday: [Protein source]
-- Sunday: [Protein source]
-
-### Meal Timing
-
-- Breakfast: [Time] - [Type]
-- Lunch: [Time] - [Type]
-- Dinner: [Time] - [Type]
-- Snacks: [As needed]

package/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md

@@ -1,59 +0,0 @@
----
-name: Meal Prep & Nutrition Plan
-description: Creates personalized meal plans through collaborative nutrition planning between an expert facilitator and individual seeking to improve their nutrition habits.
-web_bundle: true
----
-
-# Meal Prep & Nutrition Plan Workflow
-
-**Goal:** Create personalized meal plans through collaborative nutrition planning between an expert facilitator and individual seeking to improve their nutrition habits.
-
-**Your Role:** In addition to your name, communication_style, and persona, you are also a nutrition expert and meal planning specialist working collaboratively with the user. We engage in collaborative dialogue, not command-response, where you bring nutritional expertise and structured planning, while the user brings their personal preferences, lifestyle constraints, and health goals. Work together to create a sustainable, enjoyable nutrition plan.
-
----
-
-## WORKFLOW ARCHITECTURE
-
-This uses **step-file architecture** for disciplined execution:
-
-### Core Principles
-
-- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
-- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
-- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
-- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
-- **Append-Only Building**: Build documents by appending content as directed to the output file
-
-### Step Processing Rules
-
-1. **READ COMPLETELY**: Always read the entire step file before taking any action
-2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
-3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
-4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
-5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
-6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
-
-### Critical Rules (NO EXCEPTIONS)
-
-- 🛑 **NEVER** load multiple step files simultaneously
-- 📖 **ALWAYS** read entire step file before execution
-- 🚫 **NEVER** skip steps or optimize the sequence
-- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
-- 🎯 **ALWAYS** follow the exact instructions in the step file
-- ⏸️ **ALWAYS** halt at menus and wait for user input
-- 📋 **NEVER** create mental todo lists from future steps
-
----
-
-## INITIALIZATION SEQUENCE
-
-### 1. Configuration Loading
-
-Load and read full config from {project-root}/_bmad/core/config.yaml and resolve:
-
-- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-### 2. First Step EXECUTION
-
-Load, read the full file and then execute `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.

package/_bmad/bmb/workflows/agent/data/agent-compilation.md

@@ -1,273 +0,0 @@
-# Agent Compilation: YAML Source → Final Agent
-
-> **For the LLM running this workflow:** This document explains what the compiler adds. When building agents, focus on the YAML structure defined here—do NOT add things the compiler handles automatically.
->
-> **Example reference:** Compare `{workflow_path}/data/reference/module-examples/architect.agent.yaml` (source, 32 lines) with `architect.md` (compiled, 69 lines) to see what the compiler adds.
-
----
-
-## Quick Overview
-
-You write: **YAML source file** (`agent-name.agent.yaml`)
-Compiler produces: **Markdown with XML** (`agent-name.md`) for LLM consumption
-
-The compiler transforms your clean YAML into a fully functional agent by adding:
-- Frontmatter (name, description)
-- XML activation block with numbered steps
-- Menu handlers (workflow, exec, action)
-- Auto-injected menu items (MH, CH, PM, DA)
-- Rules section
-
----
-
-## What YOU Provide (YAML Source)
-
-Your YAML contains ONLY these sections:
-
-```yaml
-agent:
-  metadata:
-    id: "_bmad/..."
-    name: "Persona Name"
-    title: "Agent Title"
-    icon: "🔧"
-    module: "stand-alone" or "bmm" or "cis" or "bmgd"
-
-  persona:
-    role: "First-person role description"
-    identity: "Background and specializations"
-    communication_style: "How the agent speaks"
-    principles:
-      - "Core belief or methodology"
-
-  critical_actions:              # Optional - for Expert agents only
-    - "Load ./sidecar/memories.md"
-    - "Load ./sidecar/instructions.md"
-    - "ONLY access ./sidecar/"
-
-  prompts:                        # Optional - for Simple/Expert agents
-    - id: prompt-name
-      content: |
-        <instructions>Prompt content</instructions>
-
-  menu:                           # Your custom items only
-    - trigger: XX or fuzzy match on command-name
-      workflow: "path/to/workflow.yaml"   # OR
-      exec: "path/to/file.md"             # OR
-      action: "#prompt-id"
-      description: "[XX] Command description"
-```
-
----
-
-## What COMPILER Adds (DO NOT Include)
-
-### 1. Frontmatter
-```markdown
----
-name: "architect"
-description: "Architect"
----
-```
-**DO NOT add** frontmatter to your YAML.
-
-### 2. XML Activation Block
-```xml
-<activation critical="MANDATORY">
-  <step n="1">Load persona from this current agent file</step>
-  <step n="2">Load config to get {user_name}, {communication_language}</step>
-  <step n="3">Remember: user's name is {user_name}</step>
-  <!-- YOUR critical_actions inserted here as steps 4, 5, etc. -->
-  <step n="N">ALWAYS communicate in {communication_language}</step>
-  <step n="N+1">Show greeting + numbered menu</step>
-  <step n="N+2">STOP and WAIT for user input</step>
-  <step n="N+3">Input resolution rules</step>
-  <menu-handlers>...</menu-handlers>
-  <rules>...</rules>
-</activation>
-```
-**DO NOT create** activation sections—the compiler builds them.
-
-### 3. Auto-Injected Menu Items
-Every agent gets these 4 items automatically. **DO NOT add them to your YAML:**
-
-| Code | Trigger | Description |
-|------|---------|-------------|
-| MH | menu or help | Redisplay Menu Help |
-| CH | chat | Chat with the Agent about anything |
-| PM | party-mode | Start Party Mode |
-| DA | exit, leave, goodbye, dismiss agent | Dismiss Agent |
-
-### 4. Menu Handlers
-```xml
-<handler type="workflow">
-  When menu item has: workflow="path/to/workflow.yaml"
-  → Load workflow.xml and execute with workflow-config parameter
-</handler>
-<handler type="exec">
-  When menu item has: exec="path/to/file.md"
-  → Load and execute the file at that path
-</handler>
-```
-**DO NOT add** handlers—the compiler detects and generates them.
-
----
-
-## Before/After Example: Architect Agent
-
-### Source: `architect.agent.yaml` (32 lines - YOU WRITE)
-```yaml
-agent:
-  metadata:
-    id: "_bmad/bmm/agents/architect.md"
-    name: Winston
-    title: Architect
-    icon: 🏗️
-    module: bmm
-
-  persona:
-    role: System Architect + Technical Design Leader
-    identity: Senior architect with expertise in distributed systems...
-    communication_style: "Speaks in calm, pragmatic tones..."
-    principles: |
-      - User journeys drive technical decisions...
-
-  menu:
-    - trigger: WS or fuzzy match on workflow-status
-      workflow: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml"
-      description: "[WS] Get workflow status..."
-
-    - trigger: CA or fuzzy match on create-architecture
-      exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
-      description: "[CA] Create an Architecture Document"
-
-    - trigger: IR or fuzzy match on implementation-readiness
-      exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
-      description: "[IR] Implementation Readiness Review"
-```
-
-### Compiled: `architect.md` (69 lines - COMPILER PRODUCES)
-```markdown
----
-name: "architect"
-description: "Architect"
----
-
-You must fully embody this agent's persona...
-
-```xml
-<agent id="architect.agent.yaml" name="Winston" title="Architect" icon="🏗️">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from this current agent file (already in context)</step>
-  <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT...</step>
-  <step n="3">Remember: user's name is {user_name}</step>
-  <step n="4">Show greeting using {user_name} from config...</step>
-  <step n="5">STOP and WAIT for user input...</step>
-  <step n="6">On user input: Number → execute menu item[n]...</step>
-  <step n="7">When executing a menu item: Check menu-handlers section...</step>
-
-  <menu-handlers>
-    <handlers>
-      <handler type="workflow">...</handler>
-      <handler type="exec">...</handler>
-    </handlers>
-  </menu-handlers>
-
-  <rules>
-    <r>ALWAYS communicate in {communication_language}</r>
-    <r>Stay in character until exit selected</r>
-    <r>Display Menu items as the item dictates...</r>
-    <r>Load files ONLY when executing menu items...</r>
-  </rules>
-</activation>
-
-<persona>
-  <role>System Architect + Technical Design Leader</role>
-  <identity>Senior architect with expertise...</identity>
-  <communication_style>Speaks in calm, pragmatic tones...</communication_style>
-  <principles>- User journeys drive technical decisions...</principles>
-</persona>
-
-<menu>
-  <item cmd="MH or fuzzy match on menu or help">[MH] Redisplay Menu Help</item>
-  <item cmd="CH or fuzzy match on chat">[CH] Chat with the Agent about anything</item>
-  <item cmd="WS...">[WS] Get workflow status...</item>           ← YOUR CUSTOM ITEMS
-  <item cmd="CA...">[CA] Create an Architecture Document</item>
-  <item cmd="IR...">[IR] Implementation Readiness Review</item>
-  <item cmd="PM...">[PM] Start Party Mode</item>
-  <item cmd="DA...">[DA] Dismiss Agent</item>
-</menu>
-</agent>
-```
-**Key additions by compiler:** Frontmatter, activation block, handlers, rules, MH/CH/PM/DA menu items.
-
----
-
-## DO NOT DO Checklist
-
-When building agent YAML, **DO NOT:**
-
-- [ ] Add frontmatter (`---name/description---`) to YAML
-- [ ] Create activation blocks or XML sections
-- [ ] Add MH (menu/help) menu item
-- [ ] Add CH (chat) menu item
-- [ ] Add PM (party-mode) menu item
-- [ ] Add DA (dismiss/exit) menu item
-- [ ] Add menu handlers (workflow/exec logic)
-- [ ] Add rules section
-- [ ] Duplicate any auto-injected content
-
-**DO:**
-- [ ] Define metadata (id, name, title, icon, module)
-- [ ] Define persona (role, identity, communication_style, principles)
-- [ ] Define critical_actions (Expert agents only)
-- [ ] Define prompts with IDs (Simple/Expert agents only)
-- [ ] Define menu with your custom items only
-- [ ] Use proper trigger format: `XX or fuzzy match on command-name`
-- [ ] Use proper description format: `[XX] Description text`
-
----
-
-## Expert Agent: critical_actions
-
-For Expert agents with sidecars, your `critical_actions` become activation steps:
-
-```yaml
-critical_actions:
-  - "Load COMPLETE file ./agent-sidecar/memories.md"
-  - "Load COMPLETE file ./agent-sidecar/instructions.md"
-  - "ONLY read/write files in ./agent-sidecar/"
-```
-
-The compiler injects these as steps 4, 5, 6 in the activation block:
-
-```xml
-<step n="4">Load COMPLETE file ./agent-sidecar/memories.md</step>
-<step n="5">Load COMPLETE file ./agent-sidecar/instructions.md</step>
-<step n="6">ONLY read/write files in ./agent-sidecar/</step>
-<step n="7">ALWAYS communicate in {communication_language}</step>
-```
-
----
-
-## Division of Responsibilities
-
-| Aspect | YOU Provide (YAML) | COMPILER Adds |
-|--------|-------------------|---------------|
-| Agent identity | metadata + persona | Wrapped in XML |
-| Memory/actions | critical_actions | Inserted as activation steps |
-| Prompts | prompts with IDs | Referenced by menu actions |
-| Menu items | Your custom commands only | + MH, CH, PM, DA (auto) |
-| Activation | — | Full XML block with handlers |
-| Rules | — | Standardized rules section |
-| Frontmatter | — | name/description header |
-
----
-
-## Quick Reference for LLM
-
-- **Focus on:** Clean YAML structure, persona definition, custom menu items
-- **Ignore:** What happens after compilation—that's the compiler's job
-- **Remember:** Every agent gets MH, CH, PM, DA automatically—don't add them
-- **Expert agents:** Use `critical_actions` for sidecar file loading
-- **Module agents:** Use `workflow:` or `exec:` references, not inline actions

package/_bmad/bmb/workflows/agent/data/agent-menu-patterns.md

@@ -1,233 +0,0 @@
-# Agent Menu Patterns
-
-Technical reference for creating agent menu items in YAML.
-
----
-
-## Menu Item Structure
-
-Every menu item requires:
-
-```yaml
-- trigger: XX or fuzzy match on command-name
-  [handler]: [value]
-  description: '[XX] Display text here'
-  data: [optional]   # Pass file to workflow
-```
-
-**Required fields:**
-- `trigger` - Format: `XX or fuzzy match on command-name` (XX = 2-letter code, command-name = what user says)
-- `description` - Must start with `[XX]` code
-- Handler - Either `action` (Simple/Expert) or `exec` (Module)
-
-**Reserved codes (do NOT use):** MH, CH, PM, DA (auto-injected by compiler)
-
----
-
-## Handler Types
-
-### Action Handler
-
-For Simple/Expert agents with self-contained operations.
-
-```yaml
-# Reference prompt by ID
-- trigger: WC or fuzzy match on write-commit
-  action: '#write-commit'
-  description: '[WC] Write commit message'
-
-# Direct inline instruction
-- trigger: QC or fuzzy match on quick-commit
-  action: 'Generate commit message from diff'
-  description: '[QC] Quick commit from diff'
-```
-
-**When to use:** Simple/Expert agents. Use `#id` for complex multi-step prompts, inline text for simple operations.
-
-### Workflow Handler
-
-For module agents referencing external workflow files.
-
-```yaml
-- trigger: CP or fuzzy match on create-prd
-  exec: '{project-root}/_bmad/bmm/workflows/create-prd/workflow.md'
-  description: '[CP] Create Product Requirements Document'
-
-- trigger: GB or fuzzy match on brainstorm
-  exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
-  description: '[GB] Guided brainstorming session'
-
-# Planned but unimplemented
-- trigger: FF or fuzzy match on future-feature
-  exec: 'todo'
-  description: '[FF] Coming soon'
-```
-
-**When to use:** Module agents, multi-step workflows, complex processes. Use `exec: 'todo'` for unimplemented features.
-
-### Data Parameter (Optional)
-
-Add to ANY handler to pass files to the workflow/action.
-
-```yaml
-- trigger: TS or fuzzy match on team-standup
-  exec: '{project-root}/_bmad/bmm/tasks/team-standup.md'
-  data: '{project-root}/_bmad/_config/agent-manifest.csv'
-  description: '[TS] Run team standup'
-
-- trigger: AM or fuzzy match on analyze-metrics
-  action: 'Analyze these metrics for trends'
-  data: '{project-root}/_data/metrics.json'
-  description: '[AM] Analyze metrics'
-```
-
-**When to use:** Workflow needs input file, action processes external data.
-
----
-
-## Prompts Section
-
-For Simple/Expert agents, define reusable prompts referenced by `action: '#id'`.
-
-```yaml
-prompts:
-  - id: analyze-code
-    content: |
-      <instructions>Analyze code for patterns</instructions>
-      <process>1. Identify structure 2. Check issues 3. Suggest improvements</process>
-
-menu:
-  - trigger: AC or fuzzy match on analyze-code
-    action: '#analyze-code'
-    description: '[AC] Analyze code patterns'
-```
-
-**Common XML tags:** `<instructions>`, `<process>`, `<example>`, `<output_format>`
-
----
-
-## Path Variables
-
-**Always use variables, never hardcoded paths:**
-
-```yaml
-# ✅ CORRECT
-exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
-data: '{project-root}/_data/metrics.csv'
-
-# ❌ WRONG
-exec: '../../../core/workflows/brainstorming/workflow.yaml'
-```
-
-**Available variables:**
-- `{project-root}` - Project root directory
-- `{output_folder}` - Document output location
-- `{user_name}` - User's name from config
-- `{communication_language}` - Language preference
-
-**Expert Agent sidecar paths:**
-```yaml
-# Agent YAML referencing sidecar files
-action: 'Update {project-root}/_bmad/_memory/journal-keeper-sidecar/memories.md with insights'
-```
-
----
-
-## Creation Thought Process
-
-When creating menu items, follow this sequence:
-
-1. **User capability** → "Check code for issues"
-2. **Choose code** → `LC` (Lint Code)
-3. **Write trigger** → `LC or fuzzy match on lint-code`
-4. **Choose handler** → `action` (inline is simple enough)
-5. **Write description** → `[LC] Lint code for issues`
-
-Result:
-```yaml
-- trigger: LC or fuzzy match on lint-code
-  action: 'Check code for common issues and anti-patterns'
-  description: '[LC] Lint code for issues'
-```
-
----
-
-## Complete Examples
-
-### Simple Agent Menu
-
-```yaml
-prompts:
-  - id: format-code
-    content: |
-      <instructions>Format code to style guidelines</instructions>
-      <process>1. Indentation 2. Spacing 3. Naming</process>
-
-menu:
-  - trigger: FC or fuzzy match on format-code
-    action: '#format-code'
-    description: '[FC] Format code to style guidelines'
-
-  - trigger: LC or fuzzy match on lint-code
-    action: 'Check code for common issues and anti-patterns'
-    description: '[LC] Lint code for issues'
-
-  - trigger: SI or fuzzy match on suggest-improvements
-    action: 'Suggest improvements following project-context.md guidelines'
-    description: '[SI] Suggest improvements'
-```
-
-### Expert Agent Menu
-
-```yaml
-critical_actions:
-  - 'Load COMPLETE file {project-root}/_bmad/_memory/journal-keeper-sidecar/memories.md'
-  - 'Load COMPLETE file {project-root}/_bmad/_memory/journal-keeper-sidecar/instructions.md'
-  - 'ONLY read/write files in {project-root}/_bmad/_memory/journal-keeper-sidecar/'
-
-prompts:
-  - id: guided-entry
-    content: |
-      <instructions>Guide through journal entry</instructions>
-
-menu:
-  - trigger: WE or fuzzy match on write-entry
-    action: '#guided-entry'
-    description: '[WE] Write journal entry'
-
-  - trigger: QC or fuzzy match on quick-capture
-    action: 'Save entry to {project-root}/_bmad/_memory/journal-keeper-sidecar/entries/entry-{date}.md'
-    description: '[QC] Quick capture'
-
-  - trigger: SM or fuzzy match on save-memory
-    action: 'Update {project-root}/_bmad/_memory/journal-keeper-sidecar/memories.md with insights'
-    description: '[SM] Save session'
-```
-
-### Module Agent Menu
-
-```yaml
-menu:
-  - trigger: WI or fuzzy match on workflow-init
-    exec: '{project-root}/_bmad/bmm/workflows/workflow-status/workflow.md'
-    description: '[WI] Initialize workflow path'
-
-  - trigger: BS or fuzzy match on brainstorm
-    exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
-    description: '[BS] Guided brainstorming'
-
-  - trigger: CP or fuzzy match on create-prd
-    exec: '{project-root}/_bmad/bmm/workflows/create-prd/workflow.md'
-    description: '[CP] Create PRD'
-```
-
----
-
-## Key Patterns to Remember
-
-1. **Triggers always:** `XX or fuzzy match on command-name`
-2. **Descriptions always:** `[XX] Display text`
-3. **Reserved codes:** MH, CH, PM, DA (never use)
-4. **Codes must be:** Unique within each agent
-5. **Paths always:** `{project-root}` variable, never relative
-6. **Expert sidecars:** `{project-root}/_bmad/_memory/{sidecar-folder}/`