Skip to content

fix(skills): refresh all skills + orchestration rules rewrite - #565

Merged
namastex888 merged 3 commits into
devfrom
fix/skill-refresh
Mar 14, 2026
Merged

namastex888 merged 3 commits into
devfrom
fix/skill-refresh

Conversation

@namastex888

Copy link
Copy Markdown
Contributor

Summary

Complete refresh of all 13 genie skills and orchestration rules rewrite. Aligns everything with current CLI commands, the three-layer architecture (dispatch → skills → orchestration rules), and the full delivery lifecycle.

Changes

Orchestration Rules Rewrite (Group 1)

  • Rewrote ORCHESTRATION_PROMPT in smart-install.js and install.sh
  • Current CLI commands (spawn, kill, stop, ls, team, send, broadcast, chat, done, status, reset)
  • Full lifecycle documented (planning → execution → PR → QA loop)
  • Skill auto-invocation chain
  • Team management lifecycle

Kill Onboarding + Inline References (Group 2)

  • Deleted skills/onboarding/ — smart-install.js handles setup
  • Inlined prompt-optimizer.md into /refine SKILL.md
  • Inlined design-template.md into /brainstorm SKILL.md
  • Inlined wish-template.md into /wish SKILL.md

Core Chain (Group 3)

  • /brainstorm: auto-/review at WRS=100, /council suggestion when stuck
  • /wish: auto-detect fuzzy → /brainstorm, auto-/review after writing
  • /work: local /review per group, genie send signaling, genie done tracking
  • /review: SHIP next-step per context, auto-/fix on FIX-FIRST

Support Skills (Group 4)

  • /council: auto-invocation triggers, genie team hire council docs, timeout
  • /trace: genie send for reporting, auto-invocation by /review
  • /report: agent-browser as dependency, wish criteria linking
  • /docs: CLAUDE.md as first-class surface, doc types, post-work suggestion
  • /refine: inlined content, no external refs

Learn + Brain (Group 5)

  • /learn: rewritten — diagnoses any behavioral surface, Claude native memory
  • /brain: brain vs memory distinction, notesmd-cli auto-install offer

Dream (Group 6)

  • Full lifecycle: genie work dispatch → PR → merge to dev → QA loop
  • Removed stale refs (Status: SHIPPED, sleep 5)
  • genie done/status/reset integration

Test plan

  • Zero stale refs: no genie agent spawn, genie worker, genie brainstorm crystallize, BOOTSTRAP, references/
  • skills/onboarding/ deleted
  • bun run typecheck passes
  • bun test — 708 pass, 0 fail

Test User added 2 commits March 14, 2026 19:17
…arn+brain

Group 1 — Orchestration Rules Rewrite:
- Rewrite ORCHESTRATION_PROMPT in smart-install.js and install.sh with current
  CLI commands (spawn, kill, stop, ls, team create/hire/fire/disband, send,
  broadcast, chat, done, status, reset)
- Add skill auto-invocation chain, team lifecycle, and rules sections
- Remove stale genie agent spawn, genie team ensure, genie agent dashboard refs
- Both files have identical orchestration content

Group 2 — Kill Onboarding + Inline References:
- Delete skills/onboarding/ directory entirely
- Inline prompt optimizer content into skills/refine/SKILL.md
- Inline design template into skills/brainstorm/SKILL.md
- Inline wish template into skills/wish/SKILL.md
- Remove all references/ file paths from SKILL.md files

Group 5 — Learn Rewrite + Brain Update:
- Rewrite skills/learn/SKILL.md: primary trigger is user correction, diagnoses
  which behavioral surface needs change (CLAUDE.md, AGENTS.md, SOUL.md, rules/,
  memory/, hooks, configs). Remove BOOTSTRAP.md ref. Connect to Claude native memory.
- Update skills/brain/SKILL.md: add brain vs memory distinction (brain=context
  graph, memory=behavioral learnings). Add auto-install: detect notesmd-cli,
  offer install from https://github.com/Yakitrak/notesmd-cli
Group 3 — Core Chain Skills:
- brainstorm: remove genie brainstorm crystallize, auto-invoke /review at
  WRS=100, suggest /council when Decisions stuck after 2+ exchanges
- wish: fuzzy gate check auto-triggers /brainstorm, step 7 declares depends-on,
  handoff auto-invokes /review instead of suggesting /work
- work: clarify as implementor skill via genie work dispatch, add local /review
  per group, genie send signaling, leader uses genie done (not worker),
  remove "no state management" confusion
- review: add SHIP next-steps per context (plan→wish/work, execution→PR,
  PR→merge), auto-invoke /fix on FIX-FIRST, /trace for unclear root cause

Group 4 — Support Skills:
- council: add auto-invocation triggers (review arch decisions, brainstorm
  stuck decisions), document genie team hire council, add 2min timeout for
  full spawn, clarify lightweight=simulate vs full spawn=real agents
- trace: add genie send for reporting findings, clarify spawned agent IS
  the tracer, /review can invoke /trace
- report: document agent-browser as genie dependency, add wish criteria
  linking during QA, add QA failure auto-invocation chain
- docs: add doc types (README, CLAUDE.md, API, architecture, JSDoc),
  CLAUDE.md as first-class surface, post-work suggestion
- refine: verified inlined content, no remaining references/ paths

Group 6 — Dream Lifecycle:
- Phase 1: use genie work dispatch per group (state tracking for free),
  genie status/done/reset for monitoring
- Phase 2: leader creates PR, reads bot comments critically, /fix valid
  issues, CI green required (poll, don't sleep)
- Phase 3: merge to dev, spawn tester, QA loop until all criteria proven,
  each fix = new PR to dev
- Phase 4: DREAM-REPORT.md with per-wish QA status
- Remove Status: SHIPPED and sleep 5 references
- Add full team lifecycle: create→execute→review→merge→QA→disband
@coderabbitai

coderabbitai Bot commented Mar 14, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 82817975-644b-4544-b422-045a461308ea

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix/skill-refresh
📝 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.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request delivers a significant overhaul of the genie agent orchestration and skill system. The changes aim to streamline the agent's workflow, enhance automation through refined skill interconnections, and improve the overall development lifecycle from planning to execution and quality assurance. The update focuses on clearer command structures, better state management, and more integrated processes across various agent capabilities, ensuring a more cohesive and efficient autonomous development environment.

Highlights

  • Orchestration Rules Rewrite: The ORCHESTRATION_PROMPT in install.sh and plugins/genie/scripts/smart-install.js has been completely rewritten to align with current genie CLI commands, a three-layer architecture (dispatch → skills → orchestration rules), and the full delivery lifecycle. This includes updated agent lifecycle, messaging, team, dispatch, and state management commands, as well as a detailed skill flow auto-invocation chain and team lifecycle.
  • Skill Refinements and Auto-Invocation Chains: Several core skills have been updated to improve automation and integration. /brainstorm now auto-invokes /review and suggests /council when decisions are stuck. /wish auto-detects fuzzy requests and triggers /brainstorm, then auto-invokes /review after planning. /review includes context-dependent SHIP next-steps and auto-invokes /fix on FIX-FIRST, with /trace suggested for unclear root causes. /work now incorporates local /review per group, genie send for signaling, and genie done for tracking.
  • Onboarding Skill Removal and Content Inlining: The skills/onboarding/ directory and its associated SKILL.md file have been removed, indicating that setup is now handled by smart-install.js. Previously external reference documents like prompt-optimizer.md, design-template.md, and wish-template.md have been inlined directly into the respective refine, brainstorm, and wish skill documentation for better self-containment.
  • Enhanced Learning and Knowledge Management: The /learn skill has been rewritten to focus on behavioral correction and now directly connects to Claude's native memory system for persistent learnings. The /brain skill documentation clarifies the distinction between 'brain' (context graph) and 'memory' (behavioral learnings) and includes auto-install offers for notesmd-cli.
  • Comprehensive Dream Lifecycle: The /dream skill now outlines a full lifecycle encompassing genie work dispatch, PR creation, merging to dev, and a thorough QA loop. It removes stale references and integrates genie done, genie status, and genie reset for robust state management throughout the batch execution process.
  • Support Skill Updates: /council now has auto-invocation triggers and clearer setup for full spawn mode. /trace integrates with genie send for reporting and is auto-invoked by /review. /report lists agent-browser as a dependency and links findings to wish criteria during QA. /docs elevates CLAUDE.md as a first-class documentation surface and suggests post-work documentation.
Changelog
  • install.sh
    • Updated the ORCHESTRATION_PROMPT to reflect new genie CLI commands and a comprehensive skill flow, team lifecycle, and operational rules.
  • plugins/genie/scripts/smart-install.js
    • Updated the ORCHESTRATION_PROMPT to reflect new genie CLI commands and a comprehensive skill flow, team lifecycle, and operational rules.
    • Updated the tmux warning message to use the simplified genie spawn command.
  • skills/brain/SKILL.md
    • Added a new section clarifying the distinction between 'Brain' and 'Memory'.
    • Updated installation instructions for notesmd-cli to include auto-detection and graceful handling of missing installations.
  • skills/brainstorm/SKILL.md
    • Updated the crystallization flow to automatically invoke /review after writing DESIGN.md.
    • Revised output options to reflect the new auto-invocation of /review.
    • Added a 'Stuck Decisions' section suggesting /council for deadlocked discussions.
    • Inlined the 'Design Template' directly into the skill documentation.
  • skills/council/SKILL.md
    • Added 'Auto-Invocation Triggers' section detailing how /review and /brainstorm can invoke /council.
    • Clarified the description of 'Lightweight Mode'.
    • Added setup instructions for 'Full Spawn Mode', including the genie team hire council command.
    • Introduced a timeout mechanism for council member responses in 'Full Spawn Mode'.
  • skills/docs/SKILL.md
    • Added a new 'When to Use' trigger for suggesting /docs after /work completes.
    • Introduced 'Documentation Surfaces' section, emphasizing CLAUDE.md as a first-class documentation surface.
    • Updated the flow to audit all documentation surfaces and prioritize CLAUDE.md accuracy.
  • skills/dream/SKILL.md
    • Updated the skill description to include merging to dev and running a QA loop.
    • Revised the execution flow to define four distinct phases: Execute, Review + PR, Merge + QA, and Report.
    • Updated dispatch mechanisms to use genie work and genie team hire for workers.
    • Detailed the worker contract, including local /review and CI checks without sleep.
    • Expanded the review, merge, and QA loop processes.
    • Updated the DREAM-REPORT.md format to include more detailed status and QA findings.
    • Revised rules to enforce state management via genie done, genie status, genie reset and CI polling.
  • skills/learn/SKILL.md
    • Rewrote the skill's description and purpose to focus on diagnosing and fixing agent behavioral surfaces connected to Claude native memory.
    • Updated the 'Flow' section to detail analyzing mistakes, determining root causes, diagnosing surfaces, proposing minimal fixes, and saving to memory.
    • Revised the 'Writable Surfaces' table to align with behavioral correction.
    • Added a 'Claude Native Memory Connection' section explaining how learnings are saved as feedback memories.
    • Updated rules to emphasize one learning at a time, minimal changes, and always saving to memory.
  • skills/onboarding/SKILL.md
    • Removed the entire onboarding skill file, indicating its functionality has been superseded or integrated elsewhere.
  • skills/refine/SKILL.md
    • Updated the flow to refer to an inlined 'Prompt Optimizer System Prompt' instead of an external file.
    • Inlined the 'Prompt Optimizer System Prompt' content directly into the skill documentation.
  • skills/report/SKILL.md
    • Added a 'When to Use' trigger for QA loop failures.
    • Included agent-browser as a dependency for browser-based evidence capture.
    • Added a 'QA Loop Integration' section, detailing how findings are linked to wish acceptance criteria and outlining the auto-invocation chain for QA failures.
  • skills/review/SKILL.md
    • Modified the 'Verdict' table to include 'SHIP Next-Steps' based on review context.
    • Added a 'SHIP Next-Steps' section detailing actions for different review contexts (plan, execution, PR).
    • Added an 'Auto-Invocation on FIX-FIRST' section, outlining the process for automatically triggering /fix.
    • Added an 'Unclear Root Cause' section, suggesting invocation of /trace before /fix.
  • skills/trace/SKILL.md
    • Added a 'When to Use' trigger for invocation by /review when root causes are unclear.
    • Clarified the 'Flow' to indicate the spawned agent is the tracer and reports findings via genie send.
  • skills/wish/SKILL.md
    • Updated the 'Gate check' in the flow to auto-trigger /brainstorm for fuzzy requests.
    • Revised the 'Handoff' step to auto-invoke /review (plan review) instead of directly suggesting /work.
    • Inlined the 'Wish Template' directly into the skill documentation.
  • skills/work/SKILL.md
    • Updated the skill description to clarify its role as the implementor's skill invoked via genie work.
    • Changed 'Spec review' to 'Local review' in the flow.
    • Updated the signal completion message to include 'all criteria met'.
    • Added a 'State Management' section detailing how workers signal and leaders track state using genie send, genie status, genie done, and genie reset.
    • Revised rules to emphasize running local /review per group before signaling completion.
Activity
  • The pull request was created by namastex888 with a title indicating a refresh of skills and orchestration rules rewrite.
  • The description provides a detailed summary of changes across six groups, covering orchestration, skill updates, and lifecycle management.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a comprehensive refresh of all Genie skills and a rewrite of the orchestration rules. The changes align the skills with a new three-layer architecture and the full delivery lifecycle, including a new QA loop. The documentation for all skills has been significantly updated to reflect these new, more automated workflows. The CLI command structure has also been updated.

My review focuses on the clarity and consistency of the new documentation and command structures. I've identified a minor markdown formatting issue in one of the skill documents and a potential inconsistency in the CLI command design that could be improved for better user experience. Overall, this is a substantial and well-executed refactoring that greatly improves the clarity and automation of the Genie skills framework.

Comment thread install.sh Outdated
Comment on lines +684 to +686
genie agent history <name> # Session history
genie agent read <name> --follow # Tail terminal output
genie agent answer <name> <choice> # Answer prompt (1-9 or text:...)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

For consistency with other agent lifecycle commands like genie spawn and genie kill which are at the top level, consider moving history, read, and answer to the top level as well by removing the agent subcommand. This would make the CLI more uniform.

Suggested change
genie agent history <name> # Session history
genie agent read <name> --follow # Tail terminal output
genie agent answer <name> <choice> # Answer prompt (1-9 or text:...)
genie history <name> # Session history
genie read <name> --follow # Tail terminal output
genie answer <name> <choice> # Answer prompt (1-9 or text:...)

Comment thread plugins/genie/scripts/smart-install.js Outdated
Comment on lines +265 to +267
genie agent history <name> # Session history
genie agent read <name> --follow # Tail terminal output
genie agent answer <name> <choice> # Answer prompt (1-9 or text:...)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

For consistency with other agent lifecycle commands like genie spawn and genie kill which are at the top level, consider moving history, read, and answer to the top level as well by removing the agent subcommand. This would make the CLI more uniform.

Suggested change
genie agent history <name> # Session history
genie agent read <name> --follow # Tail terminal output
genie agent answer <name> <choice> # Answer prompt (1-9 or text:...)
genie history <name> # Session history
genie read <name> --follow # Tail terminal output
genie answer <name> <choice> # Answer prompt (1-9 or text:...)

Comment thread skills/wish/SKILL.md Outdated
Comment on lines +91 to +93
\```bash
# Command that exits 0 on success
\```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

There seems to be a typo in the markdown for the code block. The backticks are escaped, which will prevent the code block from rendering correctly.

Suggested change
\```bash
# Command that exits 0 on success
\```
# Command that exits 0 on success

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5b04faff7f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread install.sh Outdated
genie team ensure <name> # Ensure team exists (creates if needed)
genie team list # List teams
genie team delete <name> # Delete team
genie team create <name> # Create a team

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Add required --repo option to team-create guidance

The rewritten orchestration prompt instructs genie team create <name>, but this command now requires a repository argument and fails without it. I verified CLI semantics with bun src/genie.ts team create --help (shows --repo <path>) and bun src/genie.ts team create demo (returns required option '--repo <path>' not specified), so agents following this prompt will fail at team setup and cannot proceed with the documented lifecycle.

Useful? React with 👍 / 👎.

- Change genie agent history/read/answer to genie history/read/answer
  (top-level commands, not under agent namespace) in both install.sh
  and smart-install.js
- Fix escaped backticks in wish SKILL.md template (remove backslashes)
- Add --repo <path> to genie team create in both orchestration prompts
  (--repo is required)
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.

1 participant