create-byan-agent 2.18.0 → 2.19.0

package/install/templates/_byan/workflow/simple/module/steps-v/step-04-agent-specs.md

@@ -0,0 +1,152 @@
+---
+name: 'step-04-agent-specs'
+description: 'Validate agent specifications and built agents'
+
+nextStepFile: './step-05-workflow-specs.md'
+agentSpecTemplate: '../../templates/agent-spec-template.md'
+agentArchitectureFile: '../../data/agent-architecture.md'
+agentValidationWorkflow: '{project-root}/_byan/workflow/simple/agent/steps-v/step-01-validate.md'
+validationReportOutput: '{validation_report_output}'
+targetPath: '{validation_target_path}'
+---
+
+# Step 4: Agent Specs Validation
+
+## STEP GOAL:
+
+Validate agent specifications and/or built agents, distinguishing between placeholder specs and fully implemented agents.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Quality Assurance** — dual-mode checking
+- ✅ Specs are expected, built agents are great
+- ✅ Track status of each agent
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Load Agent Files
+
+Find all agent files in `{targetPath}/agents/`:
+- `.spec.md` files (placeholder specs)
+- `.agent.yaml` files (built agents)
+
+### 2. Categorize Agents
+
+For each agent found, determine status:
+
+**Built Agents (.agent.yaml):**
+- Full implementation with complete persona, menu YAML
+- Can be validated in-depth via agent validation workflow
+
+**Spec Agents (.spec.md):**
+- High-level placeholder/blueprint
+- Awaiting creation via agent-builder workflow
+
+Track counts:
+- Total agents: {count}
+- Built agents: {count}
+- Spec agents: {count}
+
+### 3. Validate Spec Agents (.spec.md)
+
+For each spec agent, check:
+
+**Required Sections:**
+- [ ] Agent metadata (id, name, title, icon, module)
+- [ ] Role defined
+- [ ] Identity or communication style
+- [ ] Menu triggers documented
+- [ ] hasSidecar decision documented
+
+**Menu Triggers:**
+- [ ] At least one trigger per agent
+- [ ] Trigger → workflow mapping clear
+- [ ] No duplicate triggers (warn if found)
+
+**hasSidecar Documentation:**
+- [ ] Decision documented (true or false)
+- [ ] Rationale if true (why memory needed)
+
+**Placeholder Note:** These are specs awaiting agent-builder.
+
+### 4. Validate Built Agents (.agent.yaml)
+
+For each built agent, check:
+
+**Frontmatter Completeness:**
+- [ ] agent.metadata exists
+- [ ] agent.persona exists
+- [ ] agent.menu exists
+
+**YAML Structure:**
+- [ ] Valid YAML syntax
+- [ ] Required fields present
+
+**Status:** These are complete implementations and can be validated in detail via sub-process.
+
+### 5. Record Results
+
+Append to `{validationReportOutput}`:
+
+```markdown
+## Agent Specs Validation
+
+**Status:** {PASS/FAIL/WARNINGS}
+
+**Agent Summary:**
+- Total Agents: {count}
+- Built Agents: {count} {list}
+- Spec Agents: {count} {list}
+
+**Built Agents:**
+{for each built agent}
+- **{name}**: {status} - Ready for detailed validation via agent workflow
+
+**Spec Agents:**
+{for each spec agent}
+- **{name}**: {status} - Placeholder awaiting agent-builder
+
+**Issues Found:**
+{list any issues}
+
+**Recommendations:**
+{if specs exist}
+- Use `bmad:bmb:agents:agent-builder` to create {spec agent names}
+- After building agents, re-run validation to verify compliance
+{endif}
+```
+
+### 6. Note Sub-Process Opportunity
+
+**IF built agents exist:**
+
+"**The following built agents can be validated in detail:**"
+
+{list built agents}
+
+"**After this validation completes, I can spawn sub-processes to run the agent validation workflow on each built agent for deeper compliance checking.**"
+
+### 7. Auto-Proceed
+
+"**✓ Agent specs check complete.**"
+
+Proceeding to next validation...
+
+Load `{nextStepFile}`
+
+---
+
+## Success Metrics
+
+✅ All agent files checked
+✅ Status tracked (spec vs built)
+✅ hasSidecar decisions validated
+✅ Recommendations for specs documented
+✅ Sub-process opportunity noted

package/install/templates/_byan/workflow/simple/module/steps-v/step-05-workflow-specs.md

@@ -0,0 +1,152 @@
+---
+name: 'step-05-workflow-specs'
+description: 'Validate workflow specifications and built workflows'
+
+nextStepFile: './step-06-documentation.md'
+workflowSpecTemplate: '../../templates/workflow-spec-template.md'
+workflowValidationWorkflow: '{project-root}/_byan/workflow/simple/workflow/steps-v/step-01-validate.md'
+validationReportOutput: '{validation_report_output}'
+targetPath: '{validation_target_path}'
+---
+
+# Step 5: Workflow Specs Validation
+
+## STEP GOAL:
+
+Validate workflow specifications and/or built workflows, distinguishing between placeholder specs and fully implemented workflows.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are the **Quality Assurance** — dual-mode checking
+- ✅ Specs are expected, built workflows are great
+- ✅ Track status of each workflow
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Load Workflow Files
+
+Find all workflow files in `{targetPath}/workflows/`:
+- `.spec.md` files (placeholder specs)
+- `workflow.md` files (built workflows)
+
+### 2. Categorize Workflows
+
+For each workflow found, determine status:
+
+**Built Workflows (workflow.md with steps/ folder):**
+- Full implementation with step files, data, templates
+- Can be validated in-depth via workflow validation workflow
+
+**Spec Workflows (.spec.md):**
+- High-level placeholder/blueprint
+- Awaiting creation via workflow-builder workflow
+
+Track counts:
+- Total workflows: {count}
+- Built workflows: {count}
+- Spec workflows: {count}
+
+### 3. Validate Spec Workflows (.spec.md)
+
+For each spec workflow, check:
+
+**Required Sections:**
+- [ ] Workflow goal defined
+- [ ] Description present
+- [ ] Workflow type indicated
+- [ ] Step list or outline present
+- [ ] Agent association clear
+
+**Inputs/Outputs:**
+- [ ] Input requirements documented
+- [ ] Output format specified
+
+**Agent Integration:**
+- [ ] Primary agent identified
+- [ ] Multi-agent collaboration noted (if applicable)
+
+**Placeholder Note:** These are specs awaiting workflow-builder.
+
+### 4. Validate Built Workflows (workflow.md)
+
+For each built workflow, check:
+
+**Workflow Structure:**
+- [ ] workflow.md exists with proper frontmatter
+- [ ] steps/ folder exists (steps-c/, steps-e/, steps-v/ as appropriate)
+- [ ] Step files follow naming conventions
+
+**Step File Compliance:**
+- [ ] Each step has proper frontmatter
+- [ ] Step files within size limits
+- [ ] Menu handling follows standards
+
+**Status:** These are complete implementations and can be validated in detail via sub-process.
+
+### 5. Record Results
+
+Append to `{validationReportOutput}`:
+
+```markdown
+## Workflow Specs Validation
+
+**Status:** {PASS/FAIL/WARNINGS}
+
+**Workflow Summary:**
+- Total Workflows: {count}
+- Built Workflows: {count} {list}
+- Spec Workflows: {count} {list}
+
+**Built Workflows:**
+{for each built workflow}
+- **{name}**: {status} - Ready for detailed validation via workflow workflow
+
+**Spec Workflows:**
+{for each spec workflow}
+- **{name}**: {status} - Placeholder awaiting workflow-builder
+
+**Issues Found:**
+{list any issues}
+
+**Recommendations:**
+{if specs exist}
+- Use `bmad:bmb:workflows:workflow` or `/workflow` to create {spec workflow names}
+- After building workflows, re-run validation to verify compliance
+{endif}
+```
+
+### 6. Note Sub-Process Opportunity
+
+**IF built workflows exist:**
+
+"**The following built workflows can be validated in detail:**"
+
+{list built workflows}
+
+"**After this validation completes, I can spawn sub-processes to run the workflow validation workflow on each built workflow for deeper compliance checking.**"
+
+### 7. Auto-Proceed
+
+"**✓ Workflow specs check complete.**"
+
+Proceeding to next validation...
+
+Load `{nextStepFile}`
+
+---
+
+## Success Metrics
+
+✅ All workflow files checked
+✅ Status tracked (spec vs built)
+✅ Agent associations validated
+✅ Recommendations for specs documented
+✅ Sub-process opportunity noted

package/install/templates/_byan/workflow/simple/module/steps-v/step-08-report.md

@@ -0,0 +1,197 @@
+---
+name: 'step-08-report'
+description: 'Generate final validation report'
+
+validationReportOutput: '{validation_report_output}'
+agentValidationWorkflow: '{project-root}/_byan/workflow/simple/agent/steps-v/step-01-validate.md'
+workflowValidationWorkflow: '{project-root}/_byan/workflow/simple/workflow/steps-v/step-01-validate.md'
+---
+
+# Step 8: Validation Report
+
+## STEP GOAL:
+
+Compile all validation results into a final report with actionable recommendations, including sub-process validation opportunities for built agents and workflows.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are the **Quality Assurance** — reporting results
+- ✅ Clear, actionable feedback
+- ✅ Sub-process validation for built components
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Compile Overall Status
+
+Review all validation sections and determine overall status:
+
+**PASS:** All checks passed, ready to proceed
+**WARNINGS:** Minor issues found, can proceed with fixes
+**FAIL:** Critical issues found, must fix before proceeding
+
+### 2. Generate Summary
+
+Add to `{validationReportOutput}`:
+
+```markdown
+---
+
+## Overall Summary
+
+**Status:** {PASS/WARNINGS/FAIL}
+
+**Breakdown:**
+- File Structure: {status}
+- module.yaml: {status}
+- Agent Specs: {status} ({built_count} built, {spec_count} specs)
+- Workflow Specs: {status} ({built_count} built, {spec_count} specs)
+- Documentation: {status}
+- Installation Readiness: {status}
+
+---
+
+## Component Status
+
+### Agents
+- **Built Agents:** {count} — {list}
+- **Spec Agents:** {count} — {list}
+
+### Workflows
+- **Built Workflows:** {count} — {list}
+- **Spec Workflows:** {count} — {list}
+
+---
+
+## Recommendations
+
+{priority-listed-recommendations}
+
+### Priority 1 - Critical (must fix)
+
+{critical_issues}
+
+### Priority 2 - High (should fix)
+
+{high_priority_issues}
+
+### Priority 3 - Medium (nice to have)
+
+{medium_priority_issues}
+
+---
+
+## Sub-Process Validation
+
+{if built_agents_exist}
+### Built Agent Deep Validation
+
+The following built agents can be validated in detail using the agent validation workflow:
+
+{for each built_agent}
+- **{agent_name}** — Use `{agentValidationWorkflow}`
+
+**Recommendation:** Run agent validation workflow on each built agent to verify:
+- Frontmatter completeness
+- Persona quality
+- Menu structure compliance
+- Sidecar validation
+
+**After fixing any module-level issues, I can spawn sub-processes to validate each built agent in parallel.**
+{endif}
+
+{if built_workflows_exist}
+### Built Workflow Deep Validation
+
+The following built workflows can be validated in detail using the workflow validation workflow:
+
+{for each built_workflow}
+- **{workflow_name}** — Use `{workflowValidationWorkflow}`
+
+**Recommendation:** Run workflow validation workflow on each built workflow to verify:
+- Step file compliance
+- Tri-modal structure (steps-c/steps-e/steps-v/)
+- Frontmatter completeness
+- Size limits compliance
+
+**After fixing any module-level issues, I can spawn sub-processes to validate each built workflow in parallel.**
+{endif}
+
+---
+
+## Next Steps
+
+{based_on_status}
+
+{if specs_exist}
+### Build Spec Components
+
+**Spec Agents:** {spec_count}
+- Use `bmad:bmb:agents:agent-builder` to create: {spec_agent_names}
+
+**Spec Workflows:** {spec_count}
+- Use `bmad:bmb:workflows:workflow` to create: {spec_workflow_names}
+
+**After building specs, re-run validation to verify compliance.**
+{endif}
+
+---
+
+**Validation Completed:** {timestamp}
+```
+
+### 3. Present Report
+
+"**✓ Validation complete!**"
+
+**Overall Status:** {overall_status}
+
+**Report saved to:** `{validationReportOutput}`
+
+{if built_components_exist}
+"**Built components found:**"
+- Built Agents: {count}
+- Built Workflows: {count}
+
+"**These can be validated in depth via sub-process.**"
+{endif}
+
+### 4. Offer Next Actions
+
+"**What would you like to do?**"
+
+- **[R]ead report** — Show the full validation report
+- **[S]ub-process validation** — Run deep validation on built agents/workflows
+- **[F]ix issues** — Edit mode to fix identified problems
+- **[D]one** — Complete validation
+
+### 5. Menu Handling
+
+- IF R: Display the full report
+- IF S:
+  - {if built_components_exist}
+  - Offer to run agent validation on built agents
+  - Offer to run workflow validation on built workflows
+  - Can run in parallel for efficiency
+  - {else}
+  - "No built components found for sub-process validation."
+  - {endif}
+- IF F: Offer to load Edit mode
+- IF D: Complete validation session
+
+---
+
+## Success Metrics
+
+✅ Overall status determined
+✅ Complete report generated
+✅ Actionable recommendations provided
+✅ Sub-process validation opportunities identified
+✅ Next steps offered

package/install/templates/_byan/workflow/simple/module/workflow.md

@@ -0,0 +1,100 @@
+---
+name: module
+description: Quad-modal workflow for creating BMAD modules (Brief + Create + Edit + Validate)
+web_bundle: true
+installed_path: '{project-root}/_byan/workflow/simple/module'
+---
+
+# Module Workflow
+
+The module workflow guides users through creating complete, installable BMAD modules through a quad-modal process: **Brief → Create → Edit → Validate**.
+
+## What This Workflow Does
+
+- **Brief mode** — Collaboratively explore and design your module vision
+- **Create mode** — Build the module structure from a brief
+- **Edit mode** — Modify existing briefs or modules
+- **Validate mode** — Check compliance and completeness
+
+## Role
+
+You are the **Module Architect** — a specialist in BMAD module design. You understand that modules are complex entities requiring careful planning before implementation.
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Mode Determination
+
+**Check invocation context:**
+- Look for existing module brief or plan
+- Check if user is starting fresh or continuing work
+- Determine what mode they need
+
+**Ask the user:**
+
+**"Welcome to the Module workflow! What would you like to do?"**
+
+- **[B] Brief** — Create a module brief (exploratory, creative discovery)
+- **[C] Create** — Build a module from a brief
+- **[E] Edit** — Modify an existing brief or module
+- **[V] Validate** — Validate a brief or module
+
+### 2. Route to First Step
+
+**IF mode == brief (B):**
+Load `{installed_path}/steps-b/step-01-welcome.md`
+
+**IF mode == create (C):**
+Ask: "Where is the module brief?" → Load `{installed_path}/steps-c/step-01-load-brief.md`
+
+**IF mode == edit (E):**
+Ask: "What would you like to edit?" → Load `{installed_path}/steps-e/step-01-assess.md`
+
+**IF mode == validate (V):**
+Ask: "What would you like to validate?" → Load `{installed_path}/steps-v/step-01-validate.md`
+
+---
+
+## Configuration
+
+This workflow references:
+- `{installed_path}/data/` — Module standards and templates
+- `{installed_path}/templates/` — Output templates
+
+---
+
+## Workflow Structure
+
+```
+module/
+├── workflow.md              # This file - mode routing
+├── data/                    # Shared standards
+│   ├── module-standards.md
+│   ├── module-yaml-conventions.md
+│   ├── agent-architecture.md
+│   └── module-installer-standards.md
+├── templates/               # Output templates
+│   ├── brief-template.md
+│   ├── agent-spec-template.md
+│   └── workflow-spec-template.md
+├── steps-b/                 # Brief mode (13 steps)
+├── steps-c/                 # Create mode (8 steps)
+├── steps-e/                 # Edit mode
+└── steps-v/                 # Validate mode
+```
+
+---
+
+## Output
+
+**Brief mode produces:**
+- `module-brief-{code}.md` — Complete module vision document
+
+**Create mode produces:**
+- Module directory structure
+- `module.yaml` with install configuration
+- `_module-installer/` folder (if needed)
+- Agent placeholder/spec files
+- Workflow placeholder/spec files
+- `README.md` and `TODO.md`