Skip to content

Feat/support kiro#527

Closed
rfxlamia wants to merge 6 commits intoobra:mainfrom
rfxlamia:feat/support-kiro
Closed

Feat/support kiro#527
rfxlamia wants to merge 6 commits intoobra:mainfrom
rfxlamia:feat/support-kiro

Conversation

@rfxlamia
Copy link
Copy Markdown

Summary

Add Kiro steering files for all Superpowers skills to enable AI-assisted development workflow in Kiro IDE.

Changes

  • Create .kiro/steering/ directory with 14 skill steerings
  • Add pattern steering files referencing skills/<name>/SKILL.md
  • Include documentation (README.md index and root config)

Files Added

  • 14 sp-*.md steering files (brainstorming, executing-plans, etc.)
  • .kiro/steering/README.md (command reference)
  • .kiro/README.md (root configuration)

All steering files use inclusion: manual frontmatter and follow the kiro steering pattern.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Feb 22, 2026

📝 Walkthrough

Walkthrough

This PR adds a new .kiro configuration directory with a top-level README and a .kiro/steering subdirectory containing 14 steering guidance Markdown files that reference external skills/ SKILL.md definitions and instruct users to load and follow those skill files.

Changes

Cohort / File(s) Summary
Core Documentation
/.kiro/README.md, /.kiro/steering/README.md
Adds overall Kiro configuration README and steering module README describing Quick Start, directory layout, skills taxonomy, and steering command usage.
Steering Guidance Files
/.kiro/steering/sp-*.md (14 files: sp-brainstorming.md, sp-dispatching-parallel-agents.md, sp-executing-plans.md, sp-finishing-a-development-branch.md, sp-receiving-code-review.md, sp-requesting-code-review.md, sp-subagent-driven-development.md, sp-systematic-debugging.md, sp-test-driven-development.md, sp-using-git-worktrees.md, sp-using-superpowers.md, sp-verification-before-completion.md, sp-writing-plans.md, sp-writing-skills.md)
Adds 14 steering docs with YAML front matter (inclusion: manual) and CRITICAL steps blocks that uniformly instruct loading, reading, and strictly following corresponding skills/.../SKILL.md files. No code or public API changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

Poem

🐇 In a warren of docs I hop and sing,
New README burrows and steering bells ring,
Fourteen little guides point to skills so true,
Follow their paths and they'll lead back to you. ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Feat/support kiro' is partially related to the changeset but lacks specificity. It indicates a feature related to Kiro support but doesn't convey that this adds steering files for Superpowers skills. Consider a more descriptive title like 'Add Kiro steering files for Superpowers skills' to better clarify the main change.
✅ Passed checks (2 passed)
Check name Status Explanation
Description check ✅ Passed The description clearly explains the addition of Kiro steering configuration files, the directory structure, and references to skill documentation, which aligns well with the changeset.
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

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

🧹 Nitpick comments (1)
.kiro/steering/sp-finishing-a-development-branch.md (1)

1-3: Consider adding a description field to the frontmatter for slash-command discoverability.

Manual steering files are invoked with #<filename> in chat and also appear as slash commands — type / in chat to see and select them. Without a description field, the entry in the / menu has no summary text, making it harder for teammates unfamiliar with the skill set to pick the right command.

✨ Suggested frontmatter addition (example for this file)
 ---
 inclusion: manual
+description: Workflow for cleanly finishing a development branch before merge.
 ---

Apply the equivalent description to each of the 14 sp-*.md steering files.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.kiro/steering/sp-finishing-a-development-branch.md around lines 1 - 3, Add
a description field to the frontmatter of this manual steering file so the
slash-command menu shows a summary; specifically, update the YAML frontmatter in
.kiro/steering/sp-finishing-a-development-branch.md (and apply the same change
to all sp-*.md steering files) by adding a top-level description: "Concise
one-line summary of what this steering command does" (replace with an
appropriate summary for each file) so the `/` menu displays discoverable text.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.kiro/README.md:
- Around line 7-10: Update the Quick Start commands to include the missing "sp-"
prefix so they match the actual steering filenames; replace
`/using-superpowers`, `/brainstorming`, `/writing-plans`, and `/executing-plans`
with `/sp-using-superpowers`, `/sp-brainstorming`, `/sp-writing-plans`, and
`/sp-executing-plans` in the README so Kiro's slash commands map to the `sp-...`
steering files.
- Around line 24-29: The README currently claims "All skills are prefixed with
`sp-`" but the subsequent skill list shows names without that prefix; update the
skill list or its surrounding copy so it matches the stated convention: either
change each listed item to include the `sp-` prefix (e.g., `sp-brainstorming`,
`sp-writing-plans`, `sp-executing-plans`, `sp-subagent-driven-development`,
`sp-test-driven-development`, `sp-systematic-debugging`,
`sp-requesting-code-review`, `sp-receiving-code-review`,
`sp-verification-before-completion`, `sp-using-git-worktrees`,
`sp-finishing-a-development-branch`, `sp-dispatching-parallel-agents`,
`sp-writing-skills`) or add a parenthetical/clarifying sentence after "All
skills are prefixed with `sp-`" indicating that the list below omits the `sp-`
prefix for brevity (and that actual command/file names include it); adjust the
line that currently reads "All skills are prefixed with `sp-` to avoid
conflicts:" and the listed items accordingly.

---

Nitpick comments:
In @.kiro/steering/sp-finishing-a-development-branch.md:
- Around line 1-3: Add a description field to the frontmatter of this manual
steering file so the slash-command menu shows a summary; specifically, update
the YAML frontmatter in .kiro/steering/sp-finishing-a-development-branch.md (and
apply the same change to all sp-*.md steering files) by adding a top-level
description: "Concise one-line summary of what this steering command does"
(replace with an appropriate summary for each file) so the `/` menu displays
discoverable text.

Comment thread .kiro/README.md
Comment thread .kiro/README.md Outdated
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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.kiro/README.md:
- Around line 14-20: The fenced code block in .kiro/README.md is missing a
language specifier and triggers markdownlint MD040; update the opening fence for
the directory-tree block in README.md (the triple backticks before the tree) to
include a language tag such as plaintext (e.g., change ``` to ```plaintext) so
the block becomes a fenced code block with a language specifier.

---

Duplicate comments:
In @.kiro/README.md:
- Around line 7-10: Update the quick-start list entries to include the missing
"sp-" prefix so the displayed slash commands match the steering file names;
specifically change "/using-superpowers", "/brainstorming", "/writing-plans",
and "/executing-plans" to "/sp-using-superpowers", "/sp-brainstorming",
"/sp-writing-plans", and "/sp-executing-plans" in the README so Kiro-derived
commands align with the sp-*.md steering files.

Comment thread .kiro/README.md
Comment on lines +14 to +20
```
.kiro/
├── README.md # This file
└── steering/ # Kiro steering commands
├── README.md # Command reference
└── sp-*.md # Individual skill steerings
```
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 | 🟡 Minor

Add a language specifier to the fenced code block (MD040).

The directory-tree block is missing a language tag, which triggers a markdownlint warning.

📝 Proposed fix
-```
+```plaintext
 .kiro/
 ├── README.md           # This file
 └── steering/           # Kiro steering commands
     ├── README.md       # Command reference
     └── sp-*.md         # Individual skill steerings
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **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.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 14-14: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.kiro/README.md around lines 14 - 20, The fenced code block in
.kiro/README.md is missing a language specifier and triggers markdownlint MD040;
update the opening fence for the directory-tree block in README.md (the triple
backticks before the tree) to include a language tag such as plaintext (e.g.,
change ``` to ```plaintext) so the block becomes a fenced code block with a
language specifier.

@obra obra added enhancement New feature or request new-harness Requests for harnesses with few existing items kiro Kiro CLI integration labels Mar 4, 2026
@obra
Copy link
Copy Markdown
Owner

obra commented Apr 28, 2026

Hi. Thanks so much for contributing this. #618 is closer to how we'd probably go about a Kiro integration. All those steering files are kind of a no-go

@obra obra closed this Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request kiro Kiro CLI integration new-harness Requests for harnesses with few existing items

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants