Skip to content

feat(cis): convert innovation strategy to a native skill#6

Merged
bmadcode merged 1 commit intobmad-code-org:mainfrom
dickymoore:feature/native-skills-innovation-strategy-slice
Mar 14, 2026
Merged

feat(cis): convert innovation strategy to a native skill#6
bmadcode merged 1 commit intobmad-code-org:mainfrom
dickymoore:feature/native-skills-innovation-strategy-slice

Conversation

@dickymoore
Copy link
Copy Markdown
Contributor

@dickymoore dickymoore commented Mar 12, 2026

Summary

  • convert src/workflows/innovation-strategy/ to native skill shape at src/workflows/bmad-cis-innovation-strategy/
  • update agent and module-help wiring to the canonical CIS skill id
  • preserve existing workflow structure, companion files, and checkpoint behavior

Proof

  • npm test
  • node test/test-installation-components.js
  • fresh custom-content install proof against the CIS src/ tree
  • same-context old-vs-new walkthrough found no material conversion drift

Deferred / Notes

  • preserved the pre-existing ambiguity between the no-time-estimates rule and later roadmap/timeline-shaped planning language
  • did not redesign broader CIS structure outside this slice

Summary by CodeRabbit

  • Refactor

    • Reorganized Innovation Strategy workflow structure with updated initialization, configuration loading, and framework reference handling.
    • Modified workflow entry point configuration.
  • Documentation

    • Updated and consolidated Innovation Strategy workflow documentation with new directory structure and references.
    • Added new skill manifest and documentation files.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 12, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 120db3fb-6be3-4223-9583-d74af9187ee8

📥 Commits

Reviewing files that changed from the base of the PR and between 507d5aa and bb75f79.

⛔ Files ignored due to path filters (2)
  • src/module-help.csv is excluded by !**/*.csv
  • src/workflows/bmad-cis-innovation-strategy/innovation-frameworks.csv is excluded by !**/*.csv
📒 Files selected for processing (8)
  • src/agents/innovation-strategist.agent.yaml
  • src/workflows/README.md
  • src/workflows/bmad-cis-innovation-strategy/SKILL.md
  • src/workflows/bmad-cis-innovation-strategy/bmad-skill-manifest.yaml
  • src/workflows/bmad-cis-innovation-strategy/template.md
  • src/workflows/bmad-cis-innovation-strategy/workflow.md
  • src/workflows/innovation-strategy/README.md
  • src/workflows/innovation-strategy/workflow.yaml

Walkthrough

This PR refactors the innovation strategy workflow from a YAML-based configuration to a native-skill layout. The workflow is relocated from innovation-strategy to bmad-cis-innovation-strategy, with the agent entry point changed from workflow to exec pointing to SKILL.md. The old workflow files are removed and replaced with new modular skill documentation.

Changes

Cohort / File(s) Summary
Agent Configuration
src/agents/innovation-strategist.agent.yaml
Changed first menu item entry point from workflow to exec, updating the resource reference to point to SKILL.md instead of a workflow YAML file.
Native Skill Structure
src/workflows/bmad-cis-innovation-strategy/SKILL.md, src/workflows/bmad-cis-innovation-strategy/bmad-skill-manifest.yaml
Added new skill files introducing YAML front matter with skill metadata and a minimal type declaration manifest.
Workflow Documentation
src/workflows/bmad-cis-innovation-strategy/workflow.md
New modular workflow documentation replacing plaintext instructions with YAML front matter, explicit initialization steps, path definitions, and updated framework references using file paths instead of inline variables.
README Updates
src/workflows/README.md
Updated Innovation Strategy link path and added documentation for the new bmad-cis-innovation-strategy directory structure.
Deprecated Workflow Files
src/workflows/innovation-strategy/README.md, src/workflows/innovation-strategy/workflow.yaml
Removed old YAML-based workflow configuration and accompanying documentation.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Poem

🐰 From YAML chains we hop so free,
To SKILL.md and markdown spree!
Old paths fade, new structure gleams,
Native skills fulfill our dreams! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: converting the innovation strategy workflow into a native skill format, which is the primary objective of this pull request.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
AGENTS.md (1)

36-47: ⚠️ Potential issue | 🟡 Minor

Keep the workflow tree in sync with the actual source layout.

This diagram now skips src/workflows/brainstorming/, even though the repo still documents Brainstorming as a first-class workflow in src/workflows/README.md. New contributors will get the wrong directory map from this block.

📝 Suggested doc fix
 src/
 ├── agents/              # Agent definitions (*.agent.yaml)
 │   └── storyteller/     # Sidecar agents with persistent memory
 ├── workflows/           # Structured methodologies
+│   ├── brainstorming/
 │   ├── design-thinking/
 │   ├── bmad-cis-innovation-strategy/
 │   ├── problem-solving/
 │   └── storytelling/
 ├── teams/               # Multi-agent collaboration configs
 └── module.yaml          # Module metadata and installation config
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 36 - 47, The workflow directory tree in the README
snippet omits src/workflows/brainstorming/, causing docs to be out of sync with
src/workflows/README.md; update the diagram block to include the brainstorming
folder (e.g., add a line like ├── brainstorming/ under src/workflows/) and
ensure the tree matches the actual repository layout referenced by
src/workflows/README.md so new contributors see the correct structure.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/workflows/bmad-cis-innovation-strategy/workflow.md`:
- Around line 25-32: The current default_output_file interpolation uses the raw
`date` (full current datetime) which can include ":" and break Windows paths;
update the code that defines `date` (the value used to build
`default_output_file`) to produce a filesystem-safe timestamp (e.g., format as
YYYYMMDD-HHMMSS or replace/strip characters like ":" and spaces) so
`default_output_file = {output_folder}/innovation-strategy-{date}.md` never
contains illegal filename chars; ensure the change is applied where `date` is
computed so all uses of `default_output_file` and any related filename
generation (e.g., in template or save routines) get the sanitized timestamp.

---

Outside diff comments:
In `@AGENTS.md`:
- Around line 36-47: The workflow directory tree in the README snippet omits
src/workflows/brainstorming/, causing docs to be out of sync with
src/workflows/README.md; update the diagram block to include the brainstorming
folder (e.g., add a line like ├── brainstorming/ under src/workflows/) and
ensure the tree matches the actual repository layout referenced by
src/workflows/README.md so new contributors see the correct structure.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ca2c8ee6-3310-4a6b-a608-c4127cf9f0db

📥 Commits

Reviewing files that changed from the base of the PR and between 131768f and 507d5aa.

⛔ Files ignored due to path filters (2)
  • src/module-help.csv is excluded by !**/*.csv
  • src/workflows/bmad-cis-innovation-strategy/innovation-frameworks.csv is excluded by !**/*.csv
📒 Files selected for processing (9)
  • AGENTS.md
  • src/agents/innovation-strategist.agent.yaml
  • src/workflows/README.md
  • src/workflows/bmad-cis-innovation-strategy/SKILL.md
  • src/workflows/bmad-cis-innovation-strategy/bmad-skill-manifest.yaml
  • src/workflows/bmad-cis-innovation-strategy/template.md
  • src/workflows/bmad-cis-innovation-strategy/workflow.md
  • src/workflows/innovation-strategy/README.md
  • src/workflows/innovation-strategy/workflow.yaml
💤 Files with no reviewable changes (2)
  • src/workflows/innovation-strategy/README.md
  • src/workflows/innovation-strategy/workflow.yaml

Comment on lines +25 to +32
- `date` as the system-generated current datetime

### Paths

- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-innovation-strategy`
- `template_file` = `./template.md`
- `innovation_frameworks_file` = `./innovation-frameworks.csv`
- `default_output_file` = `{output_folder}/innovation-strategy-{date}.md`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Use a filesystem-safe timestamp for default_output_file.

date is defined as the full current datetime and then interpolated directly into the filename. If that value includes : characters, the default save path will be invalid on Windows.

🛠️ Suggested fix
 - `date` as the system-generated current datetime
+- `date_slug` as a filesystem-safe timestamp (for example `YYYY-MM-DD` or `YYYYMMDD-HHmmss`)
 ...
-- `default_output_file` = `{output_folder}/innovation-strategy-{date}.md`
+- `default_output_file` = `{output_folder}/innovation-strategy-{date_slug}.md`
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- `date` as the system-generated current datetime
### Paths
- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-innovation-strategy`
- `template_file` = `./template.md`
- `innovation_frameworks_file` = `./innovation-frameworks.csv`
- `default_output_file` = `{output_folder}/innovation-strategy-{date}.md`
- `date_slug` as a filesystem-safe timestamp (for example `YYYY-MM-DD` or `YYYYMMDD-HHmmss`)
### Paths
- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-innovation-strategy`
- `template_file` = `./template.md`
- `innovation_frameworks_file` = `./innovation-frameworks.csv`
- `default_output_file` = `{output_folder}/innovation-strategy-{date_slug}.md`
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/workflows/bmad-cis-innovation-strategy/workflow.md` around lines 25 - 32,
The current default_output_file interpolation uses the raw `date` (full current
datetime) which can include ":" and break Windows paths; update the code that
defines `date` (the value used to build `default_output_file`) to produce a
filesystem-safe timestamp (e.g., format as YYYYMMDD-HHMMSS or replace/strip
characters like ":" and spaces) so `default_output_file =
{output_folder}/innovation-strategy-{date}.md` never contains illegal filename
chars; ensure the change is applied where `date` is computed so all uses of
`default_output_file` and any related filename generation (e.g., in template or
save routines) get the sanitized timestamp.

Comment on lines +40 to +43
### Behavioral Constraints

- 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.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Resolve the time-estimate contradiction in the prompt contract.

The global rule says not to give time estimates, but later steps ask for a timeline and a phased execution roadmap. That makes the workflow internally inconsistent, so runs will drift depending on which instruction the model prioritizes.

🧭 Suggested clarification
- - Do not give time estimates.
+ - Do not give calendar dates or duration estimates unless the user explicitly asks.
+ - Sequencing work into relative phases is allowed.

...
- - Expected outcomes and timeline
+ - Expected outcomes and sequencing assumptions

Also applies to: 212-220, 271-277

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants