feat(ai): skills and subagents emit workflow for AI-assisted editors#71
Open
Ni55aN wants to merge 3 commits into
Open
feat(ai): skills and subagents emit workflow for AI-assisted editors#71Ni55aN wants to merge 3 commits into
Ni55aN wants to merge 3 commits into
Conversation
Ni55aN
force-pushed
the
feat/ai-skills-workflow
branch
from
287d041 to
d63e772
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
This PR rewrites rete-kit ai from a context/strategy-based instruction generator into an emit → setup → commit workflow that stages skills/subagents and tool-specific prompts for multiple AI-assisted editors, plus ships org helper scripts under .rete/scripts.
Changes:
- Replaced the old context/tool adapter system with
runAi()that either emits.rete/bundle, prints setup prompts, or prints commit prompts. - Added tool registry + prompt printing,
.gitignoremanagement, and bundle marker enforcement. - Added extensive new AI assets (skills, subagents, per-tool setup/commit docs) and org scripts under
assets/scripts/.
Reviewed changes
Copilot reviewed 94 out of 94 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| test/ai.test.ts | Adds Jest coverage for tool registry, bundle emit/re-emit, .env preservation, .gitignore update, and setup/commit prompts. |
| src/index.ts | Updates CLI ai command to new workflow and routes to runAi. |
| src/consts.ts | Adds assetsScripts path constant for org scripts. |
| src/ai/setup.ts | Adds runSetup() to require emitted bundle then print tool setup prompt. |
| src/ai/registry.ts | Implements tool-id discovery from assets/ai/tools and tool assertion. |
| src/ai/prompt.ts | Adds prompt printing for setup / commit with tool validation. |
| src/ai/paths.ts | Centralizes workspace and assets path helpers + bundle marker helpers. |
| src/ai/logger.ts | Simplifies logger API (removes info/skip). |
| src/ai/index.ts | Replaces old instruction building pipeline with emit/setup/commit dispatch. |
| src/ai/gitignore.ts | Adds .rete/ auto-append logic for existing .gitignore. |
| src/ai/emit.ts | Implements .rete/ emission, backup/recreate behavior, .env preservation, and org scripts copy. |
| src/ai/commit.ts | Adds runCommit() to require emitted bundle then print tool commit prompt. |
| src/ai/bundle.ts | Adds requireBundle() guard based on marker file. |
| src/ai/errors.ts | Adds AiError and shared error messages for new workflow. |
| README.md | Updates AI tooling description to match new emit-based workflow. |
| src/ai/tools/index.ts | Removes old tool adapter exports (Cursor/GitHub/etc.). |
| src/ai/tools/base.ts | Removes old BaseTool/strategy application pipeline. |
| src/ai/tools/cursor/index.ts | Removes old Cursor tool adapter implementation. |
| src/ai/tools/github/index.ts | Removes old GitHub tool adapter implementation. |
| src/ai/tools/claude/index.ts | Removes old Claude tool adapter implementation. |
| src/ai/tools/codex/index.ts | Removes old Codex tool adapter implementation. |
| src/ai/tools/continue/index.ts | Removes old Continue tool adapter implementation. |
| src/ai/tools/windsurf/index.ts | Removes old Windsurf tool adapter implementation. |
| src/ai/tools/amazonq/index.ts | Removes old Amazon Q tool adapter implementation. |
| src/ai/tools/antigravity/index.ts | Removes old Antigravity tool adapter implementation. |
| src/ai/strategies/index.ts | Removes old strategy exports. |
| src/ai/strategies/types.ts | Removes old strategy type definitions. |
| src/ai/strategies/single-file.ts | Removes old single-file merge strategy. |
| src/ai/strategies/multi-file.ts | Removes old multi-file transformation strategy. |
| src/ai/strategies/transformers/index.ts | Removes old transformer exports. |
| src/ai/strategies/transformers/types.ts | Removes old transformer type definitions. |
| src/ai/strategies/transformers/content/index.ts | Removes old content transformer exports. |
| src/ai/strategies/transformers/content/add-heading.ts | Removes old heading transformer. |
| src/ai/strategies/transformers/content/add-yaml-frontmatter.ts | Removes old YAML frontmatter transformer. |
| src/ai/strategies/transformers/path/index.ts | Removes old path transformer exports. |
| src/ai/strategies/transformers/path/add-path-prefix.ts | Removes old path-prefix transformer. |
| src/ai/strategies/transformers/path/add-filename-prefix.ts | Removes old filename-prefix transformer. |
| src/ai/strategies/transformers/path/replace-extension.ts | Removes old extension-rewrite transformer. |
| src/ai/repository/index.ts | Removes old interactive selection repository helper. |
| src/ai/filesystem.ts | Removes old instruction file copier with overwrite prompting. |
| src/ai/guidance.ts | Removes old markdown-to-ANSI guidance path for missing parameters. |
| src/ai/contexts/index.ts | Removes old context exports. |
| src/ai/contexts/base.ts | Removes old Context base + instruction file mapping. |
| src/ai/contexts/context-factory.ts | Removes old context factory and validations. |
| src/ai/contexts/boot/index.ts | Removes old boot context definition. |
| src/ai/contexts/dev/index.ts | Removes old dev context definition. |
| src/ai/contexts/onboard/index.ts | Removes old onboard context definition. |
| src/ai/contexts/plugin/index.ts | Removes old plugin context definition. |
| assets/scripts/tsconfig.json | Adds TS config for .rete/scripts TypeScript utilities. |
| assets/scripts/package.json | Adds dependencies and scripts for org tooling (clone-org, source-context). |
| assets/scripts/.env.example | Adds example env file for GITHUB_TOKEN. |
| assets/scripts/list-open-issues-prs.sh | Adds jq-based helper for listing open issues/PR exports. |
| assets/scripts/concat-source-context.ts | Adds token-aware source concatenation/pagination script. |
| assets/scripts/clone-github-org-repos.ts | Adds org clone/update + issues/PR export script into gh-mirror. |
| assets/ai/intro.md | Adds post-emit intro messaging and next-step guidance. |
| assets/ai/tools/cursor/setup.md | Adds Cursor setup instructions for staged bundle install. |
| assets/ai/tools/cursor/commit.md | Adds Cursor commit/cleanup instructions. |
| assets/ai/tools/github/setup.md | Adds GitHub Copilot setup instructions (skills/agents/instructions + fallback). |
| assets/ai/tools/github/commit.md | Adds GitHub Copilot commit/cleanup instructions (partial removal rules). |
| assets/ai/tools/claude/setup.md | Adds Claude Code setup instructions (AGENTS/CLAUDE + skills + agents). |
| assets/ai/tools/claude/commit.md | Adds Claude Code commit/cleanup instructions. |
| assets/ai/tools/codex/setup.md | Adds Codex setup instructions (skills + TOML subagents conversion). |
| assets/ai/tools/codex/commit.md | Adds Codex commit/cleanup instructions. |
| assets/ai/tools/kiro/setup.md | Adds Kiro setup instructions (skills + subagents). |
| assets/ai/tools/kiro/commit.md | Adds Kiro commit/cleanup instructions. |
| assets/ai/tools/opencode/setup.md | Adds OpenCode setup instructions (skills + agents + AGENTS merge). |
| assets/ai/tools/opencode/commit.md | Adds OpenCode commit/cleanup instructions. |
| assets/ai/tools/pi/setup.md | Adds Pi setup instructions (skills install + optional subagent extension flow). |
| assets/ai/tools/pi/commit.md | Adds Pi commit/cleanup instructions (conditional agent retention). |
| assets/ai/tools/devin-desktop/setup.md | Adds Devin Desktop setup instructions (skills + profile-based agents). |
| assets/ai/tools/devin-desktop/commit.md | Adds Devin Desktop commit/cleanup instructions. |
| assets/ai/tools/antigravity/setup.md | Adds Antigravity setup instructions (skills install + on-demand agents). |
| assets/ai/tools/antigravity/commit.md | Adds Antigravity commit instructions (remove skills only; keep agents). |
| assets/ai/base/AGENTS.md | Adds reference project instructions template staged into .rete/ai/AGENTS.md. |
| assets/ai/base/agents/rete-code-investigator.md | Adds subagent profile for evidence-based code investigation. |
| assets/ai/base/agents/rete-package-reviewer.md | Adds subagent profile for SOLID/GRASP-based PR/package review. |
| assets/ai/base/skills/rete-boot/SKILL.md | Adds skill for scaffolding new Rete.js apps via npx rete-kit app. |
| assets/ai/base/skills/rete-clone/SKILL.md | Adds skill for creating editable clones (separate from mirror). |
| assets/ai/base/skills/rete-dev/SKILL.md | Adds skill for integrating/extending Rete.js in existing apps. |
| assets/ai/base/skills/rete-git/SKILL.md | Adds skill for contribution workflow, branching, and conventional commits. |
| assets/ai/base/skills/rete-onboard/SKILL.md | Adds skill for teaching Rete.js fundamentals. |
| assets/ai/base/skills/rete-plugin/SKILL.md | Adds skill for plugin development and debugging guidance. |
| assets/ai/base/skills/rete-plugin/architecture.md | Updates plugin architecture guidance formatting/content. |
| assets/ai/base/skills/rete-plugin/protocol.md | Adds plugin response coverage checklist/protocol. |
| assets/ai/base/skills/rete-plugin/workflow.md | Adds plugin SDLC workflow and validation commands. |
| assets/ai/base/skills/rete-qa/SKILL.md | Adds skill for validation and regression testing via rete/rete-qa. |
| assets/ai/base/skills/rete-setup/SKILL.md | Adds skill to bootstrap/sync gh-mirror and use org scripts. |
| assets/ai/boot/instructions.md | Removes old boot context instructions. |
| assets/ai/dev/instructions.md | Removes old dev context instructions. |
| assets/ai/onboard/instructions.md | Removes old onboard context instructions. |
| assets/ai/plugin/workflow.md | Removes old plugin workflow instructions. |
| assets/ai/plugin/protocol.md | Removes old plugin protocol instructions. |
| assets/ai/guidance.md | Removes old guidance messaging for the prior CLI flow. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Replace context/strategy-based `rete-kit ai` with emit, setup, and commit steps. Stage skills, subagents, and org scripts under `.rete/`. Add multi-tool prompts. Breaking change*: `rete-kit ai` no longer accepts `--context`, `--force`, or `--interactive`. Use emit without flags, then `--tool` for setup and `--tool --commit` for commit.
Ni55aN
force-pushed
the
feat/ai-skills-workflow
branch
from
d63e772 to
e3df50d
Compare
Ni55aN
changed the title
Defer --tool validation until runtime instead of eager CLI choices, fix empty .gitignore formatting, and make ai tests self-contained. Co-authored-by: Cursor <cursoragent@cursor.com>
Ni55aN
force-pushed
the
feat/ai-skills-workflow
branch
from
09a3844 to
f93c797
Compare
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Replaces the context-based
rete-kit aicommand with a three-step emit → setup → commit workflow.rete-kit ai) — stages skills, subagents,AGENTS.md, and org scripts into.rete/rete-kit ai --tool <id>) — prints IDE-specific install instructionsrete-kit ai --tool <id> --commit) — prints instructions for committing installed project filesAdds skills (
rete-boot,rete-clone,rete-dev,rete-onboard,rete-plugin,rete-qa,rete-setup,rete-git), subagents (rete-code-investigator,rete-package-reviewer), multi-tool prompts (Cursor, Claude, Codex, and others), and org scripts underassets/scripts/. Rewritessrc/ai/— removes contexts, strategies, and TypeScript tool adapters.Breaking change:
--context,--force, and--interactiveare removed fromrete-kit ai.Related Issues
Checklist
Additional Notes