Skip to content

Commit 94d00a4

Browse files
committed
refactor: standardize workflow descriptions for skill generation
Update all 21 workflow descriptions to follow consistent format: - Short human-readable prefix - Explicit trigger phrases with intent markers - Max 2 phrases per workflow to reduce false positives - Avoid substring matching issues with questions This improves workflow routing accuracy for AI skill invocation.
1 parent 671300e commit 94d00a4

21 files changed

Lines changed: 21 additions & 23 deletions

File tree

src/workflows/1-preproduction/brainstorm-game/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Brainstorm Game Workflow Configuration
22
name: "brainstorm-game"
3-
description: "Facilitate game brainstorming sessions with game-specific context, guidance, and game design techniques."
3+
description: "Game concept ideation with guided design techniques. Use when the user says 'lets create game design ideas' or 'I want to brainstorm game concepts'"
44
author: "BMad"
55

66
# Critical variables from config

src/workflows/1-preproduction/game-brief/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Game Brief - Interactive Workflow Configuration
22
name: game-brief
3-
description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
3+
description: "Game vision definition workflow. Use when the user says 'lets create a game brief' or 'I want to define my game vision'"
44
author: "BMad"
55

66
# Critical variables from config

src/workflows/2-design/gdd/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Game Design Document (GDD) Workflow
22
name: gdd
3-
description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
3+
description: "Comprehensive game design document creator. Use when the user says 'lets create a game design document' or 'I want to create a comprehensive GDD'"
44
author: "BMad"
55

66
# Critical variables from config

src/workflows/2-design/narrative/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Narrative Design Workflow
22
name: narrative
3-
description: "Narrative design workflow for story-driven games. Creates comprehensive narrative documentation including story structure, character arcs, world-building, dialogue systems, and production planning."
3+
description: "Story-driven narrative design documentation. Use when the user says 'lets create a narrative design document'"
44
author: "BMad"
55

66
# Critical variables from config

src/workflows/3-technical/game-architecture/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Game Architecture Workflow Configuration
22
name: game-architecture
3-
description: "Collaborative game architecture workflow for AI-agent consistency. Intelligent, adaptive conversation that produces a decision-focused game architecture document covering engine, systems, networking, and technical design optimized for game development."
3+
description: "Technical game systems architecture design. Use when the user says 'lets create a game architecture' or 'I want to design technical game systems'"
44
author: "BMad"
55

66
# Critical variables

src/workflows/3-technical/generate-project-context/workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: generate-project-context
3-
description: Creates a concise project-context.md file with critical rules and patterns that AI agents must follow when implementing game code. Optimized for LLM context efficiency.
3+
description: Generate AI-optimized project context file. Use when the user says 'lets create project context for game dev'
44
---
55

66
# Generate Project Context Workflow

src/workflows/4-production/code-review/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Review Story Workflow - Game Development
22
name: code-review
3-
description: "Perform an ADVERSARIAL Senior Developer code review that finds 3-10 specific problems in every story. Challenges everything: code quality, test coverage, architecture compliance, security, performance. NEVER accepts `looks good` - must find minimum issues and can auto-fix with user approval. Game-specific focus on 60fps, feel, and platform considerations."
3+
description: "Adversarial game dev code review. Use when the user says 'lets review this code for game dev issues'"
44
author: "BMad"
55

66
# Critical variables from config

src/workflows/4-production/correct-course/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Correct Course - Sprint Change Management Workflow
22
name: "correct-course"
3-
description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation"
3+
description: "Sprint change impact analysis and planning. Use when the user says 'I want to analyze and plan significant sprint changes'"
44
author: "BMad Method"
55

66
config_source: "{project-root}/_bmad/gds/config.yaml"

src/workflows/4-production/create-story/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: create-story
2-
description: "Create the next user story from epics+stories with enhanced context analysis and direct ready-for-dev marking"
2+
description: "User story creation from epics. Use when the user says 'lets create a user story' or 'I want to create a user story'"
33
author: "BMad"
44

55
# Critical variables from config

src/workflows/4-production/dev-story/workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: dev-story
2-
description: "Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria"
2+
description: "Story implementation and testing workflow. Use when the user says 'lets implement story tasks' or 'lets write tests for story'"
33
author: "BMad"
44

55
# Critical variables from config

0 commit comments

Comments
 (0)