BoMB updates
This commit is contained in:
Brian Madison
@@ -57,12 +57,34 @@
|
||||
- [ ] Output location is writable
|
||||
- [ ] Dependencies (if any) are available
|
||||
|
||||
## Web Bundle Configuration (if applicable)
|
||||
|
||||
- [ ] web_bundle section present if needed
|
||||
- [ ] Name, description, author copied from main config
|
||||
- [ ] All file paths converted to bmad/-relative format
|
||||
- [ ] NO {config_source} variables in web bundle
|
||||
- [ ] NO {project-root} prefixes in paths
|
||||
- [ ] Instructions path listed correctly
|
||||
- [ ] Validation/checklist path listed correctly
|
||||
- [ ] Template path listed (if document workflow)
|
||||
- [ ] All data files referenced in instructions are listed
|
||||
- [ ] All sub-workflows are included
|
||||
- [ ] web_bundle_files array is complete:
|
||||
- [ ] Instructions.md included
|
||||
- [ ] Checklist.md included
|
||||
- [ ] Template.md included (if applicable)
|
||||
- [ ] All CSV/JSON data files included
|
||||
- [ ] All referenced templates included
|
||||
- [ ] All sub-workflow files included
|
||||
- [ ] No external dependencies outside bundle
|
||||
|
||||
## Documentation
|
||||
|
||||
- [ ] README created (if requested)
|
||||
- [ ] Usage instructions clear
|
||||
- [ ] Example command provided
|
||||
- [ ] Special requirements noted
|
||||
- [ ] Web bundle deployment noted (if applicable)
|
||||
|
||||
## Final Validation
|
||||
|
||||
|
||||
@@ -247,6 +247,64 @@ Ask if they want to:
|
||||
- Add additional steps or features
|
||||
</step>
|
||||
|
||||
<step n="9b" goal="Configure web bundle (optional)">
|
||||
<ask>Will this workflow need to be deployable as a web bundle? [yes/no]</ask>
|
||||
|
||||
If yes:
|
||||
<action>Explain web bundle requirements:</action>
|
||||
|
||||
- Web bundles are self-contained and cannot use config_source variables
|
||||
- All files must be explicitly listed in web_bundle_files
|
||||
- File paths use bmad/ root (not {project-root})
|
||||
|
||||
<action>Configure web_bundle section in workflow.yaml:</action>
|
||||
|
||||
1. Copy core workflow metadata (name, description, author)
|
||||
2. Convert all file paths to bmad/-relative paths:
|
||||
- Remove {project-root}/ prefix
|
||||
- Remove {config_source} references (use hardcoded values)
|
||||
- Example: "{project-root}/bmad/bmm/workflows/x" → "bmad/bmm/workflows/x"
|
||||
|
||||
3. List ALL referenced files:
|
||||
- Scan instructions.md for any file paths
|
||||
- Scan template.md for any includes or references
|
||||
- Include all data files (CSV, JSON, etc.)
|
||||
- Include any sub-workflow YAML files
|
||||
- Include any shared templates
|
||||
|
||||
4. Create web_bundle_files array with complete list
|
||||
|
||||
Example:
|
||||
|
||||
```yaml
|
||||
web_bundle:
|
||||
name: '{workflow_name}'
|
||||
description: '{workflow_description}'
|
||||
author: '{author}'
|
||||
instructions: 'bmad/{module}/workflows/{workflow}/instructions.md'
|
||||
validation: 'bmad/{module}/workflows/{workflow}/checklist.md'
|
||||
template: 'bmad/{module}/workflows/{workflow}/template.md'
|
||||
|
||||
# Any data files (no config_source)
|
||||
data_file: 'bmad/{module}/workflows/{workflow}/data.csv'
|
||||
|
||||
web_bundle_files:
|
||||
- 'bmad/{module}/workflows/{workflow}/instructions.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/checklist.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/template.md'
|
||||
- 'bmad/{module}/workflows/{workflow}/data.csv'
|
||||
# Add every single file referenced anywhere
|
||||
```
|
||||
|
||||
<action>Validate web bundle completeness:</action>
|
||||
|
||||
- Ensure no {config_source} variables remain
|
||||
- Verify all file paths are listed
|
||||
- Check that paths are bmad/-relative
|
||||
|
||||
<template-output>web_bundle_config</template-output>
|
||||
</step>
|
||||
|
||||
<step n="10" goal="Document and finalize">
|
||||
Create a brief README for the workflow folder explaining:
|
||||
- Purpose and use case
|
||||
|
||||
@@ -422,6 +422,105 @@ Check requirements against goals.
|
||||
- **No checkpoints** - Add `<template-output>` tags
|
||||
- **Vague instructions** - Be explicit about expectations
|
||||
|
||||
## Web Bundles
|
||||
|
||||
Web bundles allow workflows to be deployed as self-contained packages for web environments.
|
||||
|
||||
### When to Use Web Bundles
|
||||
|
||||
- Deploying workflows to web-based AI platforms
|
||||
- Creating shareable workflow packages
|
||||
- Ensuring workflow portability without dependencies
|
||||
- Publishing workflows for public use
|
||||
|
||||
### Web Bundle Requirements
|
||||
|
||||
1. **Self-Contained**: No external dependencies
|
||||
2. **No Config Variables**: Cannot use `{config_source}` references
|
||||
3. **Complete File List**: Every referenced file must be listed
|
||||
4. **Relative Paths**: Use `bmad/` root paths (no `{project-root}`)
|
||||
|
||||
### Creating a Web Bundle
|
||||
|
||||
Add this section to your workflow.yaml:
|
||||
|
||||
```yaml
|
||||
web_bundle:
|
||||
name: 'workflow-name'
|
||||
description: 'Workflow description'
|
||||
author: 'Your Name'
|
||||
|
||||
# Core files (bmad/-relative paths)
|
||||
instructions: 'bmad/module/workflows/workflow/instructions.md'
|
||||
validation: 'bmad/module/workflows/workflow/checklist.md'
|
||||
template: 'bmad/module/workflows/workflow/template.md'
|
||||
|
||||
# Data files (no config_source allowed)
|
||||
data_file: 'bmad/module/workflows/workflow/data.csv'
|
||||
|
||||
# Complete file list - CRITICAL!
|
||||
web_bundle_files:
|
||||
- 'bmad/module/workflows/workflow/instructions.md'
|
||||
- 'bmad/module/workflows/workflow/checklist.md'
|
||||
- 'bmad/module/workflows/workflow/template.md'
|
||||
- 'bmad/module/workflows/workflow/data.csv'
|
||||
# Include ALL referenced files
|
||||
```
|
||||
|
||||
### Converting Existing Workflows
|
||||
|
||||
1. **Remove Config Dependencies**:
|
||||
- Replace `{config_source}:variable` with hardcoded values
|
||||
- Convert `{project-root}/bmad/` to `bmad/`
|
||||
|
||||
2. **Inventory All Files**:
|
||||
- Scan instructions.md for file references
|
||||
- Check template.md for includes
|
||||
- List all data files
|
||||
|
||||
3. **Test Completeness**:
|
||||
- Ensure no missing file references
|
||||
- Verify all paths are relative to bmad/
|
||||
|
||||
### Example: Complete Web Bundle
|
||||
|
||||
```yaml
|
||||
web_bundle:
|
||||
name: 'analyze-requirements'
|
||||
description: 'Requirements analysis workflow'
|
||||
author: 'BMad Team'
|
||||
|
||||
instructions: 'bmad/bmm/workflows/analyze-requirements/instructions.md'
|
||||
validation: 'bmad/bmm/workflows/analyze-requirements/checklist.md'
|
||||
template: 'bmad/bmm/workflows/analyze-requirements/template.md'
|
||||
|
||||
# Data files
|
||||
techniques_data: 'bmad/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
patterns_data: 'bmad/bmm/workflows/analyze-requirements/patterns.json'
|
||||
|
||||
# Sub-workflow reference
|
||||
validation_workflow: 'bmad/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
|
||||
web_bundle_files:
|
||||
# Core workflow files
|
||||
- 'bmad/bmm/workflows/analyze-requirements/instructions.md'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/checklist.md'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/template.md'
|
||||
|
||||
# Data files
|
||||
- 'bmad/bmm/workflows/analyze-requirements/techniques.csv'
|
||||
- 'bmad/bmm/workflows/analyze-requirements/patterns.json'
|
||||
|
||||
# Sub-workflow and its files
|
||||
- 'bmad/bmm/workflows/validate-requirements/workflow.yaml'
|
||||
- 'bmad/bmm/workflows/validate-requirements/instructions.md'
|
||||
- 'bmad/bmm/workflows/validate-requirements/checklist.md'
|
||||
|
||||
# Shared templates referenced in instructions
|
||||
- 'bmad/bmm/templates/requirement-item.md'
|
||||
- 'bmad/bmm/templates/validation-criteria.md'
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Variables Not Replaced
|
||||
|
||||
@@ -33,3 +33,32 @@ required_tools: #optional, can be omitted
|
||||
- "Tool Name": #example, can be omitted if none
|
||||
description: "Description of why this tool is needed"
|
||||
link: "https://link-to-tool.com"
|
||||
|
||||
# Web Bundle Configuration (optional - for web-deployable workflows)
|
||||
# IMPORTANT: Web bundles are self-contained and cannot use config_source variables
|
||||
# All referenced files must be listed in web_bundle_files
|
||||
web_bundle: #optional, can be omitted
|
||||
name: "{WORKFLOW_CODE}"
|
||||
description: "{WORKFLOW_DESCRIPTION}"
|
||||
author: "BMad"
|
||||
|
||||
# Core workflow files (paths relative to bmad/ root)
|
||||
instructions: "bmad/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
validation: "bmad/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
template: "bmad/{module-code}/workflows/{workflow-code}/template.md" # if document workflow
|
||||
|
||||
# Reference any data files or additional workflows (no config_source allowed)
|
||||
# brain_techniques: "bmad/{module-code}/workflows/{workflow-code}/data-file.csv"
|
||||
# sub_workflow: "bmad/{module-code}/workflows/other-workflow/workflow.yaml"
|
||||
|
||||
# CRITICAL: List ALL files used by this workflow
|
||||
# This includes instructions, validation, templates, data files,
|
||||
# and any files referenced within those files
|
||||
web_bundle_files:
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/instructions.md"
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/checklist.md"
|
||||
- "bmad/{module-code}/workflows/{workflow-code}/template.md"
|
||||
# Add ALL referenced files here - examine instructions.md and template.md
|
||||
# for any file paths and include them all
|
||||
# - "bmad/{module-code}/workflows/{workflow-code}/data/example.csv"
|
||||
# - "bmad/{module-code}/templates/shared-template.md"
|
||||
|
||||
Reference in New Issue
Block a user