diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 2193a9b..557e68b 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,7 +1,7 @@ { "$schema": "https://anthropic.com/claude-code/marketplace.schema.json", "name": "context-engineering-kit", - "version": "2.0.0", + "version": "2.0.1", "description": "Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.", "owner": { "name": "NeoLabHQ", diff --git a/plugins/code-review/skills/review-local-changes/SKILL.md b/plugins/code-review/skills/review-local-changes/SKILL.md index c9a63d1..b230ee3 100644 --- a/plugins/code-review/skills/review-local-changes/SKILL.md +++ b/plugins/code-review/skills/review-local-changes/SKILL.md @@ -1,5 +1,4 @@ --- -name: review-local-changes description: Comprehensive review of local uncommitted changes using specialized agents with code improvement suggestions allowed-tools: ["Bash", "Glob", "Grep", "Read", "Task"] disable-model-invocation: false diff --git a/plugins/code-review/skills/review-pr/SKILL.md b/plugins/code-review/skills/review-pr/SKILL.md index b63b4cc..28d8822 100644 --- a/plugins/code-review/skills/review-pr/SKILL.md +++ b/plugins/code-review/skills/review-pr/SKILL.md @@ -1,5 +1,4 @@ --- -name: review-pr description: Comprehensive pull request review using specialized agents argument-hint: "[review-aspects]" --- diff --git a/plugins/customaize-agent/skills/agent-evaluation/SKILL.md b/plugins/customaize-agent/skills/agent-evaluation/SKILL.md index 30b4007..25e8659 100644 --- a/plugins/customaize-agent/skills/agent-evaluation/SKILL.md +++ b/plugins/customaize-agent/skills/agent-evaluation/SKILL.md @@ -1,5 +1,4 @@ --- -name: agent-evaluation description: Evaluate and improve Claude Code commands, skills, and agents. Use when testing prompt effectiveness, validating context engineering choices, or measuring improvement quality. --- diff --git a/plugins/customaize-agent/skills/apply-anthropic-skill-best-practices/SKILL.md b/plugins/customaize-agent/skills/apply-anthropic-skill-best-practices/SKILL.md index b481142..4f86ee9 100644 --- a/plugins/customaize-agent/skills/apply-anthropic-skill-best-practices/SKILL.md +++ b/plugins/customaize-agent/skills/apply-anthropic-skill-best-practices/SKILL.md @@ -1,5 +1,4 @@ --- -name: apply-anthropic-skill-best-practices description: Comprehensive guide for skill development based on Anthropic's official best practices - use for complex skills requiring detailed structure argument-hint: Optional skill name or path to skill being reviewed --- diff --git a/plugins/customaize-agent/skills/context-engineering/SKILL.md b/plugins/customaize-agent/skills/context-engineering/SKILL.md index 4c4b424..98927a4 100644 --- a/plugins/customaize-agent/skills/context-engineering/SKILL.md +++ b/plugins/customaize-agent/skills/context-engineering/SKILL.md @@ -1,5 +1,4 @@ --- -name: context-engineering description: Understand the components, mechanics, and constraints of context in agent systems. Use when writing, editing, or optimizing commands, skills, or sub-agents prompts. --- diff --git a/plugins/customaize-agent/skills/create-agent/SKILL.md b/plugins/customaize-agent/skills/create-agent/SKILL.md index ffb9bcd..4b56c66 100644 --- a/plugins/customaize-agent/skills/create-agent/SKILL.md +++ b/plugins/customaize-agent/skills/create-agent/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-agent description: Comprehensive guide for creating Claude Code agents with proper structure, triggering conditions, system prompts, and validation - combines official Anthropic best practices with proven patterns argument-hint: [agent-name] [optional description of agent purpose] allowed-tools: Read, Write, Glob, Grep, Bash(mkdir:*), Task diff --git a/plugins/customaize-agent/skills/create-command/SKILL.md b/plugins/customaize-agent/skills/create-command/SKILL.md index 9010274..8709989 100644 --- a/plugins/customaize-agent/skills/create-command/SKILL.md +++ b/plugins/customaize-agent/skills/create-command/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-command description: Interactive assistant for creating new Claude commands with proper structure, patterns, and MCP tool integration argument-hint: Optional command name or description of command purpose --- diff --git a/plugins/customaize-agent/skills/create-hook/SKILL.md b/plugins/customaize-agent/skills/create-hook/SKILL.md index db139d9..e5de039 100644 --- a/plugins/customaize-agent/skills/create-hook/SKILL.md +++ b/plugins/customaize-agent/skills/create-hook/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-hook description: Create and configure git hooks with intelligent project analysis, suggestions, and automated testing argument-hint: Optional hook type or description of desired behavior --- diff --git a/plugins/customaize-agent/skills/create-skill/SKILL.md b/plugins/customaize-agent/skills/create-skill/SKILL.md index 60279bc..b073a10 100644 --- a/plugins/customaize-agent/skills/create-skill/SKILL.md +++ b/plugins/customaize-agent/skills/create-skill/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-skill description: Guide for creating effective skills. This command should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations. Use when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing, iterating until bulletproof against rationalization --- diff --git a/plugins/customaize-agent/skills/create-workflow-command/SKILL.md b/plugins/customaize-agent/skills/create-workflow-command/SKILL.md index 68a1d12..739b189 100644 --- a/plugins/customaize-agent/skills/create-workflow-command/SKILL.md +++ b/plugins/customaize-agent/skills/create-workflow-command/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-workflow-command description: Create a workflow command that orchestrates multi-step execution through sub-agents with file-based task prompts argument-hint: [workflow-name] [description] allowed-tools: Read, Write, Glob, Grep, Bash(mkdir:*) diff --git a/plugins/customaize-agent/skills/prompt-engineering/SKILL.md b/plugins/customaize-agent/skills/prompt-engineering/SKILL.md index dc3b1b7..d5b4cda 100644 --- a/plugins/customaize-agent/skills/prompt-engineering/SKILL.md +++ b/plugins/customaize-agent/skills/prompt-engineering/SKILL.md @@ -1,5 +1,4 @@ --- -name: prompt-engineering description: Use this skill when you writing commands, hooks, skills for Agent, or prompts for sub agents or any other LLM interaction, including optimizing prompts, improving LLM outputs, or designing production prompt templates. --- diff --git a/plugins/customaize-agent/skills/test-prompt/SKILL.md b/plugins/customaize-agent/skills/test-prompt/SKILL.md index 5751942..7fa9300 100644 --- a/plugins/customaize-agent/skills/test-prompt/SKILL.md +++ b/plugins/customaize-agent/skills/test-prompt/SKILL.md @@ -1,5 +1,4 @@ --- -name: test-prompt description: Use when creating or editing any prompt (commands, hooks, skills, subagent instructions) to verify it produces desired behavior - applies RED-GREEN-REFACTOR cycle to prompt engineering using subagents for isolated testing --- diff --git a/plugins/customaize-agent/skills/test-skill/SKILL.md b/plugins/customaize-agent/skills/test-skill/SKILL.md index 13147fb..79a3918 100644 --- a/plugins/customaize-agent/skills/test-skill/SKILL.md +++ b/plugins/customaize-agent/skills/test-skill/SKILL.md @@ -1,5 +1,4 @@ --- -name: test-skill description: Use when creating or editing skills, before deployment, to verify they work under pressure and resist rationalization - applies RED-GREEN-REFACTOR cycle to process documentation by running baseline without skill, writing to address failures, iterating to close loopholes --- diff --git a/plugins/customaize-agent/skills/thought-based-reasoning/SKILL.md b/plugins/customaize-agent/skills/thought-based-reasoning/SKILL.md index 12488fe..7ca17d8 100644 --- a/plugins/customaize-agent/skills/thought-based-reasoning/SKILL.md +++ b/plugins/customaize-agent/skills/thought-based-reasoning/SKILL.md @@ -1,5 +1,4 @@ --- -name: thought-based-reasoning description: Use when tackling complex reasoning tasks requiring step-by-step logic, multi-step arithmetic, commonsense reasoning, symbolic manipulation, or problems where simple prompting fails - provides comprehensive guide to Chain-of-Thought and related prompting techniques (Zero-shot CoT, Self-Consistency, Tree of Thoughts, Least-to-Most, ReAct, PAL, Reflexion) with templates, decision matrices, and research-backed patterns --- diff --git a/plugins/ddd/skills/setup-code-formating/SKILL.md b/plugins/ddd/skills/setup-code-formating/SKILL.md index 8176ee9..12cc355 100644 --- a/plugins/ddd/skills/setup-code-formating/SKILL.md +++ b/plugins/ddd/skills/setup-code-formating/SKILL.md @@ -1,5 +1,4 @@ --- -name: setup-code-formating description: Sets up code formatting rules and style guidelines in CLAUDE.md argument-hint: None required - creates standard formatting configuration --- @@ -18,4 +17,4 @@ Create or update CLAUDE.md in with following content, write it strictl - No unnecessary curly braces (enforced) - 2-space indentation - Import order: external → internal → types -``` \ No newline at end of file +``` diff --git a/plugins/ddd/skills/software-architecture/SKILL.md b/plugins/ddd/skills/software-architecture/SKILL.md index 7e8487f..698dc2b 100644 --- a/plugins/ddd/skills/software-architecture/SKILL.md +++ b/plugins/ddd/skills/software-architecture/SKILL.md @@ -1,5 +1,4 @@ --- -name: software-architecture description: Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development. --- diff --git a/plugins/docs/skills/update-docs/SKILL.md b/plugins/docs/skills/update-docs/SKILL.md index 6f12ac4..8a93ff7 100644 --- a/plugins/docs/skills/update-docs/SKILL.md +++ b/plugins/docs/skills/update-docs/SKILL.md @@ -1,5 +1,4 @@ --- -name: update-docs description: Update and maintain project documentation for local code changes using multi-agent workflow with tech-writer agents. Covers docs/, READMEs, JSDoc, and API documentation. argument-hint: Optional target directory, documentation type (api, guides, readme, jsdoc), or specific focus area --- diff --git a/plugins/docs/skills/write-concisely/SKILL.md b/plugins/docs/skills/write-concisely/SKILL.md index f20e2da..efafbab 100644 --- a/plugins/docs/skills/write-concisely/SKILL.md +++ b/plugins/docs/skills/write-concisely/SKILL.md @@ -1,5 +1,4 @@ --- -name: write-concisely description: Apply writing rules to any documentation that humans will read. Makes your writing clearer, stronger, and more professional. --- diff --git a/plugins/git/skills/analyze-issue/SKILL.md b/plugins/git/skills/analyze-issue/SKILL.md index 99758a4..a73d0dd 100644 --- a/plugins/git/skills/analyze-issue/SKILL.md +++ b/plugins/git/skills/analyze-issue/SKILL.md @@ -1,5 +1,4 @@ --- -name: analyze-issue description: Analyze a GitHub issue and create a detailed technical specification argument-hint: Issue number (e.g., 42) allowed-tools: Bash(gh issue:*), Read, Write, Glob, Grep @@ -77,4 +76,4 @@ For example, for issue #7 with title "Make code review trigger on any *.SQL and After saving, provide a brief summary to the user confirming: - Issue number and title analyzed - File path where the specification was saved -- Key highlights from the specification (2-3 bullet points) \ No newline at end of file +- Key highlights from the specification (2-3 bullet points) diff --git a/plugins/git/skills/attach-review-to-pr/SKILL.md b/plugins/git/skills/attach-review-to-pr/SKILL.md index 9c8bb58..7657583 100644 --- a/plugins/git/skills/attach-review-to-pr/SKILL.md +++ b/plugins/git/skills/attach-review-to-pr/SKILL.md @@ -1,5 +1,4 @@ --- -name: attach-review-to-pr description: Add line-specific review comments to pull requests using GitHub CLI API argument-hint: PR number or URL (optional - can work with current branch) allowed-tools: Bash(gh api:*), Bash(gh auth:*), Bash(gh pr:*), mcp__github_inline_comment__create_inline_comment diff --git a/plugins/git/skills/commit/SKILL.md b/plugins/git/skills/commit/SKILL.md index 85c15f4..44b268c 100644 --- a/plugins/git/skills/commit/SKILL.md +++ b/plugins/git/skills/commit/SKILL.md @@ -1,5 +1,4 @@ --- -name: commit description: Create well-formatted commits with conventional commit messages and emoji argument-hint: Optional flags like --no-verify to skip pre-commit checks model: haiku @@ -183,4 +182,4 @@ When committing on `master` or `main`, the command will ask if you want to creat - The commit message will be constructed based on the changes detected - Before committing, the command will review the diff to identify if multiple commits would be more appropriate - If suggesting multiple commits, it will help you stage and commit the changes separately -- Always reviews the commit diff to ensure the message matches the changes \ No newline at end of file +- Always reviews the commit diff to ensure the message matches the changes diff --git a/plugins/git/skills/compare-worktrees/SKILL.md b/plugins/git/skills/compare-worktrees/SKILL.md index 07eb3b6..711148b 100644 --- a/plugins/git/skills/compare-worktrees/SKILL.md +++ b/plugins/git/skills/compare-worktrees/SKILL.md @@ -1,5 +1,4 @@ --- -name: compare-worktrees description: Compare files and directories between git worktrees or worktree and current branch argument-hint: Path(s) to compare, worktree paths, branch names, or --stat for summary model: opus diff --git a/plugins/git/skills/create-pr/SKILL.md b/plugins/git/skills/create-pr/SKILL.md index be1146a..f855701 100644 --- a/plugins/git/skills/create-pr/SKILL.md +++ b/plugins/git/skills/create-pr/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-pr description: Create pull requests using GitHub CLI with proper templates and formatting argument-hint: None required - interactive guide for PR creation allowed-tools: Bash(gh pr:*), Bash(gh auth:*), Bash(git status:*), Bash(git push:*), Bash(git branch:*), Skill(git:commit) @@ -140,4 +139,4 @@ gh pr create --draft --title "feat(scope): Your title" --body-file pr-template.m - [PR Template](.github/pull_request_template.md) - [Conventional Commits](https://www.conventionalcommits.org/) -- [GitHub CLI documentation](https://cli.github.com/manual/) \ No newline at end of file +- [GitHub CLI documentation](https://cli.github.com/manual/) diff --git a/plugins/git/skills/create-worktree/SKILL.md b/plugins/git/skills/create-worktree/SKILL.md index 708a66f..dfcbad1 100644 --- a/plugins/git/skills/create-worktree/SKILL.md +++ b/plugins/git/skills/create-worktree/SKILL.md @@ -1,5 +1,4 @@ --- -name: create-worktree description: Create and setup git worktrees for parallel development with automatic dependency installation argument-hint: (e.g., "refactor auth system" or "fix login") or --list to show existing worktrees model: opus diff --git a/plugins/git/skills/load-issues/SKILL.md b/plugins/git/skills/load-issues/SKILL.md index 3a15bdf..ea891c3 100644 --- a/plugins/git/skills/load-issues/SKILL.md +++ b/plugins/git/skills/load-issues/SKILL.md @@ -1,5 +1,4 @@ --- -name: load-issues description: Load all open issues from GitHub and save them as markdown files argument-hint: None required - loads all open issues automatically allowed-tools: Bash(gh issue:*), Bash(mkdir:*), Write diff --git a/plugins/git/skills/merge-worktree/SKILL.md b/plugins/git/skills/merge-worktree/SKILL.md index b951f22..c586cea 100644 --- a/plugins/git/skills/merge-worktree/SKILL.md +++ b/plugins/git/skills/merge-worktree/SKILL.md @@ -1,5 +1,4 @@ --- -name: merge-worktree description: Merge changes from worktrees into current branch with selective file checkout, cherry-picking, interactive patch selection, or manual merge argument-hint: file/directory path, commit name, branch name, or --interactive for guided mode model: opus diff --git a/plugins/git/skills/notes/SKILL.md b/plugins/git/skills/notes/SKILL.md index d062ada..db6acbf 100644 --- a/plugins/git/skills/notes/SKILL.md +++ b/plugins/git/skills/notes/SKILL.md @@ -1,5 +1,4 @@ --- -name: notes description: Use when adding metadata to commits without changing history, tracking review status, test results, code quality annotations, or supplementing commit messages post-hoc - provides git notes commands and patterns for attaching non-invasive metadata to Git objects. --- diff --git a/plugins/git/skills/worktrees/SKILL.md b/plugins/git/skills/worktrees/SKILL.md index 3ac82e3..25b45f7 100644 --- a/plugins/git/skills/worktrees/SKILL.md +++ b/plugins/git/skills/worktrees/SKILL.md @@ -1,5 +1,4 @@ --- -name: worktrees description: Use when working on multiple branches simultaneously, context switching without stashing, reviewing PRs while developing, testing in isolation, or comparing implementations across branches - provides git worktree commands and workflow patterns for parallel development with multiple working directories. --- diff --git a/plugins/kaizen/skills/analyse-problem/SKILL.md b/plugins/kaizen/skills/analyse-problem/SKILL.md index e5520d0..3f33dba 100644 --- a/plugins/kaizen/skills/analyse-problem/SKILL.md +++ b/plugins/kaizen/skills/analyse-problem/SKILL.md @@ -1,5 +1,4 @@ --- -name: analyse-problem description: Comprehensive A3 one-page problem analysis with root cause and action plan argument-hint: Optional problem description to document --- diff --git a/plugins/kaizen/skills/analyse/SKILL.md b/plugins/kaizen/skills/analyse/SKILL.md index a74e0b8..c17d755 100644 --- a/plugins/kaizen/skills/analyse/SKILL.md +++ b/plugins/kaizen/skills/analyse/SKILL.md @@ -1,5 +1,4 @@ --- -name: analyse description: Auto-selects best Kaizen method (Gemba Walk, Value Stream, or Muda) for target argument-hint: Optional target description (e.g., code, workflow, or inefficiencies) --- diff --git a/plugins/kaizen/skills/cause-and-effect/SKILL.md b/plugins/kaizen/skills/cause-and-effect/SKILL.md index d10f739..615c48e 100644 --- a/plugins/kaizen/skills/cause-and-effect/SKILL.md +++ b/plugins/kaizen/skills/cause-and-effect/SKILL.md @@ -1,5 +1,4 @@ --- -name: cause-and-effect description: Systematic Fishbone analysis exploring problem causes across six categories argument-hint: Optional problem description to analyze --- diff --git a/plugins/kaizen/skills/kaizen/SKILL.md b/plugins/kaizen/skills/kaizen/SKILL.md index 1696ec2..728f39f 100644 --- a/plugins/kaizen/skills/kaizen/SKILL.md +++ b/plugins/kaizen/skills/kaizen/SKILL.md @@ -1,5 +1,4 @@ --- -name: kaizen description: Use when Code implementation and refactoring, architecturing or designing systems, process and workflow improvements, error handling and validation. Provide tehniquest to avoid over-engineering and apply iterative improvements. --- diff --git a/plugins/kaizen/skills/plan-do-check-act/SKILL.md b/plugins/kaizen/skills/plan-do-check-act/SKILL.md index f728e92..aec1883 100644 --- a/plugins/kaizen/skills/plan-do-check-act/SKILL.md +++ b/plugins/kaizen/skills/plan-do-check-act/SKILL.md @@ -1,5 +1,4 @@ --- -name: plan-do-check-act description: Iterative PDCA cycle for systematic experimentation and continuous improvement argument-hint: Optional improvement goal or problem to address --- diff --git a/plugins/kaizen/skills/root-cause-tracing/SKILL.md b/plugins/kaizen/skills/root-cause-tracing/SKILL.md index 510fd09..345c3f3 100644 --- a/plugins/kaizen/skills/root-cause-tracing/SKILL.md +++ b/plugins/kaizen/skills/root-cause-tracing/SKILL.md @@ -1,5 +1,4 @@ --- -name: root-cause-tracing description: Use when errors occur deep in execution and you need to trace back to find the original trigger - systematically traces bugs backward through call stack, adding instrumentation when needed, to identify source of invalid data or incorrect behavior --- diff --git a/plugins/kaizen/skills/why/SKILL.md b/plugins/kaizen/skills/why/SKILL.md index e45c0bd..a037af7 100644 --- a/plugins/kaizen/skills/why/SKILL.md +++ b/plugins/kaizen/skills/why/SKILL.md @@ -1,5 +1,4 @@ --- -name: why description: Iterative Five Whys root cause analysis drilling from symptoms to fundamentals argument-hint: Optional issue or symptom description --- diff --git a/plugins/mcp/skills/build-mcp/SKILL.md b/plugins/mcp/skills/build-mcp/SKILL.md index 5a1e6e6..03061e7 100644 --- a/plugins/mcp/skills/build-mcp/SKILL.md +++ b/plugins/mcp/skills/build-mcp/SKILL.md @@ -1,5 +1,4 @@ --- -name: build-mcp description: Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). --- diff --git a/plugins/mcp/skills/setup-arxiv-mcp/SKILL.md b/plugins/mcp/skills/setup-arxiv-mcp/SKILL.md index 8282cde..df87455 100644 --- a/plugins/mcp/skills/setup-arxiv-mcp/SKILL.md +++ b/plugins/mcp/skills/setup-arxiv-mcp/SKILL.md @@ -1,5 +1,4 @@ --- -name: setup-arxiv-mcp description: Guide for setup arXiv paper search MCP server using Docker MCP argument-hint: Optional - specific research topics or paper sources to configure --- diff --git a/plugins/mcp/skills/setup-codemap-cli/SKILL.md b/plugins/mcp/skills/setup-codemap-cli/SKILL.md index b7d26ac..4a0ba20 100644 --- a/plugins/mcp/skills/setup-codemap-cli/SKILL.md +++ b/plugins/mcp/skills/setup-codemap-cli/SKILL.md @@ -1,5 +1,4 @@ --- -name: setup-codemap-cli description: Guide for setup Codemap CLI for intelligent codebase visualization and navigation argument-hint: Optional - specific configuration preferences or OS type --- diff --git a/plugins/mcp/skills/setup-context7-mcp/SKILL.md b/plugins/mcp/skills/setup-context7-mcp/SKILL.md index cfdefd0..5f64270 100644 --- a/plugins/mcp/skills/setup-context7-mcp/SKILL.md +++ b/plugins/mcp/skills/setup-context7-mcp/SKILL.md @@ -1,5 +1,4 @@ --- -name: setup-context7-mcp description: Guide for setup Context7 MCP server to load documentation for specific technologies. argument-hint: List of languages and frameworks to load documentation for --- diff --git a/plugins/mcp/skills/setup-serena-mcp/SKILL.md b/plugins/mcp/skills/setup-serena-mcp/SKILL.md index d1861c5..c21e61c 100644 --- a/plugins/mcp/skills/setup-serena-mcp/SKILL.md +++ b/plugins/mcp/skills/setup-serena-mcp/SKILL.md @@ -1,5 +1,4 @@ --- -name: setup-serena-mcp description: Guide for setup Serena MCP server for semantic code retrieval and editing capabilities argument-hint: Optional - specific configuration preferences or client type --- diff --git a/plugins/reflexion/README.md b/plugins/reflexion/README.md index 249ae79..30cc117 100644 --- a/plugins/reflexion/README.md +++ b/plugins/reflexion/README.md @@ -89,19 +89,23 @@ The plugin includes optional hooks that automatically trigger reflection when yo ## Theoretical Foundation -The Reflexion plugin is based on peer-reviewed research demonstrating **8-21% improvement in output quality** across diverse tasks: +Based on papers like [Self-Refine](https://arxiv.org/abs/2303.17651) and [Reflexion](https://arxiv.org/abs/2303.11366). These techniques improve the output of large language models by introducing feedback and refinement loops. -### Core Papers +They are proven to **increase output quality by 8–21%** based on both automatic metrics and human preferences across seven diverse tasks, including dialogue generation, coding, and mathematical reasoning, when compared to standard one-step model outputs. + +Full list of included patterns and techniques: -- **[Self-Refine](https://arxiv.org/abs/2303.17651)** - Iterative refinement where the model reviews and improves its own output -- **[Reflexion](https://arxiv.org/abs/2303.11366)** - Self-reflection for autonomous agents with memory -- **[Constitutional AI (CAI)](https://arxiv.org/abs/2212.08073)** - Critique based on principles and guidelines -- **[LLM-as-a-Judge](https://arxiv.org/abs/2306.05685)** - Using LLMs to evaluate other LLM outputs -- **[Multi-Agent Debate](https://arxiv.org/abs/2305.14325)** - Multiple models proposing and critiquing solutions -- **[Agentic Context Engineering](https://arxiv.org/abs/2510.04618)** - Memory updates after reflection (**10.6% improvement**) +- [Self-Refinement / Iterative Refinement](https://arxiv.org/abs/2303.17651) - One model generates, then reviews and improves its own output +- [Constitutional AI (CAI) / RLAIF](https://arxiv.org/abs/2212.08073) - One model generates responses, another critiques them based on principles +- [Critic-Generator or Verifier-Generator Architecture](https://arxiv.org/abs/2510.14660v1) - Generator model creates outputs, Critic/verifier model evaluates and provides feedback +- [LLM-as-a-Judge](https://arxiv.org/abs/2306.05685) - One LLM evaluates/scores outputs from another LLM +- [Debate / Multi-Agent Debate](https://arxiv.org/abs/2305.14325) - Multiple models propose and critique solutions +- [Generate-Verify-Refine (GVR)](https://arxiv.org/abs/2204.05511) - Three-stage process: generate → verify → refine based on verification + +On top of that, the plugin is based on the [Agentic Context Engineering](https://arxiv.org/abs/2510.04618) paper that uses memory updates after reflection, and **consistently outperforms strong baselines by 10.6%** on agents. -### Additional Techniques +Also includes the following techniques: -- **[Chain-of-Verification (CoVe)](https://arxiv.org/abs/2309.11495)** - Generate, verify, revise cycle -- **[Tree of Thoughts (ToT)](https://arxiv.org/abs/2305.10601)** - Multiple reasoning path exploration -- **[Process Reward Models](https://arxiv.org/abs/2305.20050)** - Step-by-step evaluation +- [Chain-of-Verification (CoVe)](https://arxiv.org/abs/2309.11495) - Model generates answer, then verification questions, then revises +- [Tree of Thoughts (ToT)](https://arxiv.org/abs/2305.10601) - Explores multiple reasoning paths with evaluation +- [Process Reward Models (PRM)](https://arxiv.org/abs/2305.20050) - Evaluates reasoning steps rather than just final answers diff --git a/plugins/reflexion/skills/critique/SKILL.md b/plugins/reflexion/skills/critique/SKILL.md index 7dac52e..e9bfc06 100644 --- a/plugins/reflexion/skills/critique/SKILL.md +++ b/plugins/reflexion/skills/critique/SKILL.md @@ -1,5 +1,4 @@ --- -name: critique description: Comprehensive multi-perspective review using specialized judges with debate and consensus building argument-hint: Optional file paths, commits, or context to review (defaults to recent changes) --- diff --git a/plugins/reflexion/skills/memorize/SKILL.md b/plugins/reflexion/skills/memorize/SKILL.md index b0d9870..aac1768 100644 --- a/plugins/reflexion/skills/memorize/SKILL.md +++ b/plugins/reflexion/skills/memorize/SKILL.md @@ -1,5 +1,4 @@ --- -name: memorize description: Curates insights from reflections and critiques into CLAUDE.md using Agentic Context Engineering argument-hint: Optional source specification (last, selection, chat:) or --dry-run for preview --- diff --git a/plugins/reflexion/skills/reflect/SKILL.md b/plugins/reflexion/skills/reflect/SKILL.md index 8131b08..12c730c 100644 --- a/plugins/reflexion/skills/reflect/SKILL.md +++ b/plugins/reflexion/skills/reflect/SKILL.md @@ -1,5 +1,4 @@ --- -name: reflect description: Reflect on previus response and output, based on Self-refinement framework for iterative improvement with complexity triage and verification argument-hint: Optional focus area or confidence threshold to use, for example "security" or "deep reflect if less than 90% confidence" --- diff --git a/plugins/sadd/skills/do-and-judge/SKILL.md b/plugins/sadd/skills/do-and-judge/SKILL.md index 0ffdf3b..25060b1 100644 --- a/plugins/sadd/skills/do-and-judge/SKILL.md +++ b/plugins/sadd/skills/do-and-judge/SKILL.md @@ -1,5 +1,4 @@ --- -name: do-and-judge description: Execute a task with sub-agent implementation and LLM-as-a-judge verification with automatic retry loop argument-hint: Task description (e.g., "Refactor the UserService class to use dependency injection") --- diff --git a/plugins/sadd/skills/do-competitively/SKILL.md b/plugins/sadd/skills/do-competitively/SKILL.md index b859d79..8cc9e0c 100644 --- a/plugins/sadd/skills/do-competitively/SKILL.md +++ b/plugins/sadd/skills/do-competitively/SKILL.md @@ -1,5 +1,4 @@ --- -name: do-competitively description: Execute tasks through competitive multi-agent generation, multi-judge evaluation, and evidence-based synthesis argument-hint: Task description and optional output path/criteria --- diff --git a/plugins/sadd/skills/do-in-parallel/SKILL.md b/plugins/sadd/skills/do-in-parallel/SKILL.md index f0f59c6..a73af5d 100644 --- a/plugins/sadd/skills/do-in-parallel/SKILL.md +++ b/plugins/sadd/skills/do-in-parallel/SKILL.md @@ -1,5 +1,4 @@ --- -name: do-in-parallel description: Launch multiple sub-agents in parallel to execute tasks across files or targets with intelligent model selection and quality-focused prompting argument-hint: Task description [--files "file1.ts,file2.ts,..."] [--targets "target1,target2,..."] [--model opus|sonnet|haiku] [--output ] --- diff --git a/plugins/sadd/skills/do-in-steps/SKILL.md b/plugins/sadd/skills/do-in-steps/SKILL.md index 4fd6b6b..e95e1f7 100644 --- a/plugins/sadd/skills/do-in-steps/SKILL.md +++ b/plugins/sadd/skills/do-in-steps/SKILL.md @@ -1,5 +1,4 @@ --- -name: do-in-steps description: Execute complex tasks through sequential sub-agent orchestration with intelligent model selection, and LLM-as-a-judge verification argument-hint: Task description (e.g., "Refactor UserService class and update all consumers") --- diff --git a/plugins/sadd/skills/judge-with-debate/SKILL.md b/plugins/sadd/skills/judge-with-debate/SKILL.md index 8eb029c..c2ecaf4 100644 --- a/plugins/sadd/skills/judge-with-debate/SKILL.md +++ b/plugins/sadd/skills/judge-with-debate/SKILL.md @@ -1,5 +1,4 @@ --- -name: judge-with-debate description: Evaluate solutions through multi-round debate between independent judges until consensus argument-hint: Solution path(s) and evaluation criteria --- diff --git a/plugins/sadd/skills/judge/SKILL.md b/plugins/sadd/skills/judge/SKILL.md index 6f906a5..938b412 100644 --- a/plugins/sadd/skills/judge/SKILL.md +++ b/plugins/sadd/skills/judge/SKILL.md @@ -1,5 +1,4 @@ --- -name: judge description: Launch a sub-agent judge to evaluate results produced in the current conversation argument-hint: "[evaluation-focus]" --- diff --git a/plugins/sadd/skills/launch-sub-agent/SKILL.md b/plugins/sadd/skills/launch-sub-agent/SKILL.md index a7bf91d..ff9e58c 100644 --- a/plugins/sadd/skills/launch-sub-agent/SKILL.md +++ b/plugins/sadd/skills/launch-sub-agent/SKILL.md @@ -1,5 +1,4 @@ --- -name: launch-sub-agent description: Launch an intelligent sub-agent with automatic model selection based on task complexity, specialized agent matching, Zero-shot CoT reasoning, and mandatory self-critique verification argument-hint: Task description (e.g., "Implement user authentication" or "Research caching strategies") [--model opus|sonnet|haiku] [--agent ] [--output ] --- diff --git a/plugins/sadd/skills/multi-agent-patterns/SKILL.md b/plugins/sadd/skills/multi-agent-patterns/SKILL.md index 6a466b9..49cffc2 100644 --- a/plugins/sadd/skills/multi-agent-patterns/SKILL.md +++ b/plugins/sadd/skills/multi-agent-patterns/SKILL.md @@ -1,5 +1,4 @@ --- -name: multi-agent-patterns description: Design multi-agent architectures for complex tasks. Use when single-agent context limits are exceeded, when tasks decompose naturally into subtasks, or when specializing agents improves quality. --- @@ -367,4 +366,4 @@ Memories accumulate over time and require consolidation to prevent unbounded gro Trigger consolidation after significant memory accumulation, when retrieval returns too many outdated results, periodically on a schedule, or when explicit consolidation is requested. **Consolidation Process** -Identify outdated facts, merge related facts, update validity periods, archive or delete obsolete facts, and rebuild indexes. \ No newline at end of file +Identify outdated facts, merge related facts, update validity periods, archive or delete obsolete facts, and rebuild indexes. diff --git a/plugins/sadd/skills/subagent-driven-development/SKILL.md b/plugins/sadd/skills/subagent-driven-development/SKILL.md index c5693fa..3399abf 100644 --- a/plugins/sadd/skills/subagent-driven-development/SKILL.md +++ b/plugins/sadd/skills/subagent-driven-development/SKILL.md @@ -1,5 +1,4 @@ --- -name: subagent-driven-development description: Use when executing implementation plans with independent tasks in the current session or facing 3+ independent issues that can be investigated without shared state or dependencies - dispatches fresh subagent for each task with code review between tasks, enabling fast iteration with quality gates --- diff --git a/plugins/sadd/skills/tree-of-thoughts/SKILL.md b/plugins/sadd/skills/tree-of-thoughts/SKILL.md index bc9ee50..5aef11b 100644 --- a/plugins/sadd/skills/tree-of-thoughts/SKILL.md +++ b/plugins/sadd/skills/tree-of-thoughts/SKILL.md @@ -1,5 +1,4 @@ --- -name: tree-of-thoughts description: Execute tasks through systematic exploration, pruning, and expansion using Tree of Thoughts methodology with multi-agent evaluation argument-hint: Task description and optional output path/criteria --- diff --git a/plugins/sdd/README.md b/plugins/sdd/README.md index 898a68f..d506a79 100644 --- a/plugins/sdd/README.md +++ b/plugins/sdd/README.md @@ -8,10 +8,10 @@ This plugin is designed to consistently and reproducibly produce working code. I - **Development as compilation** — The plugin works like a "compilation" or "nightly build" for your development process: `task specs → run /sdd:implement → working code`. After writing your prompt, you can launch the plugin and expect a working result when you come back. The time it takes depends on task complexity — simple tasks may finish in 30 minutes, while complex ones can take a few days. - **Benchmark-level quality in real life** — Model benchmarks improve with each release, yet real-world results usually stay the same. That's because benchmarks reflect the best possible output a model can achieve, whereas in practice LLMs tend to drift toward sub-optimal solutions that can be wrong or non-functional. This plugin uses a variety of patterns to keep the model working at its peak performance. -- **Customizable** — Balance between result quality and process speed by adjusting command parameters. Learn more in the [Customization](./customization.md) section. -- **Developer time-efficient** — The overall process is designed to minimize developer time and reduce the number of interactions, while still producing results better than what a model can generate from scratch. But overral quality is highly proportional to the time you invest in iterating and refining the specification. +- **Customizable** — Balance between result quality and process speed by adjusting command parameters. Learn more in the [Customization](customization.md) section. +- **Developer time-efficient** — The overall process is designed to minimize developer time and reduce the number of interactions, while still producing results better than what a model can generate from scratch. However, overall quality is highly proportional to the time you invest in iterating and refining the specification. - **Industry-standard** — The plugin's specification template is based on the arc42 standard, adjusted for LLM capabilities. Arc42 is a widely adopted, high-quality standard for software development documentation used by many companies and organizations. -- **Works best in complex or large codebases** — While most other frameworks work best for new projects and greenfield development, this plugin is designed to improve the more existing code and well-structured architecture you have. At each planning phase it includes a **codebase impact analysis** step that evaluates which files may be affected and which patterns to follow to achieve the desired result. +- **Works best in complex or large codebases** — While most other frameworks work best for new projects and greenfield development, this plugin is designed to perform better the more existing code and well-structured architecture you have. At each planning phase it includes a **codebase impact analysis** step that evaluates which files may be affected and which patterns to follow to achieve the desired result. - **Simple** — This plugin avoids unnecessary complexity and mainly uses just 3 commands, offloading process complexity to the model via multi-agent orchestration. `/sdd:implement` is a single command that produces working code from a task specification. To create that specification, you run `/sdd:add-task` and `/sdd:plan`, which analyze your prompt and iteratively refine the specification until it meets the required quality. ## Quick Start @@ -47,11 +47,11 @@ Restart the Claude Code session to clear context and start fresh. Then run the f ``` - [Detailed guide](../../guides/spec-driven-development.md) -- [Usage Examples](./usage-examples.md) +- [Usage Examples](usage-examples.md) ## Overall Flow -End-to-end task implementation process from initial prompt to pull request, including commands from the [git](../git) plugin: +End-to-end task implementation process from initial prompt to pull request, including commands from the [git](../git/README.md) plugin: - `/sdd:add-task` → creates a `.specs/tasks/draft/..md` file with the initial task description. - `/sdd:plan` → generates a `.claude/skills//SKILL.md` file with skills needed to implement the task (by analyzing library and framework documentation used in the codebase), then updates the task file with a refined specification and moves it to `.specs/tasks/todo/`. @@ -59,58 +59,34 @@ End-to-end task implementation process from initial prompt to pull request, incl - `/git:commit` → commits changes. - `/git:create-pr` → creates a pull request. -```mermaid -flowchart LR - subgraph Create["1. Create"] - A["/sdd:add-task"] - end - - subgraph Plan["2. Plan"] - B["/sdd:plan"] - end - - subgraph Implement["3. Implement"] - C["/sdd:implement"] - end - - subgraph Ship["4. Ship"] - D["/git:commit"] - E["/git:create-pr"] - end - - subgraph Files["Task Lifecycle"] - F1[📄 draft/*.md] - F2[📄 todo/*.md] - F3[📄 in-progress/*.md] - F4[📄 done/*.md] - end - - A --> F1 - F1 --> B - B --> F2 - F2 --> C - C --> F3 - F3 --> F4 - F4 --> D --> E - - style F1 fill:#ffecb3 - style F2 fill:#e1f5fe - style F3 fill:#fff3e0 - style F4 fill:#c8e6c9 +``` + 1. Create 2. Plan 3. Implement 4. Ship ++-------------+ +-----------+ +---------------+ +-----------------+ +|/sdd:add-task| | /sdd:plan | |/sdd:implement | | /git:commit | ++------+------+ +-----+-----+ +------+--------+ | | | + | | | | v | + v v v |/git:create-pr | + +-------+---------+ + | + Task Lifecycle | + +----------+ +----------+ +--------------+ +---------+ + | draft/ +-->| todo/ +-->| in-progress/ +-->| done/ | + | *.md | | *.md | | *.md | | *.md | + +----------+ +----------+ +--------------+ +---------+ ``` ## Commands Core workflow commands: -- [/sdd:add-task](./add-task.md) - Create task template file with initial prompt -- [/sdd:plan](./plan.md) - Analyze prompt, generate required skills and refine task specification -- [/sdd:implement](./implement.md) - Produce working implementation of the task and verify it +- [/sdd:add-task](add-task.md) - Create task template file with initial prompt +- [/sdd:plan](plan.md) - Analyze prompt, generate required skills and refine task specification +- [/sdd:implement](implement.md) - Produce working implementation of the task and verify it Additional commands useful before creating a task: -- [/sdd:create-ideas](./create-ideas.md) - Generate diverse ideas on a given topic using creative sampling techniques -- [/sdd:brainstorm](./brainstorm.md) - Refine vague ideas into fully-formed designs through collaborative dialogue +- [/sdd:create-ideas](create-ideas.md) - Generate diverse ideas on a given topic using creative sampling techniques +- [/sdd:brainstorm](brainstorm.md) - Refine vague ideas into fully-formed designs through collaborative dialogue ## Available Agents @@ -126,6 +102,7 @@ The SDD plugin uses specialized agents for different phases of development: | `team-lead` | Step parallelization, agent assignment, execution planning | `/sdd:plan` (Phase 5) | | `qa-engineer` | Verification rubrics, quality gates, LLM-as-Judge definitions | `/sdd:plan` (Phase 6) | | `developer` | Code implementation, TDD execution, quality review, verification | `/sdd:implement` | +| `tech-writer` | Technical documentation writing, API guides, architecture updates, lessons learned | `/sdd:implement` | ## Patterns @@ -148,7 +125,7 @@ Our tests showed that even when the initially generated specification was incorr Even if you don't want to spend much time on this process, you can still use the plugin for complex tasks without decomposition or human verification — but you will likely need tools like ralph-loop to keep the agent running for a longer time. -Learn more about available customization options in [Customization](./customization.md). +Learn more about available customization options in [Customization](customization.md). ## Theoretical Foundation diff --git a/plugins/sdd/skills/add-task/SKILL.md b/plugins/sdd/skills/add-task/SKILL.md index afe5069..795f5fb 100644 --- a/plugins/sdd/skills/add-task/SKILL.md +++ b/plugins/sdd/skills/add-task/SKILL.md @@ -1,5 +1,4 @@ --- -name: add-task description: creates draft task file in .specs/tasks/draft/ with original user intent argument-hint: Task title or description (e.g., "Add validation to form inputs") [list of task files that this task depends on] --- diff --git a/plugins/sdd/skills/brainstorm/SKILL.md b/plugins/sdd/skills/brainstorm/SKILL.md index d2112a8..f1732a0 100644 --- a/plugins/sdd/skills/brainstorm/SKILL.md +++ b/plugins/sdd/skills/brainstorm/SKILL.md @@ -58,4 +58,4 @@ Start by understanding the current project context, then ask questions one at a - **YAGNI ruthlessly** - Remove unnecessary features from all designs - **Explore alternatives** - Always propose 2-3 approaches before settling - **Incremental validation** - Present design in sections, validate each -- **Be flexible** - Go back and clarify when something doesn't make sense \ No newline at end of file +- **Be flexible** - Go back and clarify when something doesn't make sense diff --git a/plugins/sdd/skills/implement/SKILL.md b/plugins/sdd/skills/implement/SKILL.md index 06e8288..878cf88 100644 --- a/plugins/sdd/skills/implement/SKILL.md +++ b/plugins/sdd/skills/implement/SKILL.md @@ -1,5 +1,4 @@ --- -name: implement description: Implement a task with automated LLM-as-Judge verification for critical steps argument-hint: Task file [options] (e.g., "add-validation.feature.md --continue --human-in-the-loop") --- diff --git a/plugins/sdd/skills/plan/SKILL.md b/plugins/sdd/skills/plan/SKILL.md index bb003ef..9f8d659 100644 --- a/plugins/sdd/skills/plan/SKILL.md +++ b/plugins/sdd/skills/plan/SKILL.md @@ -1,5 +1,4 @@ --- -name: plan description: Refine, parallelize, and verify a draft task specification into a fully planned implementation-ready task argument-hint: Path to draft task file (e.g., ".specs/tasks/draft/add-validation.feature.md") [options] --- diff --git a/plugins/tdd/skills/fix-tests/SKILL.md b/plugins/tdd/skills/fix-tests/SKILL.md index f2dd69f..cac368a 100644 --- a/plugins/tdd/skills/fix-tests/SKILL.md +++ b/plugins/tdd/skills/fix-tests/SKILL.md @@ -1,5 +1,4 @@ --- -name: fix-tests description: Systematically fix all failing tests after business logic changes or refactoring argument-hint: what tests or modules to focus on --- diff --git a/plugins/tdd/skills/test-driven-development/SKILL.md b/plugins/tdd/skills/test-driven-development/SKILL.md index 7a8020f..37149dd 100644 --- a/plugins/tdd/skills/test-driven-development/SKILL.md +++ b/plugins/tdd/skills/test-driven-development/SKILL.md @@ -1,5 +1,4 @@ --- -name: test-driven-development description: Use when implementing any feature or bugfix, before writing implementation code - write the test first, watch it fail, write minimal code to pass; ensures tests actually verify behavior by requiring failure first --- diff --git a/plugins/tdd/skills/write-tests/SKILL.md b/plugins/tdd/skills/write-tests/SKILL.md index 8b15749..0150ab4 100644 --- a/plugins/tdd/skills/write-tests/SKILL.md +++ b/plugins/tdd/skills/write-tests/SKILL.md @@ -1,5 +1,4 @@ --- -name: write-tests description: Systematically add test coverage for all local code changes using specialized review and development agents. Add tests for uncommitted changes (including untracked files), or if everything is commited, then will cover latest commit. argument-hint: what tests or modules to focus on --- diff --git a/plugins/tech-stack/skills/add-typescript-best-practices/SKILL.md b/plugins/tech-stack/skills/add-typescript-best-practices/SKILL.md index c8b4142..f19a474 100644 --- a/plugins/tech-stack/skills/add-typescript-best-practices/SKILL.md +++ b/plugins/tech-stack/skills/add-typescript-best-practices/SKILL.md @@ -1,5 +1,4 @@ --- -name: add-typescript-best-practices description: Setup TypeScript best practices and code style rules in CLAUDE.md argument-hint: Optional argument which practices to add or avoid ---