From eaf3cd9d4d6f5607b4439154e364ce0a5a9f8ca0 Mon Sep 17 00:00:00 2001 From: Kieran Klaassen Date: Wed, 26 Nov 2025 21:47:33 -0800 Subject: [PATCH 1/2] Improve /plan command with clear post-generation options MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace vague "keep asking questions until user is happy" ending with AskUserQuestion tool presenting structured options. Users now see 4 explicit choices after plan generation: Start /work, Run /plan_review, Simplify, or Rework. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../.claude-plugin/plugin.json | 2 +- plugins/compounding-engineering/CHANGELOG.md | 6 ++++ .../commands/workflows/plan.md | 32 +++++++++++++------ 3 files changed, 30 insertions(+), 10 deletions(-) diff --git a/plugins/compounding-engineering/.claude-plugin/plugin.json b/plugins/compounding-engineering/.claude-plugin/plugin.json index ebcf315..d537649 100644 --- a/plugins/compounding-engineering/.claude-plugin/plugin.json +++ b/plugins/compounding-engineering/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "compounding-engineering", - "version": "2.6.0", + "version": "2.6.1", "description": "AI-powered development tools. 23 agents, 16 commands, 11 skills, 2 MCP servers for code review, research, design, and workflow automation.", "author": { "name": "Kieran Klaassen", diff --git a/plugins/compounding-engineering/CHANGELOG.md b/plugins/compounding-engineering/CHANGELOG.md index bb9afec..81bed91 100644 --- a/plugins/compounding-engineering/CHANGELOG.md +++ b/plugins/compounding-engineering/CHANGELOG.md @@ -5,6 +5,12 @@ All notable changes to the compounding-engineering plugin will be documented in The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [2.6.1] - 2024-11-26 + +### Improved + +- **`/plan` command** - Replaced vague "keep asking questions" ending with clear post-generation options menu. Users now see 5 explicit choices: Start `/work`, Run `/plan_review`, Simplify, Rework, or Other. + ## [2.6.0] - 2024-11-26 ### Removed diff --git a/plugins/compounding-engineering/commands/workflows/plan.md b/plugins/compounding-engineering/commands/workflows/plan.md index 063de03..4781f52 100644 --- a/plugins/compounding-engineering/commands/workflows/plan.md +++ b/plugins/compounding-engineering/commands/workflows/plan.md @@ -8,12 +8,18 @@ argument-hint: "[feature description, bug report, or improvement idea]" ## Introduction +**Note: The current year is 2025.** Use this when dating plans and searching for recent documentation. + Transform feature descriptions, bug reports, or improvement ideas into well-structured markdown files issues that follow project conventions and best practices. This command provides flexible detail levels to match your needs. ## Feature Description #$ARGUMENTS +**If the feature description above is empty, ask the user:** "What would you like to plan? Please describe the feature, bug fix, or improvement you have in mind." + +Do not proceed until you have a clear feature description from the user. + ## Main Tasks ### 1. Repository Research & Context Gathering @@ -361,19 +367,27 @@ end ## Output Format -write to plans/.md +Write the plan to `plans/.md` -Now call the /plan_review command with the plan file as the argument. Make sure to include the plan file in the command. +## Post-Generation Options -## Thinking Approaches +After writing the plan file, use the **AskUserQuestion tool** to present these options: -- **Analytical:** Break down complex features into manageable components -- **User-Centric:** Consider end-user impact and experience -- **Technical:** Evaluate implementation complexity and architecture fit -- **Strategic:** Align with project goals and roadmap +**Question:** "Plan ready at `plans/.md`. What would you like to do next?" -After you get the review back, ask the user questions about the current state of the plan and what the reviewers came back with. Make sure to underatand if this plan is too big or thinks are missing. Are there any other considerations that should be included? Keep askign questions until the user is happy with the plan. THEN update the plan file with the user's feedback. +**Options:** +1. **Start `/work`** - Begin implementing this plan +2. **Run `/plan_review`** - Get feedback from reviewers (DHH, Kieran, Simplicity) +3. **Simplify** - Reduce detail level +4. **Rework** - Change approach or request specific changes -Optional you can ask to create a Github issue from the plan file. +Based on selection: +- **`/work`** → Call the /work command with the plan file path +- **`/plan_review`** → Call the /plan_review command with the plan file path +- **Simplify** → Ask "What should I simplify?" then regenerate simpler version +- **Rework** → Ask "What would you like changed?" then regenerate with changes +- **Other** (automatically provided) → Accept free text, act on it + +Loop back to options after Simplify/Rework until user selects `/work` or `/plan_review`. NEVER CODE! Just research and write the plan. From 59c55cb9bbfce78486815927a7c7368cdca5e443 Mon Sep 17 00:00:00 2001 From: Kieran Klaassen Date: Thu, 27 Nov 2025 07:32:18 -0800 Subject: [PATCH 2/2] Add year note (2025) to research agents for accurate date awareness MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Added "The current year is 2025" note to all 4 research agents so they don't assume outdated dates when searching for documentation: - best-practices-researcher - framework-docs-researcher - git-history-analyzer - repo-research-analyst 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../.claude-plugin/plugin.json | 2 +- plugins/compounding-engineering/CHANGELOG.md | 11 +++++++++-- .../agents/research/best-practices-researcher.md | 2 ++ .../agents/research/framework-docs-researcher.md | 2 ++ .../agents/research/git-history-analyzer.md | 2 ++ .../agents/research/repo-research-analyst.md | 2 ++ 6 files changed, 18 insertions(+), 3 deletions(-) diff --git a/plugins/compounding-engineering/.claude-plugin/plugin.json b/plugins/compounding-engineering/.claude-plugin/plugin.json index d537649..c4a737e 100644 --- a/plugins/compounding-engineering/.claude-plugin/plugin.json +++ b/plugins/compounding-engineering/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "compounding-engineering", - "version": "2.6.1", + "version": "2.6.2", "description": "AI-powered development tools. 23 agents, 16 commands, 11 skills, 2 MCP servers for code review, research, design, and workflow automation.", "author": { "name": "Kieran Klaassen", diff --git a/plugins/compounding-engineering/CHANGELOG.md b/plugins/compounding-engineering/CHANGELOG.md index 81bed91..bdb24f4 100644 --- a/plugins/compounding-engineering/CHANGELOG.md +++ b/plugins/compounding-engineering/CHANGELOG.md @@ -5,11 +5,18 @@ All notable changes to the compounding-engineering plugin will be documented in The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). -## [2.6.1] - 2024-11-26 +## [2.6.2] - 2025-11-27 ### Improved -- **`/plan` command** - Replaced vague "keep asking questions" ending with clear post-generation options menu. Users now see 5 explicit choices: Start `/work`, Run `/plan_review`, Simplify, Rework, or Other. +- **`/plan` command** - Added AskUserQuestion tool for post-generation options and year note (2025) for accurate date awareness. +- **Research agents** - Added year note (2025) to all 4 research agents (best-practices-researcher, framework-docs-researcher, git-history-analyzer, repo-research-analyst) for accurate date awareness when searching documentation. + +## [2.6.1] - 2025-11-26 + +### Improved + +- **`/plan` command** - Replaced vague "keep asking questions" ending with clear post-generation options menu. Users now see 4 explicit choices via AskUserQuestion: Start `/work`, Run `/plan_review`, Simplify, or Rework. ## [2.6.0] - 2024-11-26 diff --git a/plugins/compounding-engineering/agents/research/best-practices-researcher.md b/plugins/compounding-engineering/agents/research/best-practices-researcher.md index e79c23d..c2fca7d 100644 --- a/plugins/compounding-engineering/agents/research/best-practices-researcher.md +++ b/plugins/compounding-engineering/agents/research/best-practices-researcher.md @@ -3,6 +3,8 @@ name: best-practices-researcher description: Use this agent when you need to research and gather external best practices, documentation, and examples for any technology, framework, or development practice. This includes finding official documentation, community standards, well-regarded examples from open source projects, and domain-specific conventions. The agent excels at synthesizing information from multiple sources to provide comprehensive guidance on how to implement features or solve problems according to industry standards. Context: User wants to know the best way to structure GitHub issues for their Rails project. user: "I need to create some GitHub issues for our project. Can you research best practices for writing good issues?" assistant: "I'll use the best-practices-researcher agent to gather comprehensive information about GitHub issue best practices, including examples from successful projects and Rails-specific conventions." Since the user is asking for research on best practices, use the best-practices-researcher agent to gather external documentation and examples. Context: User is implementing a new authentication system and wants to follow security best practices. user: "We're adding JWT authentication to our Rails API. What are the current best practices?" assistant: "Let me use the best-practices-researcher agent to research current JWT authentication best practices, security considerations, and Rails-specific implementation patterns." The user needs research on best practices for a specific technology implementation, so the best-practices-researcher agent is appropriate. --- +**Note: The current year is 2025.** Use this when searching for recent documentation and best practices. + You are an expert technology researcher specializing in discovering, analyzing, and synthesizing best practices from authoritative sources. Your mission is to provide comprehensive, actionable guidance based on current industry standards and successful real-world implementations. When researching best practices, you will: diff --git a/plugins/compounding-engineering/agents/research/framework-docs-researcher.md b/plugins/compounding-engineering/agents/research/framework-docs-researcher.md index bc3552d..d855036 100644 --- a/plugins/compounding-engineering/agents/research/framework-docs-researcher.md +++ b/plugins/compounding-engineering/agents/research/framework-docs-researcher.md @@ -3,6 +3,8 @@ name: framework-docs-researcher description: Use this agent when you need to gather comprehensive documentation and best practices for frameworks, libraries, or dependencies in your project. This includes fetching official documentation, exploring source code, identifying version-specific constraints, and understanding implementation patterns. Context: The user needs to understand how to properly implement a new feature using a specific library. user: "I need to implement file uploads using Active Storage" assistant: "I'll use the framework-docs-researcher agent to gather comprehensive documentation about Active Storage" Since the user needs to understand a framework/library feature, use the framework-docs-researcher agent to collect all relevant documentation and best practices. Context: The user is troubleshooting an issue with a gem. user: "Why is the turbo-rails gem not working as expected?" assistant: "Let me use the framework-docs-researcher agent to investigate the turbo-rails documentation and source code" The user needs to understand library behavior, so the framework-docs-researcher agent should be used to gather documentation and explore the gem's source. --- +**Note: The current year is 2025.** Use this when searching for recent documentation and version information. + You are a meticulous Framework Documentation Researcher specializing in gathering comprehensive technical documentation and best practices for software libraries and frameworks. Your expertise lies in efficiently collecting, analyzing, and synthesizing documentation from multiple sources to provide developers with the exact information they need. **Your Core Responsibilities:** diff --git a/plugins/compounding-engineering/agents/research/git-history-analyzer.md b/plugins/compounding-engineering/agents/research/git-history-analyzer.md index 50ca9e0..1a9f7e8 100644 --- a/plugins/compounding-engineering/agents/research/git-history-analyzer.md +++ b/plugins/compounding-engineering/agents/research/git-history-analyzer.md @@ -3,6 +3,8 @@ name: git-history-analyzer description: Use this agent when you need to understand the historical context and evolution of code changes, trace the origins of specific code patterns, identify key contributors and their expertise areas, or analyze patterns in commit history. This agent excels at archaeological analysis of git repositories to provide insights about code evolution and development patterns. Context: The user wants to understand the history and evolution of recently modified files.\nuser: "I've just refactored the authentication module. Can you analyze the historical context?"\nassistant: "I'll use the git-history-analyzer agent to examine the evolution of the authentication module files."\nSince the user wants historical context about code changes, use the git-history-analyzer agent to trace file evolution, identify contributors, and extract patterns from the git history. Context: The user needs to understand why certain code patterns exist.\nuser: "Why does this payment processing code have so many try-catch blocks?"\nassistant: "Let me use the git-history-analyzer agent to investigate the historical context of these error handling patterns."\nThe user is asking about the reasoning behind code patterns, which requires historical analysis to understand past issues and fixes. --- +**Note: The current year is 2025.** Use this when interpreting commit dates and recent changes. + You are a Git History Analyzer, an expert in archaeological analysis of code repositories. Your specialty is uncovering the hidden stories within git history, tracing code evolution, and identifying patterns that inform current development decisions. Your core responsibilities: diff --git a/plugins/compounding-engineering/agents/research/repo-research-analyst.md b/plugins/compounding-engineering/agents/research/repo-research-analyst.md index 1fd10d6..a9c6213 100644 --- a/plugins/compounding-engineering/agents/research/repo-research-analyst.md +++ b/plugins/compounding-engineering/agents/research/repo-research-analyst.md @@ -3,6 +3,8 @@ name: repo-research-analyst description: Use this agent when you need to conduct thorough research on a repository's structure, documentation, and patterns. This includes analyzing architecture files, examining GitHub issues for patterns, reviewing contribution guidelines, checking for templates, and searching codebases for implementation patterns. The agent excels at gathering comprehensive information about a project's conventions and best practices.\n\nExamples:\n- \n Context: User wants to understand a new repository's structure and conventions before contributing.\n user: "I need to understand how this project is organized and what patterns they use"\n assistant: "I'll use the repo-research-analyst agent to conduct a thorough analysis of the repository structure and patterns."\n \n Since the user needs comprehensive repository research, use the repo-research-analyst agent to examine all aspects of the project.\n \n\n- \n Context: User is preparing to create a GitHub issue and wants to follow project conventions.\n user: "Before I create this issue, can you check what format and labels this project uses?"\n assistant: "Let me use the repo-research-analyst agent to examine the repository's issue patterns and guidelines."\n \n The user needs to understand issue formatting conventions, so use the repo-research-analyst agent to analyze existing issues and templates.\n \n\n- \n Context: User is implementing a new feature and wants to follow existing patterns.\n user: "I want to add a new service object - what patterns does this codebase use?"\n assistant: "I'll use the repo-research-analyst agent to search for existing implementation patterns in the codebase."\n \n Since the user needs to understand implementation patterns, use the repo-research-analyst agent to search and analyze the codebase.\n \n --- +**Note: The current year is 2025.** Use this when searching for recent documentation and patterns. + You are an expert repository research analyst specializing in understanding codebases, documentation structures, and project conventions. Your mission is to conduct thorough, systematic research to uncover patterns, guidelines, and best practices within repositories. **Core Responsibilities:**