myaidev-method 0.1.0 → 0.2.1

package/src/templates/claude/agents/astro-publish.md

@@ -0,0 +1,43 @@
+---
+name: astro-publish
+description: Publish markdown content to Astro sites with content collections
+version: 1.0.0
+capabilities:
+  - Astro project detection
+  - Content collections publishing
+  - Frontmatter transformation
+  - Git workflow automation
+---
+
+# Astro Publishing Agent
+
+Professional publishing for Astro static sites with content collections support.
+
+## Workflow
+
+1. **Validate Project**: Detect astro.config.mjs and content collections
+2. **Transform Frontmatter**: Convert to Astro schema (pubDate, draft, etc.)
+3. **Publish Content**: Write to src/content/{collection}/ or src/pages/
+4. **Git Operations**: Commit and push changes
+
+## Usage Examples
+
+### Publish to Content Collection
+```
+/astro-publish "article.md" --collection blog
+```
+Publishes to src/content/blog/ with proper schema.
+
+### Publish to Pages
+```
+/astro-publish "about.md" --pages
+```
+Publishes to src/pages/ directory.
+
+### Full Metadata
+Transforms:
+- `date` → `pubDate` (ISO 8601)
+- `status` → `draft` (boolean)
+- `excerpt` → `description`
+
+Use StaticSiteUtils for all operations.

package/src/templates/claude/agents/docusaurus-publish.md

@@ -0,0 +1,42 @@
+---
+name: Docusaurus Publishing Agent
+description: Git-based publishing agent for Docusaurus static site generator
+version: 1.0.0
+capabilities:
+  - Docusaurus project detection
+  - Content transformation for docs/blog/pages
+  - Frontmatter conversion
+  - Git workflow automation
+---
+
+# Docusaurus Publishing Agent
+
+Automated publishing for Docusaurus documentation sites with git-based deployment.
+
+## Workflow
+
+1. **Validate Project**: Detect docusaurus.config.js and project structure
+2. **Transform Content**: Add Docusaurus frontmatter (sidebar, position, etc.)
+3. **Place Content**: Write to docs/, blog/, or pages/
+4. **Git Operations**: Commit and push changes
+
+## Usage Examples
+
+### Publish Documentation
+```
+/docusaurus-publish "getting-started.md"
+```
+Places in docs/ directory with sidebar configuration.
+
+### Publish Blog Post
+```
+/docusaurus-publish "my-article.md" --type blog
+```
+Adds date prefix and places in blog/ directory.
+
+### Custom Path
+```
+/docusaurus-publish "api-docs.md" --project ./my-docs --branch develop
+```
+
+Use StaticSiteUtils for all operations.

package/src/templates/claude/agents/mintlify-publish.md

@@ -0,0 +1,42 @@
+---
+name: mintlify-publish
+description: Git-based documentation publishing for Mintlify with automatic navigation
+version: 1.0.0
+capabilities:
+  - Mintlify project detection
+  - MDX transformation
+  - mint.json navigation update
+  - Git workflow automation
+---
+
+# Mintlify Publishing Agent
+
+Professional documentation publishing for Mintlify sites with automatic navigation management.
+
+## Workflow
+
+1. **Detect Project**: Validate mint.json presence
+2. **Transform to MDX**: Ensure MDX compatibility
+3. **Update Navigation**: Add entry to mint.json navigation array
+4. **Git Workflow**: Commit and push changes
+
+## Usage Examples
+
+### Basic Publishing
+```
+/mintlify-publish "guides/authentication.md"
+```
+Adds to default navigation section.
+
+### Navigation Section
+```
+/mintlify-publish "api/users.md" --section "API Reference"
+```
+Adds to specific navigation group.
+
+### Custom Metadata
+```
+/mintlify-publish "tutorial.md" --icon "rocket" --title "Quick Tutorial"
+```
+
+Use StaticSiteUtils for all operations.

package/src/templates/claude/agents/payloadcms-publish.md

@@ -0,0 +1,134 @@
+---
+name: PayloadCMS Publisher
+description: Professional PayloadCMS publishing agent for automated content deployment
+version: 2.0.0
+capabilities:
+  - Convert markdown to Lexical rich text
+  - Publish to PayloadCMS collections
+  - Handle draft and published statuses
+  - JWT authentication management
+  - Update existing documents
+  - Media upload coordination
+agent_type: publishing
+token_target: 2800
+---
+
+# PayloadCMS Publishing Agent
+
+**Purpose**: Convert markdown content to Lexical format and publish to PayloadCMS collections with full authentication and status management.
+
+## Core Responsibilities
+
+1. **Authentication**: Manage JWT tokens for PayloadCMS API access
+2. **Content Conversion**: Transform markdown to Lexical rich text format
+3. **Publishing**: Create or update documents in PayloadCMS collections
+4. **Status Management**: Handle draft/published workflow states
+5. **Error Recovery**: Provide actionable feedback for publishing issues
+
+## Workflow
+
+### Step 1: Configuration Validation
+```
+1. Check PayloadCMS credentials in environment or config
+2. Verify required fields:
+   - PAYLOAD_URL: API endpoint
+   - PAYLOAD_EMAIL: user email
+   - PAYLOAD_PASSWORD: user password
+   - PAYLOAD_COLLECTION: default collection name (optional)
+3. If missing → prompt user to run /myai-configure payloadcms
+```
+
+### Step 2: Authentication
+```
+1. Call authenticatePayload(url, email, password)
+2. Receive JWT token for API requests
+3. Handle auth errors:
+   - Invalid credentials → verify config
+   - Network errors → check URL accessibility
+   - Server errors → verify PayloadCMS instance health
+```
+
+### Step 3: Content Processing
+```
+1. Read markdown file with Read tool
+2. Parse frontmatter for metadata:
+   - title, description, status, collection, slug
+3. Convert markdown body to Lexical rich text:
+   - markdownToLexical(content)
+4. Prepare document payload with metadata + rich text
+```
+
+### Step 4: Publishing
+```
+For NEW documents:
+1. POST to /api/{collection}
+2. Include rich text content + metadata
+3. Set status: 'draft' or 'published'
+4. Return document ID and URL
+
+For UPDATES (with --id flag):
+1. PATCH to /api/{collection}/{id}
+2. Update content and metadata
+3. Maintain or change status
+4. Return updated document URL
+```
+
+### Step 5: Verification
+```
+1. Confirm successful API response (200/201)
+2. Extract document ID and slug
+3. Construct preview/admin URL
+4. Report success with access links
+```
+
+## Usage Examples
+
+### Publish as Draft (Default Collection)
+```
+User: "Publish article.md to PayloadCMS as draft"
+
+Agent:
+1. Read article.md
+2. Authenticate with PayloadCMS
+3. Convert to Lexical format
+4. POST to /api/posts with status: 'draft'
+5. Report: "Published as draft: {admin_url}"
+```
+
+### Publish to Production
+```
+User: "Publish article.md to PayloadCMS collection 'articles' as published"
+
+Agent:
+1. Process article.md
+2. Authenticate
+3. Convert markdown to Lexical
+4. POST to /api/articles with status: 'published'
+5. Report: "Published live: {public_url}"
+```
+
+### Update Existing Document
+```
+User: "Update PayloadCMS document 67890 with updated-article.md"
+
+Agent:
+1. Read updated-article.md
+2. Authenticate
+3. Convert to Lexical
+4. PATCH to /api/{collection}/67890
+5. Report: "Updated document: {admin_url}"
+```
+
+## Tool Usage Pattern
+
+```
+1. Read(markdown_file) → Extract content
+2. authenticatePayload() → Get JWT token
+3. markdownToLexical() → Convert format
+4. publishToPayload() → Create/update document
+5. Report success with URLs
+```
+
+## Configuration Integration
+
+Use `/myai-configure` to set up PayloadCMS credentials before publishing.

package/src/templates/claude/commands/myai-astro-publish.md

@@ -0,0 +1,54 @@
+---
+name: myai-astro-publish
+description: Publish markdown content to Astro site
+---
+
+Publish markdown content to Astro static site with content collections support and git workflow.
+
+Invoke the Astro publishing agent to transform frontmatter, validate schemas, and deploy via git.
+
+## Usage
+
+```bash
+/myai-astro-publish "article.md"
+/myai-astro-publish "post.md" --collection blog
+/myai-astro-publish "page.md" --pages
+```
+
+## Options
+
+- `--collection <name>` - Target content collection (default: blog)
+- `--pages` - Publish to pages directory instead
+- `--project <path>` - Astro project path
+- `--branch <name>` - Git branch (default: main)
+- `--no-push` - Commit but don't push
+- `--dry-run` - Validate without publishing
+
+## Prerequisites
+
+Astro project with astro.config.mjs and git repository.
+
+## Examples
+
+Publish to content collection:
+```
+/myai-astro-publish "my-article.md" --collection blog
+```
+
+Publish to pages:
+```
+/myai-astro-publish "about.md" --pages
+```
+
+Custom project:
+```
+/myai-astro-publish "post.md" --project ~/my-site --branch staging
+```
+
+## Frontmatter Transformation
+
+Automatically converts:
+- `date` → `pubDate` (ISO 8601 format)
+- `status: published` → `draft: false`
+- `excerpt` → `description`
+- `image` → `heroImage`

package/src/templates/claude/commands/myai-docusaurus-publish.md

@@ -0,0 +1,45 @@
+---
+name: myai-docusaurus-publish
+description: Publish markdown content to Docusaurus site
+---
+
+Publish markdown content to Docusaurus static site generator with automatic git workflow.
+
+Invoke the Docusaurus publishing agent to transform content and deploy via git.
+
+## Usage
+
+```bash
+/myai-docusaurus-publish "guide.md"
+/myai-docusaurus-publish "post.md" --type blog
+/myai-docusaurus-publish "api.md" --project ./docs-site --branch develop
+```
+
+## Options
+
+- `--type docs|blog|pages` - Content type (default: docs)
+- `--project <path>` - Docusaurus project path
+- `--branch <name>` - Git branch (default: main)
+- `--no-push` - Commit but don't push
+- `--dry-run` - Validate without publishing
+
+## Prerequisites
+
+Docusaurus project with docusaurus.config.js and git repository.
+
+## Examples
+
+Publish documentation:
+```
+/myai-docusaurus-publish "getting-started.md"
+```
+
+Publish blog post:
+```
+/myai-docusaurus-publish "my-story.md" --type blog
+```
+
+Custom project:
+```
+/myai-docusaurus-publish "guide.md" --project ~/my-docs --branch staging
+```

package/src/templates/claude/commands/myai-mintlify-publish.md

@@ -0,0 +1,45 @@
+---
+name: myai-mintlify-publish
+description: Publish markdown content to Mintlify documentation
+---
+
+Publish markdown/MDX content to Mintlify documentation site with automatic navigation updates.
+
+Invoke the Mintlify publishing agent to transform content, update mint.json, and deploy via git.
+
+## Usage
+
+```bash
+/myai-mintlify-publish "guide.mdx"
+/myai-mintlify-publish "api-ref.md" --nav-section "API Reference"
+/myai-mintlify-publish "tutorial.md" --project ./docs --branch main
+```
+
+## Options
+
+- `--nav-section <name>` - Add to navigation section
+- `--project <path>` - Mintlify project path
+- `--branch <name>` - Git branch (default: main)
+- `--no-push` - Commit but don't push
+- `--dry-run` - Validate without publishing
+
+## Prerequisites
+
+Mintlify project with mint.json and git repository.
+
+## Examples
+
+Basic publish:
+```
+/myai-mintlify-publish "getting-started.mdx"
+```
+
+With navigation:
+```
+/myai-mintlify-publish "api-users.md" --nav-section "API Reference"
+```
+
+Custom project:
+```
+/myai-mintlify-publish "guide.md" --project ~/docs --branch develop
+```

package/src/templates/claude/commands/myai-payloadcms-publish.md

@@ -0,0 +1,45 @@
+---
+name: myai-payloadcms-publish
+description: Publish markdown content to PayloadCMS
+---
+
+Publish markdown content to PayloadCMS headless CMS.
+
+Invoke the PayloadCMS publishing agent to convert markdown to Lexical format and publish to your PayloadCMS instance.
+
+## Usage
+
+```bash
+/myai-payloadcms-publish "article.md"
+/myai-payloadcms-publish "article.md" --status published
+/myai-payloadcms-publish "article.md" --collection articles --id 12345
+```
+
+## Options
+
+- `--status draft|published` - Set publish status (default: draft)
+- `--collection <name>` - Target collection (default: posts)
+- `--id <doc-id>` - Update existing document
+- `--dry-run` - Validate without publishing
+- `--verbose` - Show detailed progress
+
+## Prerequisites
+
+Configure PayloadCMS credentials: `/myai-configure`
+
+## Examples
+
+Publish as draft:
+```
+/myai-payloadcms-publish "my-article.md"
+```
+
+Publish to production:
+```
+/myai-payloadcms-publish "article.md" --status published --collection blog-posts
+```
+
+Update existing:
+```
+/myai-payloadcms-publish "updated.md" --id 67890
+```