myaidev-method 0.0.8 → 0.2.0

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-coolify-deploy.md

@@ -0,0 +1,172 @@
+---
+name: myai-coolify-deploy
+description: Deploy applications to Coolify - infrastructure management and deployment automation
+tools: Read, Write, Edit, Bash, Task, Grep, Glob
+---
+
+Launch the Coolify deployment specialist agent for application deployment and infrastructure management.
+
+## Task
+Execute Coolify deployment operations based on the specified action: $ARGUMENTS
+
+## Available Operations
+
+### Quick Deploy Commands
+- `deploy <app-name>` - Deploy application by name or from current directory
+- `status` - Check Coolify system status and connectivity
+- `list <resource-type>` - List servers, projects, applications, databases
+- `logs <app-name>` - View application deployment logs
+- `restart <app-name>` - Restart an application
+- `env <app-name>` - Manage environment variables
+
+### Detailed Deploy Commands
+- `deploy --repo <url> --name <name> --server <uuid>` - Deploy with specific configuration
+- `deploy --dockerfile --port 8080 --domain app.example.com` - Deploy Docker app
+- `deploy-database --type postgresql --name mydb` - Deploy database
+- `deploy-stack --config stack.json` - Deploy multi-component stack
+
+## Usage Examples
+
+### Quick Deployments
+```
+/myai-coolify-deploy status
+/myai-coolify-deploy list servers
+/myai-coolify-deploy deploy my-nextjs-app
+/myai-coolify-deploy logs my-app
+```
+
+### Advanced Deployments
+```
+/myai-coolify-deploy deploy --repo https://github.com/user/app --name api-server
+/myai-coolify-deploy deploy --dockerfile --port 3000 --domain api.example.com
+/myai-coolify-deploy deploy-database --type postgresql --version 16
+```
+
+### Environment Management
+```
+/myai-coolify-deploy env my-app --set API_KEY=secret123
+/myai-coolify-deploy env my-app --file .env.production
+```
+
+### Monitoring & Management
+```
+/myai-coolify-deploy list applications --detailed
+/myai-coolify-deploy restart my-app
+/myai-coolify-deploy logs my-app --follow
+```
+
+## Process Flow
+
+1. **Parse Arguments**
+   - Extract operation type from $ARGUMENTS
+   - Identify deployment target and configuration
+   - Validate required parameters
+
+2. **Verify Connectivity**
+   - Check Coolify API accessibility
+   - Validate credentials from `.env`
+   - Confirm target server availability
+
+3. **Execute Operation**
+   - Load coolify-deploy agent
+   - Run appropriate deployment script
+   - Monitor progress and handle errors
+
+4. **Report Results**
+   - Provide deployment URL and status
+   - Show relevant logs if deployment fails
+   - Suggest next steps or troubleshooting
+
+## Agent Integration
+
+This command loads the `coolify-deploy` agent which is optimized for:
+- **Lightweight operations** - Direct script execution for speed
+- **Extended thinking** - Complex deployment planning with "think" triggers
+- **Subagent delegation** - Parallel deployments for multi-component apps
+- **Security** - Permission-scoped operations with credential safety
+
+## Required Environment Variables
+
+```bash
+COOLIFY_URL=https://coolify.myai1.ai
+COOLIFY_API_KEY=your_api_key_here
+```
+
+Create API token in Coolify: Settings → Keys & Tokens → Create API Token
+
+## Examples with Context
+
+### Example 1: Deploy Current Directory
+```bash
+# User has Next.js app in current directory
+/myai-coolify-deploy deploy .
+
+# Agent workflow:
+# 1. Detects Next.js app (reads package.json)
+# 2. Lists available servers
+# 3. Prompts for server selection
+# 4. Deploys with Nixpacks
+# 5. Provides deployment URL
+```
+
+### Example 2: Deploy with GitHub Repo
+```bash
+/myai-coolify-deploy deploy --repo https://github.com/user/api --name api-prod
+
+# Agent workflow:
+# 1. Validates repository accessibility
+# 2. Selects optimal server
+# 3. Creates Coolify application
+# 4. Triggers deployment
+# 5. Monitors until complete
+```
+
+### Example 3: Deploy Full Stack
+```bash
+/myai-coolify-deploy deploy-stack
+
+# Agent workflow:
+# 1. Reads stack configuration (stack.json or prompts)
+# 2. Uses Task tool to parallelize:
+#    - Deploy PostgreSQL database
+#    - Deploy Redis cache
+#    - Deploy API backend
+#    - Deploy frontend
+# 3. Configures connections between components
+# 4. Runs health checks
+# 5. Reports complete stack status
+```
+
+## Safety Features
+
+- **Confirmation gates** - Prompts for production deployments
+- **Rollback support** - Can revert failed deployments
+- **Credential safety** - API keys never logged or exposed
+- **Resource validation** - Verifies server capacity before deployment
+- **Error recovery** - Auto-retry with exponential backoff
+
+## Output Format
+
+The agent provides structured output:
+- **Status updates**: Real-time deployment progress
+- **Success confirmation**: Deployment URL and access info
+- **Error details**: Clear error messages with troubleshooting steps
+- **Next actions**: Suggested follow-up commands
+
+## Integration with Other Agents
+
+Works seamlessly with:
+- **content-writer** - Deploy WordPress for published content
+- **wordpress-admin** - Manage deployed WordPress instances
+- Custom agents for CI/CD pipeline integration
+
+## Performance Notes
+
+- Typical deployment: 2-5 minutes (depends on build complexity)
+- Script execution: <1 second for status/list operations
+- Agent initialization: <3k tokens (lightweight pattern)
+- Extended thinking available for complex decisions
+
+---
+
+Always run `/myai-coolify-deploy status` first to verify connectivity before deployment operations.

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
+```