chore: add generated slash command bridge files for Kit repo#20
chore: add generated slash command bridge files for Kit repo#20emredursun merged 2 commits intomainfrom
Conversation
Bridge files generated by kit init --force for Kit's own development. Tracked via .gitignore negation patterns (PR #19) so they appear in worktrees. These files are not included in the npm package — end users get them generated at runtime by lib/command-bridge.js. 3 IDEs x 25 workflows = 75 bridge files: - .claude/commands/*.md (Claude Code / Antigravity) - .cursor/commands/*.md (Cursor) - .opencode/commands/*.md (OpenCode)
There was a problem hiding this comment.
Code Review
This pull request introduces a series of bridge command files across .claude, .cursor, and .opencode directories to facilitate the execution of Devran AI Kit workflows. The review feedback highlights an opportunity to improve IDE compatibility by ensuring YAML frontmatter is placed at the very beginning of the files and suggests using backticks for file paths to enhance AI recognition.
.claude/commands/brainstorm.md
Outdated
| <!-- devran-kit-bridge v5.2.0 --> | ||
| --- | ||
| description: "Structured brainstorming. Explore options before committing to implementation." | ||
| --- | ||
|
|
||
| Execute the /brainstorm workflow from the Devran AI Kit. | ||
|
|
||
| Read and follow the full instructions in .agent/workflows/brainstorm.md. |
There was a problem hiding this comment.
To ensure that IDEs like Claude Code correctly parse the YAML frontmatter, the --- block should be the very first content in the file. Moving the provenance header below the frontmatter improves IDE compatibility. Additionally, consider wrapping the workflow path in backticks (e.g., .agent/workflows/brainstorm.md) to help the AI agent identify it as a file path. This improvement should be applied to all generated bridge files in this directory.
| <!-- devran-kit-bridge v5.2.0 --> | |
| --- | |
| description: "Structured brainstorming. Explore options before committing to implementation." | |
| --- | |
| Execute the /brainstorm workflow from the Devran AI Kit. | |
| Read and follow the full instructions in .agent/workflows/brainstorm.md. | |
| --- | |
| description: "Structured brainstorming. Explore options before committing to implementation." | |
| --- | |
| <!-- devran-kit-bridge v5.2.0 --> | |
| Execute the /brainstorm workflow from the Devran AI Kit. | |
| Read and follow the full instructions in .agent/workflows/brainstorm.md. |
.opencode/commands/brainstorm.md
Outdated
| <!-- devran-kit-bridge v5.2.0 --> | ||
| --- | ||
| description: "Structured brainstorming. Explore options before committing to implementation." | ||
| --- | ||
|
|
||
| Execute the /brainstorm workflow from the Devran AI Kit. | ||
|
|
||
| Read and follow the full instructions in .agent/workflows/brainstorm.md. |
There was a problem hiding this comment.
The YAML frontmatter should be placed at the top of the file for proper parsing by the IDE. The provenance header should be moved below the frontmatter block. Also, wrapping the workflow file path in backticks is recommended for better AI recognition. This improvement should be applied to all generated bridge files in this directory.
| <!-- devran-kit-bridge v5.2.0 --> | |
| --- | |
| description: "Structured brainstorming. Explore options before committing to implementation." | |
| --- | |
| Execute the /brainstorm workflow from the Devran AI Kit. | |
| Read and follow the full instructions in .agent/workflows/brainstorm.md. | |
| --- | |
| description: "Structured brainstorming. Explore options before committing to implementation." | |
| --- | |
| <!-- devran-kit-bridge v5.2.0 --> | |
| Execute the /brainstorm workflow from the Devran AI Kit. | |
| Read and follow the full instructions in .agent/workflows/brainstorm.md. |
…ility - Claude and OpenCode bridges now start with --- frontmatter block - Provenance header moved after frontmatter closing --- - Workflow paths wrapped in backticks for AI agent recognition - Consistent with VS Code adapter pattern (already frontmatter-first) - Addresses gemini-code-assist review on PR #20
Summary
kit init --forceand are now tracked via the gitignore negation patterns from PR chore: track .claude/commands/ in Kit repo for worktree support #19Files
.claude/commands/.cursor/commands/.opencode/commands/Note
These files are not included in the npm package (
package.jsonfilesfield only includesbin/,lib/,.agent/). End users get bridges generated at runtime bylib/command-bridge.jswhen they runkit init. This PR only affects Kit repo contributors working in worktrees.Test Plan
<!-- devran-kit-bridge v5.2.0 -->)