initial commit

_bmad/cis/workflows/bmad-cis-storytelling/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-cis-storytelling
+description: 'Craft compelling narratives using story frameworks. Use when the user says "help me with storytelling" or "I want to create a narrative through storytelling"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

_bmad/cis/workflows/bmad-cis-storytelling/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

_bmad/cis/workflows/bmad-cis-storytelling/story-types.csv

@@ -0,0 +1,26 @@
+category,story_type,name,description,key_questions
+transformation,hero-journey,Hero's Journey,Classic transformation arc following protagonist through adventure and return with wisdom,Who is the hero?|What's their ordinary world?|What call disrupts their world?|What trials do they face?|How are they transformed?
+transformation,pixar-spine,Pixar Story Spine,Emotional narrative structure using once upon a time framework that builds tension to resolution,Once upon a time what?|Every day what happened?|Until one day what changed?|Because of that what?|Until finally how resolved?
+transformation,customer-journey,Customer Journey,Narrative following customer transformation from pain point through solution to success,What was the before struggle?|What discovery moment occurred?|How did they implement?|What transformation happened?|What's their new reality?
+transformation,challenge-overcome,Challenge Overcome,Dramatic structure centered on confronting and conquering significant obstacles,What obstacle blocked progress?|How did stakes escalate?|What was the darkest moment?|What breakthrough occurred?|What was learned?
+transformation,character-arc,Character Arc,Personal evolution story showing growth through experience and struggle,Who are they at start?|What forces change?|What do they resist?|What breakthrough shifts them?|Who have they become?
+strategic,brand-story,Brand Story,Authentic narrative communicating brand values mission and unique market position,What sparked this brand?|What core values drive it?|How does it impact customers?|What makes it different?|Where is it heading?
+strategic,vision-narrative,Vision Narrative,Future-focused story painting vivid picture of desired state and path to get there,What's the current reality?|What opportunity emerges?|What's the bold vision?|What's the strategic path?|What does transformed future look like?
+strategic,origin-story,Origin Story,Foundational narrative explaining how something came to be and why it matters today,What was the spark moment?|What early struggles occurred?|What key breakthrough happened?|How did it evolve?|What's the current mission?
+strategic,positioning-story,Positioning Story,Narrative establishing unique market position and competitive differentiation,What market gap exists?|How are you uniquely qualified?|What makes your approach different?|Why should audience care?|What future do you enable?
+strategic,culture-story,Culture Story,Internal narrative defining organizational values behaviors and identity,What principles guide decisions?|What behaviors exemplify culture?|What stories illustrate values?|How do people experience it?|What culture are you building?
+persuasive,pitch-narrative,Pitch Narrative,Compelling story structure designed to inspire action investment or partnership,What problem landscape exists?|What's your vision for solution?|What proof validates approach?|What's the opportunity size?|What action do you want?
+persuasive,sales-story,Sales Story,Customer-centric narrative demonstrating value and building desire for solution,What pain do they feel?|How do you understand it?|What solution transforms situation?|What results can they expect?|What's the path forward?
+persuasive,change-story,Change Story,Narrative making case for transformation and mobilizing people through transition,Why can't we stay here?|What does better look like?|What's at stake if we don't?|How do we get there?|What's in it for them?
+persuasive,fundraising-story,Fundraising Story,Emotionally compelling narrative connecting donor values to mission impact,What problem breaks hearts?|What solution creates hope?|What impact will investment make?|Why is this urgent?|How can they help?
+persuasive,advocacy-story,Advocacy Story,Story galvanizing support for cause movement or policy change,What injustice demands attention?|Who is affected and how?|What change is needed?|What happens if we act?|How can they join?
+analytical,data-story,Data Storytelling,Transform data insights into compelling narrative with clear actionable takeaways,What context is needed?|What data reveals insight?|What patterns explain it?|So what why does it matter?|What actions should follow?
+analytical,case-study,Case Study,Detailed narrative documenting real-world application results and learnings,What was the situation?|What approach was taken?|What challenges emerged?|What results were achieved?|What lessons transfer?
+analytical,research-story,Research Narrative,Story structure presenting research findings in accessible engaging way,What question drove research?|How was it investigated?|What did you discover?|What does it mean?|What are implications?
+analytical,insight-narrative,Insight Narrative,Narrative revealing non-obvious truth or pattern that shifts understanding,What did everyone assume?|What did you notice?|What deeper pattern emerged?|Why does it matter?|What should change?
+analytical,process-story,Process Story,Behind-the-scenes narrative showing how something was made or accomplished,What was being created?|What approach was chosen?|What challenges arose?|How were they solved?|What was learned?
+emotional,hook-driven,Hook Driven,Story structure maximizing emotional engagement through powerful opening and touchpoints,What surprising fact opens?|What urgent question emerges?|Where are emotional peaks?|What creates relatability?|What payoff satisfies?
+emotional,conflict-resolution,Conflict Resolution,Narrative centered on tension building and satisfying resolution of core conflict,What's the central conflict?|Who wants what and why?|What prevents resolution?|How does tension escalate?|How is it resolved?
+emotional,empathy-story,Empathy Story,Story designed to create emotional connection and understanding of other perspectives,Whose perspective are we taking?|What do they experience?|What do they feel?|Why should audience care?|What common ground exists?
+emotional,human-interest,Human Interest,Personal story highlighting universal human experiences and emotions,Who is at the center?|What personal stakes exist?|What universal themes emerge?|What emotional journey occurs?|What makes it relatable?
+emotional,vulnerable-story,Vulnerable Story,Authentic personal narrative sharing struggle failure or raw truth to build connection,What truth is hard to share?|What struggle was faced?|What was learned?|Why share this now?|What hope does it offer?

_bmad/cis/workflows/bmad-cis-storytelling/template.md

@@ -0,0 +1,113 @@
+# Story Output
+
+**Created:** {{date}}
+**Storyteller:** {{agent_role}} {{agent_name}}
+**Author:** {{user_name}}
+
+## Story Information
+
+**Story Type:** {{story_type}}
+
+**Framework Used:** {{framework_name}}
+
+**Purpose:** {{story_purpose}}
+
+**Target Audience:** {{target_audience}}
+
+## Story Structure
+
+### Opening Hook
+
+{{opening_hook}}
+
+### Core Narrative
+
+{{core_narrative}}
+
+### Key Story Beats
+
+{{story_beats}}
+
+### Emotional Arc
+
+{{emotional_arc}}
+
+### Resolution/Call to Action
+
+{{resolution}}
+
+## Complete Story
+
+{{complete_story}}
+
+## Story Elements Analysis
+
+### Character/Voice
+
+{{character_voice}}
+
+### Conflict/Tension
+
+{{conflict_tension}}
+
+### Transformation/Change
+
+{{transformation}}
+
+### Emotional Touchpoints
+
+{{emotional_touchpoints}}
+
+### Key Messages
+
+{{key_messages}}
+
+## Variations AND Adaptations
+
+### Short Version (Tweet/Social)
+
+{{short_version}}
+
+### Medium Version (Email/Blog)
+
+{{medium_version}}
+
+### Extended Version (Article/Presentation)
+
+{{extended_version}}
+
+## Usage Guidelines
+
+### Best Channels
+
+{{best_channels}}
+
+### Audience Considerations
+
+{{audience_considerations}}
+
+### Tone AND Voice Notes
+
+{{tone_notes}}
+
+### Adaptation Suggestions
+
+{{adaptation_suggestions}}
+
+## Next Steps
+
+### Refinement Opportunities
+
+{{refinement_opportunities}}
+
+### Additional Versions Needed
+
+{{additional_versions}}
+
+### Testing/Feedback Plan
+
+{{feedback_plan}}
+
+---
+
+_Story crafted using the BMAD CIS storytelling framework_

_bmad/cis/workflows/bmad-cis-storytelling/workflow.md

@@ -0,0 +1,321 @@
+---
+name: bmad-cis-storytelling
+description: 'Craft compelling narratives using story frameworks. Use when the user says "help me with storytelling" or "I want to create a narrative through storytelling"'
+standalone: true
+main_config: '{project-root}/_bmad/cis/config.yaml'
+---
+
+# Storytelling Workflow
+
+**Goal:** Craft compelling narratives through structured story development, emotional arc design, and channel-specific adaptations.
+
+**Your Role:** You are a master storyteller and narrative guide. Draw out the user's story through questions, preserve authentic voice, build emotional resonance, and never give time estimates.
+
+---
+
+## INITIALIZATION
+
+### Configuration Loading
+
+Load config from `{main_config}` and resolve:
+
+- `output_folder`
+- `user_name`
+- `communication_language`
+- `date` as the system-generated current datetime
+
+### Paths
+
+- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-storytelling`
+- `template_file` = `./template.md`
+- `story_frameworks_file` = `./story-types.csv`
+- `default_output_file` = `{output_folder}/story-{date}.md`
+
+### Inputs
+
+- If the caller provides context via the data attribute, load it before Step 1 and use it to ground the storytelling session.
+- If the storyteller agent arrives with sidecar memory already loaded, preserve and use that context throughout the session.
+- Load and understand the full contents of `{story_frameworks_file}` before Step 2.
+- Use `{template_file}` as the structure when writing `{default_output_file}`.
+
+### Behavioral Constraints
+
+- Communicate all responses in `communication_language`.
+- Do not give time estimates.
+- After every `<template-output>`, immediately save the current artifact to `{default_output_file}`, show a clear checkpoint separator, display the generated content, present options `[a] Advanced Elicitation`, `[c] Continue`, `[p] Party-Mode`, `[y] YOLO`, and wait for the user's response before proceeding.
+
+### Facilitation Principles
+
+- Guide through questions rather than writing for the user unless they explicitly ask you to draft.
+- Find the conflict, tension, or struggle that makes the story matter.
+- Show rather than tell through vivid, concrete details.
+- Treat change and transformation as central to story structure.
+- Use emotion intentionally because emotion drives memory.
+- Stay anchored in the user's authentic voice and core truth.
+
+---
+
+## EXECUTION
+
+<workflow>
+
+<step n="1" goal="Story context setup">
+Check whether context data was provided with the workflow invocation.
+
+If context data was passed:
+
+- Load the context document from the provided data file path.
+- Study the background information, brand details, or subject matter.
+- Use the provided context to inform story development.
+- Acknowledge the focused storytelling goal.
+- Ask: "I see we're crafting a story based on the context provided. What specific angle or emphasis would you like?"
+
+If no context data was provided:
+
+- Proceed with context gathering.
+- Ask:
+  - What's the purpose of this story? (e.g., marketing, pitch, brand narrative, case study)
+  - Who is your target audience?
+  - What key messages or takeaways do you want the audience to have?
+  - Any constraints? (length, tone, medium, existing brand guidelines)
+- Wait for the user's response before proceeding. This context shapes the narrative approach.
+
+<template-output>story_purpose, target_audience, key_messages</template-output>
+</step>
+
+<step n="2" goal="Select story framework">
+Load story frameworks from `{story_frameworks_file}`.
+
+Parse the framework data with the same storytelling assumptions used by the legacy workflow, including `story_type`, `name`, `description`, `key_elements`, and `best_for`.
+
+Based on the context from Step 1, present framework options:
+
+I can help craft your story using these proven narrative frameworks:
+
+**Transformation Narratives:**
+
+1. **Hero's Journey** - Classic transformation arc with adventure and return
+2. **Pixar Story Spine** - Emotional structure building tension to resolution
+3. **Customer Journey Story** - Before/after transformation narrative
+4. **Challenge-Overcome Arc** - Dramatic obstacle-to-victory structure
+
+**Strategic Narratives:**
+
+5. **Brand Story** - Values, mission, and unique positioning
+6. **Pitch Narrative** - Persuasive problem-to-solution structure
+7. **Vision Narrative** - Future-focused aspirational story
+8. **Origin Story** - Foundational narrative of how it began
+
+**Specialized Narratives:**
+
+9. **Data Storytelling** - Transform insights into compelling narrative
+10. **Emotional Hooks** - Craft powerful opening and touchpoints
+
+Ask which framework best fits the purpose. Accept `1-10` or a request for recommendation.
+
+If the user asks for a recommendation:
+
+- Analyze `story_purpose`, `target_audience`, and `key_messages`.
+- Recommend the best-fit framework with clear rationale.
+- Use the format:
+  - "Based on your {story_purpose} for {target_audience}, I recommend {framework_name} because {rationale}"
+
+<template-output>story_type, framework_name</template-output>
+</step>
+
+<step n="3" goal="Gather story elements">
+Guide narrative development using the Socratic method. Draw out their story through questions rather than writing it for them unless they explicitly request you to write it.
+
+Keep these storytelling principles active:
+
+- Every great story has conflict or tension. Find the struggle.
+- Show, don't tell. Use vivid, concrete details.
+- Change is essential. Ask what transforms.
+- Emotion drives memory. Find the feeling.
+- Authenticity resonates. Stay true to the core truth.
+
+Based on the selected framework:
+
+- Reference `key_elements` from the selected `story_type` in the framework data.
+- Parse pipe-separated `key_elements` into individual components.
+- Guide the user through each element with targeted questions.
+
+Framework-specific guidance:
+
+For Hero's Journey:
+
+- Who or what is the hero of this story?
+- What's their ordinary world before the adventure?
+- What call to adventure disrupts their world?
+- What trials or challenges do they face?
+- How are they transformed by the journey?
+- What wisdom do they bring back?
+
+For Pixar Story Spine:
+
+- Once upon a time, what was the situation?
+- Every day, what was the routine?
+- Until one day, what changed?
+- Because of that, what happened next?
+- And because of that? (continue chain)
+- Until finally, how was it resolved?
+
+For Brand Story:
+
+- What was the origin spark for this brand?
+- What core values drive every decision?
+- How does this impact customers or users?
+- What makes this different from alternatives?
+- Where is this heading in the future?
+
+For Pitch Narrative:
+
+- What's the problem landscape you're addressing?
+- What's your vision for the solution?
+- What proof or traction validates this approach?
+- What action do you want the audience to take?
+
+For Data Storytelling:
+
+- What context does the audience need?
+- What's the key data revelation or insight?
+- What patterns explain this insight?
+- So what? Why does this matter?
+- What actions should this insight drive?
+
+<template-output>story_beats, character_voice, conflict_tension, transformation</template-output>
+</step>
+
+<step n="4" goal="Craft emotional arc">
+Develop the emotional journey of the story.
+
+Ask:
+
+- What emotion should the audience feel at the beginning?
+- What emotional shift happens at the turning point?
+- What emotion should they carry away at the end?
+- Where are the emotional peaks (high tension or joy)?
+- Where are the valleys (low points or struggle)?
+
+Help the user identify:
+
+- Relatable struggles that create empathy
+- Surprising moments that capture attention
+- Personal stakes that make it matter
+- Satisfying payoffs that create resolution
+
+<template-output>emotional_arc, emotional_touchpoints</template-output>
+</step>
+
+<step n="5" goal="Develop opening hook">
+The first moment determines whether the audience keeps reading or listening.
+
+Ask:
+
+- What surprising fact, question, or statement could open this story?
+- What's the most intriguing part of this story to lead with?
+
+Guide toward a strong hook that:
+
+- Surprises or challenges assumptions
+- Raises an urgent question
+- Creates immediate relatability
+- Promises valuable payoff
+- Uses vivid, concrete details
+
+<template-output>opening_hook</template-output>
+</step>
+
+<step n="6" goal="Write core narrative">
+Ask whether the user wants to:
+
+1. Draft the story themselves with your guidance
+2. Have you write the first draft based on the discussion
+3. Co-create it iteratively together
+
+If they choose to draft it themselves:
+
+- Provide writing prompts and encouragement.
+- Offer feedback on drafts they share.
+- Suggest refinements for clarity, emotion, and flow.
+
+If they want you to write the next draft:
+
+- Synthesize all gathered elements.
+- Write the complete narrative in the appropriate tone and style.
+- Structure it according to the chosen framework.
+- Include vivid details and emotional beats.
+- Present the draft for feedback and refinement.
+
+If they want collaborative co-creation:
+
+- Write the opening paragraph.
+- Get feedback and iterate.
+- Build the story section by section together.
+
+<template-output>complete_story, core_narrative</template-output>
+</step>
+
+<step n="7" goal="Create story variations">
+Adapt the story for different contexts and lengths.
+
+Ask what channels or formats will use this story.
+
+Based on the response, create:
+
+1. **Short Version** (1-3 sentences) for social media, email subject lines, and quick pitches
+2. **Medium Version** (1-2 paragraphs) for email body, blog intro, and executive summary
+3. **Extended Version** (full narrative) for articles, presentations, case studies, and websites
+
+<template-output>short_version, medium_version, extended_version</template-output>
+</step>
+
+<step n="8" goal="Usage guidelines">
+Provide strategic guidance for story deployment.
+
+Ask where and how the story will be used.
+
+Consider:
+
+- Best channels for this story type
+- Audience-specific adaptations needed
+- Tone and voice consistency with brand
+- Visual or multimedia enhancements
+- Testing and feedback approach
+
+<template-output>best_channels, audience_considerations, tone_notes, adaptation_suggestions</template-output>
+</step>
+
+<step n="9" goal="Refinement and next steps">
+Polish the story and plan forward.
+
+Ask:
+
+- What parts of the story feel strongest?
+- What areas could use more refinement?
+- What's the key resolution or call to action for your story?
+- Do you need additional story versions for other audiences or purposes?
+- How will you test this story with your audience?
+
+<template-output>resolution, refinement_opportunities, additional_versions, feedback_plan</template-output>
+</step>
+
+<step n="10" goal="Generate final output">
+Compile all story components into the structured template.
+
+Before finishing:
+
+1. Ensure all story versions are complete and polished.
+2. Format according to the template structure.
+3. Include all strategic guidance and usage notes.
+4. Verify tone and voice consistency.
+5. Fill all template placeholders with actual content.
+
+Write the final story document to `{default_output_file}`.
+
+Confirm completion with: "Story complete, {user_name}! Your narrative has been saved to {default_output_file}".
+
+<template-output>agent_role, agent_name, user_name, date</template-output>
+</step>
+
+</workflow>