prpm 1.0.3 → 1.1.0

package/dist/schemas/agents-md.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/agents-md.schema.json",
+  "title": "agents.md Format",
+  "description": "JSON Schema for agents.md format - plain markdown project-specific AI instructions (NO frontmatter)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain markdown content with project-specific instructions, architecture notes, conventions, etc. No frontmatter allowed."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# Backend Guidelines\n\n## Architecture\n\nWe use a clean architecture pattern.\n\n## Database\n\nPostgreSQL with Prisma ORM.\n\n## Coding Standards\n\n- Use TypeScript strict mode\n- Write unit tests for all services"
+    },
+    {
+      "content": "# Project Context\n\nThis is a React + TypeScript web application.\n\n## Stack\n\n- React 18\n- TypeScript 5\n- Vite\n- Tailwind CSS"
+    }
+  ]
+}

package/dist/schemas/canonical.schema.json

@@ -0,0 +1,435 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/canonical.schema.json",
+  "title": "PRPM Canonical Package Format",
+  "description": "Universal intermediate format for AI prompt packages that can be converted to any editor-specific format",
+  "type": "object",
+  "required": ["id", "version", "name", "description", "author", "tags", "format", "subtype", "content"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for the package"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g., '1.0.0')"
+    },
+    "name": {
+      "type": "string",
+      "description": "Package identifier/slug (used in frontmatter)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description"
+    },
+    "author": {
+      "type": "string",
+      "description": "Package author"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Categorization tags"
+    },
+    "format": {
+      "type": "string",
+      "enum": ["cursor", "claude", "continue", "windsurf", "copilot", "kiro", "agents.md", "generic", "mcp"],
+      "description": "Source format this was parsed from"
+    },
+    "subtype": {
+      "type": "string",
+      "enum": ["rule", "agent", "skill", "slash-command", "prompt", "workflow", "tool", "template", "collection", "chatmode", "hook"],
+      "description": "Subtype classification"
+    },
+    "content": {
+      "type": "object",
+      "required": ["format", "version", "sections"],
+      "properties": {
+        "format": {
+          "type": "string",
+          "const": "canonical"
+        },
+        "version": {
+          "type": "string",
+          "const": "1.0"
+        },
+        "sections": {
+          "type": "array",
+          "description": "Content sections in semantic format",
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/MetadataSection"
+              },
+              {
+                "$ref": "#/definitions/InstructionsSection"
+              },
+              {
+                "$ref": "#/definitions/RulesSection"
+              },
+              {
+                "$ref": "#/definitions/ExamplesSection"
+              },
+              {
+                "$ref": "#/definitions/ToolsSection"
+              },
+              {
+                "$ref": "#/definitions/PersonaSection"
+              },
+              {
+                "$ref": "#/definitions/ContextSection"
+              },
+              {
+                "$ref": "#/definitions/CustomSection"
+              }
+            ]
+          }
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Extracted metadata for easier access",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Display title (from H1 or frontmatter)"
+        },
+        "description": {
+          "type": "string"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Emoji icon"
+        },
+        "version": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "globs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "alwaysApply": {
+          "type": "boolean"
+        },
+        "claudeAgent": {
+          "type": "object",
+          "properties": {
+            "model": {
+              "type": "string",
+              "enum": ["sonnet", "opus", "haiku", "inherit"]
+            }
+          }
+        },
+        "copilotConfig": {
+          "type": "object",
+          "properties": {
+            "instructionName": {
+              "type": "string"
+            },
+            "applyTo": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          }
+        },
+        "kiroConfig": {
+          "type": "object",
+          "properties": {
+            "filename": {
+              "type": "string"
+            },
+            "inclusion": {
+              "type": "string",
+              "enum": ["always", "fileMatch", "manual"]
+            },
+            "fileMatchPattern": {
+              "type": "string"
+            },
+            "domain": {
+              "type": "string"
+            },
+            "foundationalType": {
+              "type": "string",
+              "enum": ["product", "tech", "structure"]
+            }
+          }
+        },
+        "agentsMdConfig": {
+          "type": "object",
+          "properties": {
+            "project": {
+              "type": "string"
+            },
+            "scope": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "sourceFormat": {
+      "type": "string",
+      "enum": ["cursor", "claude", "continue", "windsurf", "copilot", "kiro", "agents.md", "generic"],
+      "description": "Original format this was parsed from"
+    },
+    "sourceUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Source URL if imported"
+    },
+    "official": {
+      "type": "boolean",
+      "description": "Official package from cursor.directory, claude.ai, etc."
+    },
+    "verified": {
+      "type": "boolean",
+      "description": "Verified by PRPM team"
+    },
+    "karenScore": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Quality score from Karen"
+    }
+  },
+  "definitions": {
+    "MetadataSection": {
+      "type": "object",
+      "required": ["type", "data"],
+      "properties": {
+        "type": {
+          "const": "metadata"
+        },
+        "data": {
+          "type": "object",
+          "required": ["title", "description"],
+          "properties": {
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "icon": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "author": {
+              "type": "string"
+            },
+            "claudeAgent": {
+              "type": "object",
+              "properties": {
+                "model": {
+                  "type": "string",
+                  "enum": ["sonnet", "opus", "haiku", "inherit"]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "InstructionsSection": {
+      "type": "object",
+      "required": ["type", "title", "content"],
+      "properties": {
+        "type": {
+          "const": "instructions"
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["high", "medium", "low"]
+        }
+      }
+    },
+    "RulesSection": {
+      "type": "object",
+      "required": ["type", "title", "items"],
+      "properties": {
+        "type": {
+          "const": "rules"
+        },
+        "title": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["content"],
+            "properties": {
+              "content": {
+                "type": "string"
+              },
+              "rationale": {
+                "type": "string"
+              },
+              "examples": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "ordered": {
+          "type": "boolean",
+          "description": "Whether rules should be numbered"
+        }
+      }
+    },
+    "ExamplesSection": {
+      "type": "object",
+      "required": ["type", "title", "examples"],
+      "properties": {
+        "type": {
+          "const": "examples"
+        },
+        "title": {
+          "type": "string"
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["description", "code"],
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "code": {
+                "type": "string"
+              },
+              "language": {
+                "type": "string"
+              },
+              "good": {
+                "type": "boolean",
+                "description": "Is this a good or bad example?"
+              }
+            }
+          }
+        }
+      }
+    },
+    "ToolsSection": {
+      "type": "object",
+      "required": ["type", "tools"],
+      "properties": {
+        "type": {
+          "const": "tools"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "PersonaSection": {
+      "type": "object",
+      "required": ["type", "data"],
+      "properties": {
+        "type": {
+          "const": "persona"
+        },
+        "data": {
+          "type": "object",
+          "required": ["role"],
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "role": {
+              "type": "string"
+            },
+            "icon": {
+              "type": "string"
+            },
+            "style": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "expertise": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "ContextSection": {
+      "type": "object",
+      "required": ["type", "title", "content"],
+      "properties": {
+        "type": {
+          "const": "context"
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        }
+      }
+    },
+    "CustomSection": {
+      "type": "object",
+      "required": ["type", "content"],
+      "properties": {
+        "type": {
+          "const": "custom"
+        },
+        "editorType": {
+          "type": "string",
+          "enum": ["cursor", "claude", "continue", "windsurf", "copilot", "kiro"]
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "metadata": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/dist/schemas/claude-agent.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/claude-agent.schema.json",
+  "title": "Claude Agent Format",
+  "description": "JSON Schema for Claude Code Agents - long-running assistants with tool access",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Agent identifier (lowercase letters, numbers, hyphens only)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Brief overview of agent's functionality and use cases"
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Comma-separated list of available tools (e.g., 'Read, Write, Bash, WebSearch')"
+        },
+        "model": {
+          "type": "string",
+          "enum": ["sonnet", "opus", "haiku", "inherit"],
+          "description": "Claude model to use for this agent"
+        },
+        "agentType": {
+          "type": "string",
+          "const": "agent",
+          "description": "Explicit marker for round-trip conversion"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with H1 title (can include emoji icon), persona, instructions, and examples"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-reviewer",
+        "description": "Reviews code for best practices and potential issues",
+        "allowed-tools": "Read, Grep, Bash",
+        "model": "sonnet"
+      },
+      "content": "# 🔍 Code Reviewer\n\nYou are an expert code reviewer with deep knowledge of software engineering principles.\n\n## Instructions\n\n- Check for code smells and anti-patterns\n- Verify test coverage"
+    }
+  ]
+}

package/dist/schemas/claude-hook.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/claude-hook.schema.json",
+  "title": "Claude Hook Format",
+  "description": "JSON Schema for Claude Code Hooks - executable code triggered by events",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Hook identifier (lowercase letters, numbers, hyphens only)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Brief overview of what the hook does"
+        },
+        "event": {
+          "type": "string",
+          "enum": [
+            "PreToolUse",
+            "PostToolUse",
+            "UserPromptSubmit",
+            "Notification",
+            "Stop",
+            "SubagentStop",
+            "PreCompact",
+            "SessionStart",
+            "SessionEnd"
+          ],
+          "description": "Event that triggers this hook"
+        },
+        "language": {
+          "type": "string",
+          "enum": ["bash", "typescript", "javascript", "python", "binary"],
+          "description": "Programming language of the hook"
+        },
+        "hookType": {
+          "type": "string",
+          "const": "hook",
+          "description": "Explicit marker for round-trip conversion"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown documentation with hook source code in code blocks"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "session-logger",
+        "description": "Logs session start/end times for tracking",
+        "event": "SessionStart",
+        "language": "bash"
+      },
+      "content": "# Session Logger Hook\n\nLogs Claude Code session activity for tracking and debugging.\n\n## Source Code\n\n```bash\n#!/bin/bash\necho \"Session started at $(date)\" >> ~/.claude/session.log\n```"
+    }
+  ]
+}

package/dist/schemas/claude-skill.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://prpm.dev/schemas/claude-skill.schema.json",
+  "title": "Claude Skill Format",
+  "description": "JSON Schema for Claude Code Skills - reusable patterns invoked during conversation",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Skill identifier (lowercase letters, numbers, hyphens only)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Brief overview of functionality and when to use it"
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Comma-separated list of allowed tools (e.g., 'Read, Grep, Glob')"
+        },
+        "skillType": {
+          "type": "string",
+          "const": "skill",
+          "description": "Explicit marker for round-trip conversion"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with instructions and examples"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "refactor-helper",
+        "description": "Assists with code refactoring while maintaining functionality",
+        "allowed-tools": "Read, Edit, Grep"
+      },
+      "content": "# Refactor Helper Skill\n\nHelps refactor code while maintaining functionality.\n\n## Guidelines\n\n- Preserve existing behavior\n- Improve code structure and readability"
+    }
+  ]
+}