@polygraph/claude-plugin - npm Package Compare versions

Comparing version 0.4.22 to 0.4.23

.claude-plugin/plugin.json

 {
   "name": "polygraph",
-  "version": "0.4.22",
+  "version": "0.4.23",
   "description": "AI agent skills and subagents for Polygraph multi-repo coordination",
@@ -5,0 +5,0 @@ "author": {

package.json

 {
   "name": "@polygraph/claude-plugin",
-  "version": "0.4.22",
+  "version": "0.4.23",
   "description": "AI agent skills and subagents for Polygraph multi-repo coordination",
@@ -5,0 +5,0 @@ "license": "UNLICENSED",

skills/polygraph/SKILL.md

@@ -27,3 +27,3 @@ ---
 | `stop_agent` | — | Cancel an in-progress child. Output: `{ taskId, state: 'cancelled', sessionPreserved: true, output, message }`. Because `sessionPreserved: true`, the preserved agent session can be restored later for context, but resume must wait for explicit user instructions before making changes. |
-| `push_branch` | — | Push a local git branch to the remote repository |
+| `push_branch` | — | Push a local git branch to the remote repository. Requires a session description. |
 | `create_pr` | — | Create draft PRs with session metadata linking related PRs |
@@ -71,5 +71,5 @@ | `show_session` | `polygraph session show <id> [--details]` | Query status of the current session. Use details when session summary, repo IDs, PR URLs, and PR descriptions are needed. |
 5. **Stop child agents** (if needed) - Use `stop_agent` to cancel an in-progress child agent. The underlying agent session is preserved for later read-only context restoration; after a resume, wait for explicit user instructions before making changes.
-6. **Push branches** - Use `push_branch` after making commits.
-7. **Update session description** (optional) - Use `update_session_description` to set the current session description from a progress summary or user-provided text that follows the Session Description Policy. This is independent of PR creation or mark-ready.
-8. **Create draft PRs** - Use `create_pr` to create linked draft PRs. Pass `description` only when you are already creating PRs and can provide session context that follows the Session Description Policy.
+6. **Push branches** - Use `push_branch` after making commits. A required `description` must follow the Session Description Policy.
+7. **Update session description** - Use `update_session_description` to update the session description; must follow the Session Description Policy. Independent of PR creation or mark-ready.
+8. **Create draft PRs** - Use `create_pr` to create linked draft PRs. Always pass `description` following the Session Description Policy.
 9. **Associate existing PRs** (optional) - Use `associate_pr` to link PRs created outside Polygraph.
@@ -285,2 +285,3 @@ 10. **Query PR status** - Use `show_session` to check progress.
 - `branch` (required): Branch name to push to remote
+- `description` (required): A session description is required. Must follow the Session Description Policy.
 
@@ -299,6 +300,4 @@ ```
 
-The same policy applies anywhere a Polygraph tool accepts `description`, including `create_pr`, `associate_pr`, and `update_session_description`.
+`description` is required for `push_branch`, `create_pr`, `associate_pr`, and `update_session_description`. (`mark_pr_ready` does not take a description.) Use the canonical structured format:
 
-If you pass `description`, use the canonical structured format:
-
 ```text
@@ -336,3 +335,3 @@ Goal: <what the session is trying to accomplish>
   - `targetRepository` (optional): Target GitHub repository for fork PR creation or registration, as `owner/repo`. Omit for same-repository PRs.
-- `description` (optional): Optional. If supplied, it must follow the Session Description Policy.
+- `description` (required): Must follow the Session Description Policy.
 
@@ -523,3 +522,3 @@ **PR title format (applies to parent and child agents):**
 - `repo` (optional): Source repository for branch-based association. Required when using `branch` in a multi-repo session.
-- `description` (optional): Optional. If supplied, it must follow the Session Description Policy.
+- `description` (required): Must follow the Session Description Policy.
 
@@ -681,2 +680,3 @@ ```
 1. **Keep PRs as drafts** until all repos are ready
+1. **Always pass `description`** when calling `create_pr`, `associate_pr`, or `update_session_description` — it is required and must follow the Session Description Policy
 1. **Test integration** before marking PRs ready
@@ -683,0 +683,0 @@ 1. **Coordinate merge order** if there are deployment dependencies

No alert changes

Improved metrics

Total package byte prevSize

90708

0.19%

No dependency changes