myaidev-method 0.2.23 → 0.2.24

package/src/templates/diagrams/flowchart.d2

@@ -0,0 +1,42 @@
+# Flowchart Template
+# Variables: {{title}}, {{direction}}, {{nodes}}, {{edges}}
+# Shapes: rectangle, diamond (decision), oval, parallelogram, cylinder
+
+direction: {{direction || 'down'}}
+
+# Title
+{{#title}}
+title: {{title}} {
+  near: top-center
+  shape: text
+  style: {
+    font-size: 24
+    bold: true
+  }
+}
+{{/title}}
+
+# Node definitions
+{{#nodes}}
+{{id}}: {{label}} {
+  shape: {{shape || 'rectangle'}}
+  {{#style}}
+  style: {
+    {{#fill}}fill: "{{fill}}"{{/fill}}
+    {{#stroke}}stroke: "{{stroke}}"{{/stroke}}
+    {{#fontColor}}font-color: "{{fontColor}}"{{/fontColor}}
+  }
+  {{/style}}
+}
+{{/nodes}}
+
+# Edges/Connections
+{{#edges}}
+{{from}} -> {{to}}{{#label}}: {{label}}{{/label}} {
+  {{#style}}
+  style: {
+    {{#stroke}}stroke: "{{stroke}}"{{/stroke}}
+  }
+  {{/style}}
+}
+{{/edges}}

package/src/templates/diagrams/sequence.d2

@@ -0,0 +1,47 @@
+# Sequence Diagram Template
+# Variables: {{title}}, {{actors}}, {{messages}}
+
+shape: sequence_diagram
+
+# Title
+{{#title}}
+title: {{title}} {
+  near: top-center
+  shape: text
+  style: {
+    font-size: 24
+    bold: true
+  }
+}
+{{/title}}
+
+# Actor definitions
+{{#actors}}
+{{id}}: {{label}} {
+  {{#shape}}shape: {{shape}}{{/shape}}
+  {{#style}}
+  style: {
+    {{#fill}}fill: "{{fill}}"{{/fill}}
+  }
+  {{/style}}
+}
+{{/actors}}
+
+# Messages/Interactions
+{{#messages}}
+{{from}} -> {{to}}: {{label}} {
+  {{#style}}
+  style: {
+    {{#stroke}}stroke: "{{stroke}}"{{/stroke}}
+    {{#strokeDash}}stroke-dash: {{strokeDash}}{{/strokeDash}}
+  }
+  {{/style}}
+}
+{{#response}}
+{{to}} -> {{from}}: {{response}} {
+  style: {
+    stroke-dash: 3
+  }
+}
+{{/response}}
+{{/messages}}

package/src/templates/docs/content-creation-guide.md

@@ -0,0 +1,164 @@
+# Content Creation Guide
+
+A comprehensive guide to creating SEO-optimized content with the MyAIDev Method.
+
+## Overview
+
+The MyAIDev Method content creation workflow helps you produce high-quality, SEO-optimized content efficiently. This guide covers the entire process from topic selection to publication.
+
+## Getting Started
+
+### Prerequisites
+
+- MyAIDev Method installed (`npx myaidev-method init --claude`)
+- Content workflow enabled (`npx myaidev-method content --claude`)
+- (Optional) WordPress credentials configured for publishing
+
+### Quick Start
+
+1. **Generate content specification:**
+   ```bash
+   /myai-content-writer "Your Topic Here" --type blog-post
+   ```
+
+2. **Review and edit the generated content**
+
+3. **Verify content quality:**
+   ```bash
+   /myai-coordinate-content ./content/
+   ```
+
+4. **Publish to WordPress:**
+   ```bash
+   /myai-wordpress-publish ./content/your-article.md
+   ```
+
+## Content Types
+
+### Blog Post
+- Standard article format
+- 1500+ words recommended
+- Sections: Introduction, Main Content, Conclusion, Call-to-Action
+
+### Tutorial
+- Step-by-step instructional content
+- 2000+ words recommended
+- Sections: Overview, Prerequisites, Steps, Troubleshooting, Conclusion
+
+### How-To Guide
+- Problem-solving focused
+- 1200+ words recommended
+- Sections: Introduction, Requirements, Step-by-Step, Tips, Summary
+
+### Listicle
+- List-based article
+- 1800+ words recommended
+- Sections: Introduction, List Items, Summary
+
+### Product Review
+- Evaluation content
+- 1500+ words recommended
+- Sections: Overview, Features, Pros/Cons, Verdict, Alternatives
+
+### Comparison
+- Side-by-side analysis
+- 2500+ words recommended
+- Sections: Introduction, Criteria, Comparison Table, Detailed Analysis, Recommendation
+
+## Writing Tones
+
+| Tone | Description | Best For |
+|------|-------------|----------|
+| Professional | Formal vocabulary, no contractions | B2B, corporate content |
+| Conversational | Accessible, uses contractions | B2C, lifestyle content |
+| Technical | Specialized vocabulary | Developer docs, specs |
+| Casual | Informal, friendly | Social media, blogs |
+| Authoritative | Expert, confident | Thought leadership |
+
+## SEO Best Practices
+
+### Title Optimization
+- Keep titles between 30-60 characters
+- Include primary keyword near the beginning
+- Use power words (Ultimate, Complete, Essential, Proven)
+
+### Meta Description
+- 120-160 characters
+- Include primary keyword
+- Compelling call-to-action
+
+### Content Structure
+- Use H2 and H3 headings strategically
+- Include keywords in at least one heading
+- Break up text with bullet points and numbered lists
+
+### Keyword Usage
+- Target 0.5-2.5% keyword density
+- Include primary keyword in first paragraph
+- Use keyword variations naturally throughout
+
+## Content Verification
+
+The content verification process checks:
+
+1. **Knowledge Redundancy** - Is the content unique?
+2. **AI Detection** - Does it read naturally?
+3. **Quality Assessment** - Structure, depth, accuracy
+
+### Redundancy Scores
+
+| Score | Meaning | Action |
+|-------|---------|--------|
+| High | Very similar to existing content | Rewrite substantially |
+| Medium | Some overlap with existing content | Add unique insights |
+| Low | Mostly original | Minor tweaks |
+| Minimal | Highly original | Ready to publish |
+
+## Workflow Integration
+
+### Standard Workflow
+
+```
+1. Topic Research → Content Specification
+2. Content Generation → Draft
+3. Content Verification → Quality Check
+4. Revision (if needed) → Final Draft
+5. Publishing → Live Content
+```
+
+### Batch Processing
+
+For multiple articles:
+
+```bash
+# Verify all content in directory
+/myai-coordinate-content ./content-queue/ --dry-run
+
+# Publish approved content
+/myai-coordinate-content ./content-queue/ --force
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**Content too short:**
+- Expand sections with more detail
+- Add examples and case studies
+- Include FAQs section
+
+**Low SEO score:**
+- Check keyword placement
+- Add more headings
+- Include internal/external links
+
+**High redundancy:**
+- Add unique perspective or data
+- Include personal experiences
+- Reference recent developments
+
+## Related Documentation
+
+- [WordPress Publishing Guide](wordpress-publishing-guide.md)
+- [Visual Generation Guide](visual-generation-guide.md)
+- [Deployment Guide](deployment-guide.md)

package/src/templates/docs/deployment-guide.md

@@ -0,0 +1,336 @@
+# Deployment Guide
+
+A guide to deploying and managing MyAIDev Method workflows in various environments.
+
+## Overview
+
+This guide covers installing, configuring, and maintaining MyAIDev Method in development and production environments.
+
+## Installation Methods
+
+### Quick Install (Recommended)
+
+```bash
+# Install and initialize in one step
+npx myaidev-method@latest init --claude
+
+# Add specific workflow
+npx myaidev-method@latest content --claude
+```
+
+### Global Install
+
+```bash
+# Install globally
+npm install -g myaidev-method
+
+# Initialize project
+myaidev-method init --claude
+```
+
+### Project Dependency
+
+```bash
+# Add to project
+npm install myaidev-method
+
+# Run via npx
+npx myaidev-method init --claude
+```
+
+## Workflow Installation
+
+### Available Workflows
+
+| Workflow | Purpose | Dependencies |
+|----------|---------|--------------|
+| `core` | Base configuration | None |
+| `content` | Content creation | core |
+| `visual` | Image/video generation | core |
+| `publish-wordpress` | WordPress publishing | core |
+| `development` | Dev tools | core |
+| `security-pentest` | Penetration testing | core |
+| `security-audit` | Security auditing | core |
+
+### Installing Multiple Workflows
+
+```bash
+# Install several workflows
+npx myaidev-method content --claude
+npx myaidev-method visual --claude
+npx myaidev-method publish-wordpress --claude
+```
+
+### Interactive Installation
+
+```bash
+# Choose workflows interactively
+npx myaidev-method install --interactive
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project root:
+
+```env
+# General Settings
+CLI_TYPE=claude
+LOG_LEVEL=INFO
+
+# Content Settings
+DEFAULT_WORD_COUNT=1500
+DEFAULT_TONE=professional
+CONTENT_OUTPUT_DIR=./content
+
+# WordPress Settings
+WORDPRESS_URL=https://your-site.com
+WORDPRESS_USERNAME=your-username
+WORDPRESS_APP_PASSWORD=your-app-password
+WORDPRESS_DEFAULT_STATUS=draft
+
+# OpenStack Settings (if using)
+OS_AUTH_URL=https://your-openstack.com/v3
+OS_USERNAME=your-username
+OS_PASSWORD=your-password
+OS_PROJECT_NAME=your-project
+
+# Visual Generation (if using)
+GOOGLE_AI_API_KEY=your-key
+REPLICATE_API_TOKEN=your-token
+```
+
+### Configuration Wizard
+
+```bash
+# Run interactive configuration
+/myai-configure
+```
+
+### Per-Workflow Configuration
+
+Configuration files are stored in `.claude/config/`:
+
+```
+.claude/
+├── config/
+│   ├── wordpress.json
+│   ├── openstack.json
+│   └── content.json
+├── agents/
+└── commands/
+```
+
+## Directory Structure
+
+After installation, your project will have:
+
+```
+your-project/
+├── .claude/
+│   ├── CLAUDE.md           # Project instructions
+│   ├── agents/             # AI agent definitions
+│   │   ├── content-writer.md
+│   │   ├── wordpress-admin.md
+│   │   └── ...
+│   ├── commands/           # Slash commands
+│   │   ├── myai-content-writer.md
+│   │   ├── myai-wordpress-publish.md
+│   │   └── ...
+│   └── config/             # Configuration files
+├── .env                    # Environment variables
+└── content/                # Generated content
+```
+
+## CLI Type Support
+
+### Claude Code (Default)
+
+```bash
+npx myaidev-method init --claude
+```
+
+Files installed to `.claude/` directory.
+
+### Gemini CLI
+
+```bash
+npx myaidev-method init --gemini
+```
+
+Files installed to `.gemini/` directory.
+
+### Codex CLI
+
+```bash
+npx myaidev-method init --codex
+```
+
+Files installed to `.codex/` directory.
+
+## Updating
+
+### Update Package
+
+```bash
+# Update to latest version
+npm update myaidev-method
+
+# Or reinstall
+npx myaidev-method@latest init --claude
+```
+
+### Update Workflows
+
+```bash
+# Reinstall with force to update agents/commands
+npx myaidev-method content --claude --force
+```
+
+## Team Deployment
+
+### Shared Configuration
+
+1. Commit `.claude/` directory to git
+2. Add `.env` to `.gitignore`
+3. Create `.env.example` template
+
+### Team Setup
+
+```bash
+# Clone project
+git clone your-repo
+
+# Install dependencies
+npm install
+
+# Copy environment template
+cp .env.example .env
+
+# Configure credentials
+/myai-configure
+```
+
+## CI/CD Integration
+
+### GitHub Actions Example
+
+```yaml
+name: Content Publishing
+
+on:
+  push:
+    paths:
+      - 'content/**'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Publish content
+        env:
+          WORDPRESS_URL: ${{ secrets.WORDPRESS_URL }}
+          WORDPRESS_USERNAME: ${{ secrets.WORDPRESS_USERNAME }}
+          WORDPRESS_APP_PASSWORD: ${{ secrets.WORDPRESS_APP_PASSWORD }}
+        run: npx myaidev-method publish-batch ./content/
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**Command not found:**
+```bash
+# Ensure Claude Code is active
+# Commands run inside Claude Code, not terminal
+```
+
+**Missing credentials:**
+```bash
+# Check .env file exists
+cat .env
+
+# Reconfigure
+/myai-configure
+```
+
+**Workflow not working:**
+```bash
+# Reinstall workflow
+npx myaidev-method content --claude --force
+```
+
+### Debug Mode
+
+```bash
+# Enable verbose logging
+LOG_LEVEL=DEBUG /myai-content-writer "Topic"
+```
+
+### Health Check
+
+```bash
+# WordPress connection
+/myai-configure wordpress
+# Then test connection option
+
+# OpenStack connection
+/myai-configure openstack
+# Then verify credentials
+```
+
+## Security Considerations
+
+### Credential Management
+
+1. **Never commit credentials** - Use `.env` and `.gitignore`
+2. **Use application passwords** - Not main passwords
+3. **Rotate regularly** - Update credentials periodically
+4. **Limit permissions** - Use least-privilege accounts
+
+### Secure Deployment
+
+```bash
+# Set restrictive permissions
+chmod 600 .env
+
+# Verify gitignore
+grep ".env" .gitignore
+```
+
+## Uninstalling
+
+### Remove from Project
+
+```bash
+# Remove .claude directory
+rm -rf .claude/
+
+# Remove from package.json
+npm uninstall myaidev-method
+```
+
+### Selective Removal
+
+```bash
+# Remove specific workflow components
+rm .claude/agents/content-writer.md
+rm .claude/commands/myai-content-writer.md
+```
+
+## Related Documentation
+
+- [Content Creation Guide](content-creation-guide.md)
+- [WordPress Publishing Guide](wordpress-publishing-guide.md)
+- [Visual Generation Guide](visual-generation-guide.md)