From 41b62a586af19d9c239d80a1bbd7384ce4194af9 Mon Sep 17 00:00:00 2001
From: Ladislav Martincik <ladislav.martincik@gmail.com>
Date: Mon, 10 Nov 2025 15:47:49 +0100
Subject: [PATCH] docs(create-pr): simplify and clarify command instructions

Streamlines the /create-pr workflow by removing redundant steps and clarifying the PR body structure. Updates instructions to focus on essential operations and adds specific sections for "Review Focus" and "Testing Notes" to improve PR quality.
---
 .claude-plugin/plugin.json |  2 +-
 commands/create-pr.md      | 16 +++++++---------
 package.json               |  2 +-
 scripts/validate-plugin.ts |  4 +---
 4 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 72d53be..e9bdc3d 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "github",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "GitHub CI/CD automation plugin for auto-detecting, analyzing, and fixing CI/CD failures on any branch",
   "author": {
     "name": "Ladislav Martincik",
diff --git a/commands/create-pr.md b/commands/create-pr.md
index b280ed8..35a0668 100644
--- a/commands/create-pr.md
+++ b/commands/create-pr.md
@@ -21,20 +21,18 @@ plan_file: $2
     - `bug: #456 - Fix login validation error`
     - `chore: #789 - Update dependencies`
 - The PR body should include:
-  - A summary section with the issue context
+  - A summary section explaining the **why** and context
   - Link to the implementation plan file
   - Reference to the issue (Closes #<issue_number>)
-  - A checklist of what was done
-  - A summary of key changes made
+  - "Review Focus" section highlighting what reviewers should pay attention to, potential gotchas, or architectural decisions
+  - "Testing Notes" section (only if there's something non-obvious beyond CI checks)
 
 ## Run
 
-1. Run `git diff origin/main...HEAD --stat` to see a summary of changed files
-2. Run `git log origin/main..HEAD --oneline` to see the commits that will be included
-3. Run `git diff origin/main...HEAD --name-only` to get a list of changed files
-4. Run `git push -u origin <branch_name>` to push the branch
-5. Run `gh pr create --title "<pr_title>" --body "<pr_body>" --base main` to create the PR
-6. Capture the PR URL from the output
+1. Run `git log origin/main..HEAD --oneline` to understand the commits being included
+2. Run `git push -u origin <branch_name>` to push the branch
+3. Run `gh pr create --title "<pr_title>" --body "<pr_body>" --base main` to create the PR
+4. Capture the PR URL from the output
 
 ## Report
 
diff --git a/package.json b/package.json
index 0c03762..c5847be 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "github-plugin",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "GitHub CI/CD automation plugin for Claude Code",
   "private": true,
   "type": "module",
diff --git a/scripts/validate-plugin.ts b/scripts/validate-plugin.ts
index 8d2861b..6e3d189 100644
--- a/scripts/validate-plugin.ts
+++ b/scripts/validate-plugin.ts
@@ -20,9 +20,7 @@ const PluginManifestSchema = z.object({
   commands: z.record(z.object({
     description: z.string().optional(),
   })).optional(),
-  agents: z.record(z.object({
-    description: z.string().optional(),
-  })).optional(),
+  agents: z.array(z.string()).optional(),
   hooks: z.union([z.string(), z.record(z.any())]).optional(),
   mcpServers: z.union([z.string(), z.record(z.any())]).optional(),
 });