@mytechtoday/augment-extensions 0.2.0 → 0.4.0

package/modules.md

@@ -1,176 +1,588 @@
-# Available Extension Modules
+# Augment Extensions Module Catalog
 
-This document catalogs all available extension modules for Augment Code AI.
+This catalog lists all available extension modules for Augment Code AI.
+
+## Quick Start
+
+```bash
+# List all modules
+augx list
+
+# Show module details
+augx show <module-name>
+
+# Link a module to your project
+augx link <module-name>
+```
 
 ## Coding Standards
 
+### HTML Standards
+- **Module**: `coding-standards/html`
+- **Version**: 1.0.0
+- **Character Count**: ~32,477
+- **Description**: Comprehensive HTML coding standards for semantic, accessible, and modern web development
+- **Contents**:
+  - Semantic HTML
+  - Accessibility (ARIA, WCAG)
+  - Forms and validation
+  - SEO best practices
+  - Performance optimization
+
+**Usage**:
+```bash
+augx link coding-standards/html
+```
+
+### CSS Standards
+- **Module**: `coding-standards/css`
+- **Version**: 1.0.0
+- **Character Count**: ~30,556
+- **Description**: Modern CSS coding standards including CSS Grid, Flexbox, custom properties, and responsive design
+- **Contents**:
+  - Modern CSS features (Grid, Flexbox, Custom Properties)
+  - Responsive design
+  - CSS architecture (BEM, SMACSS)
+  - Performance optimization
+  - Browser compatibility
+
+**Usage**:
+```bash
+augx link coding-standards/css
+```
+
+### JavaScript Standards
+- **Module**: `coding-standards/js`
+- **Version**: 1.0.0
+- **Character Count**: ~101,818
+- **Description**: ES6+ JavaScript coding standards including async patterns, DOM manipulation, and modern tooling
+- **Contents**:
+  - ES6+ features
+  - Async patterns (Promises, async/await)
+  - DOM manipulation
+  - Error handling
+  - Performance optimization
+  - Modern tooling (ESLint, Prettier)
+
+**Usage**:
+```bash
+augx link coding-standards/js
+```
+
+### HTML/CSS/JavaScript Standards (DEPRECATED)
+- **Module**: `coding-standards/html-css-js`
+- **Version**: 1.0.0
+- **Character Count**: ~165,097
+- **Status**: ⚠️ **DEPRECATED** - Use individual modules or the `collections/html-css-js` collection instead
+- **Description**: Legacy monolithic module. Replaced by individual HTML, CSS, and JS modules for better flexibility.
+- **Migration**: Use `augx link collections/html-css-js` or link individual modules
+
+**Usage** (not recommended):
+```bash
+augx link coding-standards/html-css-js  # Deprecated
+```
+
+### Python Coding Standards
+- **Module**: `coding-standards/python`
+- **Version**: 1.1.0
+- **Character Count**: ~116,868
+- **Description**: Comprehensive Python coding standards including naming conventions, type hints (PEP 484, 585, 604), and error handling
+- **Contents**:
+  - Async patterns
+  - Best practices
+  - Code organization
+  - Documentation
+  - Error handling
+  - Naming conventions
+  - Testing
+  - Tooling
+  - Type hints
+
+**Usage**:
+```bash
+augx link coding-standards/python
+```
+
+### React Patterns
+- **Module**: `coding-standards/react`
+- **Version**: 1.0.0
+- **Character Count**: ~32,000
+- **Description**: Modern React patterns including component design, hooks, and state management best practices
+- **Contents**:
+  - Component patterns
+  - Hooks best practices
+  - Performance
+  - State management
+  - Typescript react
+
+**Usage**:
+```bash
+augx link coding-standards/react
+```
+
 ### TypeScript Standards
 - **Module**: `coding-standards/typescript`
 - **Version**: 1.0.0
-- **Character Count**: ~15,420
+- **Character Count**: ~6,416
 - **Description**: Comprehensive TypeScript coding standards and best practices
 - **Contents**:
   - Naming conventions
-  - Type safety guidelines
-  - Error handling patterns
-  - Async/await best practices
 
 **Usage**:
 ```bash
 augx link coding-standards/typescript
 ```
 
-### Python Standards (Coming Soon)
-- **Module**: `coding-standards/python`
-- **Status**: Planned
-
-### React Patterns (Coming Soon)
-- **Module**: `coding-standards/react`
-- **Status**: Planned
+### PHP Coding Standards
+- **Module**: `coding-standards/php`
+- **Version**: 1.0.0
+- **Character Count**: ~186,539
+- **Description**: Comprehensive PHP coding standards following PSR standards and modern PHP best practices across various project types including web applications, APIs, CLI tools, CMS integrations, e-commerce systems, and legacy migrations
+- **Contents**:
+  - PSR standards (PSR-1, PSR-12, PSR-4, PSR-7, PSR-11)
+  - Naming conventions
+  - Type declarations
+  - Error handling
+  - Security (OWASP guidelines)
+  - Performance optimization
+  - Testing standards
+  - Documentation (PHPDoc)
+  - Code quality tools
+  - Category configuration
+  - Web applications
+  - API development
+  - CLI tools
+  - CMS integration (WordPress, Drupal)
+  - E-commerce (WooCommerce)
+  - Legacy migration
 
-## Workflows
+**Usage**:
+```bash
+augx link coding-standards/php
+```
 
-### OpenSpec Workflow
-- **Module**: `workflows/openspec`
+### PowerShell Coding Standards
+- **Module**: `coding-standards/powershell`
 - **Version**: 1.0.0
-- **Character Count**: ~30,505
-- **Description**: Spec-driven development (SDD) workflow for AI coding assistants
+- **Character Count**: ~162,000
+- **Description**: Comprehensive PowerShell coding standards for professional, maintainable, and secure PowerShell code across automation, modules, DSC, cloud orchestration, administrative tools, cross-platform scripts, and legacy migrations
 - **Contents**:
-  - Complete workflow guide (proposal → specs → tasks → implement → archive)
-  - Specification format and delta syntax
-  - Manual setup without CLI
-  - CLI command reference
-  - Best practices and patterns
-  - Complete change examples
+  - Universal standards (naming, error handling, security, performance, testing)
+  - Configuration schema documentation (.augment/powershell-config.json)
+  - Automation scripts (scheduled tasks, event-driven automation)
+  - PowerShell modules and advanced functions
+  - Desired State Configuration (DSC)
+  - Cloud orchestration (Azure, AWS)
+  - Administrative tools (Active Directory, Exchange, SQL Server)
+  - Cross-platform scripts (PowerShell Core compatibility)
+  - Legacy migrations (Windows PowerShell to PowerShell Core)
+  - Category configuration system
+  - PSScriptAnalyzer integration
+  - Pester testing framework
 
 **Usage**:
 ```bash
-augx link workflows/openspec
+augx link coding-standards/powershell
+```
+
+**Configuration** (`.augment/powershell-config.json`):
+```json
+{
+  "powershell_categories": ["automation", "modules", "cloud"],
+  "powershell_version": "7.4",
+  "strict_mode": true,
+  "static_analysis": {
+    "tool": "PSScriptAnalyzer",
+    "severity": "Warning"
+  },
+  "testing": {
+    "framework": "Pester",
+    "version": "5.x"
+  }
+}
+```
+
+## Collections
+
+Collections bundle multiple related modules together for easier installation.
+
+### HTML/CSS/JS Frontend Collection
+- **Collection**: `collections/html-css-js`
+- **Version**: 1.0.0
+- **Description**: Complete frontend development standards bundle including HTML, CSS, and JavaScript modules
+- **Included Modules**:
+  - `coding-standards/html` (v1.0.0) - HTML standards
+  - `coding-standards/css` (v1.0.0) - CSS standards
+  - `coding-standards/js` (v1.0.0) - JavaScript standards
+- **Total Character Count**: ~164,851
+- **Backward Compatibility**: Replaces the deprecated `coding-standards/html-css-js` module
+
+**Usage**:
+```bash
+augx link collections/html-css-js
 ```
 
-**Installation**: Optional CLI available via `npm install -g @fission-ai/openspec@latest`
+**Or link individual modules**:
+```bash
+augx link coding-standards/html
+augx link coding-standards/css
+augx link coding-standards/js
+```
 
-**Learn More**: https://openspec.dev/
+## Domain Rules
 
-### WordPress Plugin Development Workflow
-- **Module**: `workflows/wordpress-plugin`
-- **Version**: 1.2.0
-- **Character Count**: ~81,564
-- **Description**: Complete workflows for WordPress plugin development including development cycle, testing setup, WordPress.org submission, and comprehensive best practices. Optimized for AI-assisted development with OpenSpec and Beads integration.
+### API Design Guidelines
+- **Module**: `domain-rules/api-design`
+- **Version**: 1.0.0
+- **Character Count**: ~35,000
+- **Description**: Comprehensive API design guidelines including REST, GraphQL, versioning, and best practices
 - **Contents**:
-  - Development workflow (feature planning, implementation, security-first approach)
-  - Testing workflow (PHPUnit setup, TDD, CI/CD integration)
-  - Submission workflow (security audit, WPCS compliance, WordPress.org submission)
-  - Best practices (code organization, naming conventions, security, performance, accessibility)
-  - AI prompt templates for each workflow phase
-  - Beads task breakdown patterns
-  - OpenSpec spec templates
+  - Authentication
+  - Documentation
+  - Error handling
+  - Graphql api
+  - Rest api
+  - Versioning
 
 **Usage**:
 ```bash
-augx link workflows/wordpress-plugin
+augx link domain-rules/api-design
 ```
 
-**Dependencies**: `domain-rules/wordpress-plugin`
+### Database Design Guidelines
+- **Module**: `domain-rules/database`
+- **Version**: 1.0.0
+- **Character Count**: ~449,449
+- **Description**: Comprehensive database design guidelines including schema design, normalization, indexing, and best practices
+- **Contents**:
+  - Flat databases
+  - Nosql databases
+  - Nosql document stores
+  - Nosql graph databases
+  - Nosql key value stores
+  - Performance optimization
+  - Relational databases
+  - Relational indexing
+  - Relational query optimization
+  - Relational schema design
+  - Relational transactions
+  - Security standards
+  - Universal best practices
+  - Vector databases
+  - Vector embeddings
+  - Vector indexing
 
+**Usage**:
+```bash
+augx link domain-rules/database
+```
 
-### Beads Workflow
-- **Module**: `workflows/beads`
+### Model Context Protocol (MCP) Guidelines
+- **Module**: `domain-rules/mcp`
 - **Version**: 1.0.0
-- **Character Count**: ~36,816
-- **Description**: Distributed, git-backed graph issue tracker for AI agents
+- **Character Count**: ~219,130
+- **Description**: Comprehensive guidelines for designing and implementing Model Context Protocol systems including token-based, state-based, vector-based, hybrid, graph-augmented, and compressed MCP
 - **Contents**:
-  - Complete workflow guide (create → dependencies → ready → work → close)
-  - JSONL file format specification
-  - Manual setup without CLI
-  - CLI command reference
-  - Best practices and patterns
-  - Complete workflow examples
+  - Universal rules (context optimization, error handling, security, monitoring, testing, documentation)
+  - Token-based MCP (compression, chunking, budgeting)
+  - State-based MCP (persistence, state machines, concurrency)
+  - Vector-based MCP (RAG, embeddings, semantic search)
+  - Hybrid MCP (multi-memory coordination, context orchestration)
+  - Graph-augmented MCP (knowledge graphs, entity relationships, graph traversal)
+  - Compressed MCP (multi-stage compression, mobile optimization)
+  - Configuration system (JSON schema, validation, override semantics)
+  - Testing framework (unit, integration, synthetic testing)
+  - 6 complete implementation examples with code
 
 **Usage**:
 ```bash
-augx link workflows/beads
+augx link domain-rules/mcp
 ```
 
-**Installation**: Optional CLI available via `npm install -g @beads/bd`
+### Security Guidelines
+- **Module**: `domain-rules/security`
+- **Version**: 1.0.0
+- **Character Count**: ~38,000
+- **Description**: Comprehensive security guidelines including OWASP best practices, authentication, encryption, and secure coding
+- **Contents**:
+  - Authentication security
+  - Encryption
+  - Input validation
+  - Owasp top 10
+  - Secure coding
+  - Web security
 
-**Learn More**: https://github.com/steveyegge/beads
+**Usage**:
+```bash
+augx link domain-rules/security
+```
 
-## Domain Rules
+### WordPress Development Standards
+- **Module**: `domain-rules/wordpress`
+- **Version**: 1.0.0
+- **Character Count**: ~0
+- **Description**: Comprehensive WordPress development guidelines including themes, plugins, blocks, and best practices
+- **Contents**:
+  - Coding standards
+  - Directory structure
+  - File patterns
+  - Gutenberg blocks
+  - Performance
+  - Plugin development
+  - Project detection
+  - Rest api
+  - Security
+  - Theme development
+  - Woocommerce
+
+**Usage**:
+```bash
+augx link domain-rules/wordpress
+```
 
 ### WordPress Plugin Development
 - **Module**: `domain-rules/wordpress-plugin`
 - **Version**: 1.1.0
 - **Character Count**: ~344,186
-- **Description**: Comprehensive WordPress plugin development guidelines covering plugin structure, architecture patterns, admin interfaces, frontend functionality, Gutenberg blocks, REST API, AJAX, database management, security, performance, WooCommerce integration, testing patterns, and WordPress.org submission
-- **Contents**:
-  - Plugin structure and architecture patterns (7 patterns)
-  - Activation/deactivation/uninstall hooks
-  - Admin interface development (settings pages, meta boxes)
-  - Frontend functionality (CPT, taxonomies, shortcodes, widgets)
-  - Gutenberg block development
-  - REST API endpoints
-  - AJAX handlers
-  - Database management (custom tables, queries)
-  - Cron jobs and scheduled tasks
-  - Security best practices (nonces, sanitization, escaping)
-  - Performance optimization (caching, query optimization)
-  - Internationalization (i18n/l10n)
-  - Asset management (scripts and styles)
-  - WooCommerce integration (products, cart, checkout, orders, payment gateways, emails)
-  - Testing patterns (PHPUnit, unit tests, integration tests, WooCommerce tests)
-  - Documentation standards (PHPDoc, readme.txt)
-  - WordPress.org submission process
-  - **Simple Procedural Plugin Example** (complete working plugin)
+- **Description**: Comprehensive WordPress plugin development guidelines covering plugin structure, architecture patterns, admin interfaces, frontend functionality, Gutenberg blocks, REST API, AJAX, database management, security, performance, WooCommerce integration, testing patterns, and WordPress.org submission.
+- **Contents**:
+  - Activation hooks
+  - Admin interface
+  - Ajax handlers
+  - Asset management
+  - Context providers
+  - Cron jobs
+  - Database management
+  - Documentation standards
+  - Frontend functionality
+  - Gutenberg blocks
+  - Internationalization
+  - Migration
+  - Performance optimization
+  - Plugin architecture
+  - Plugin structure
+  - Rest api
+  - Scaffolding workflow
+  - Security best practices
+  - Testing patterns
+  - Testing
+  - Vscode integration
+  - Woocommerce integration
+  - Wordpress org submission
 
 **Usage**:
 ```bash
 augx link domain-rules/wordpress-plugin
 ```
 
-### Web Development (Coming Soon)
-- **Module**: `domain-rules/web-development`
-- **Status**: Planned
-- **Description**: Best practices for web application development
+## Workflows
 
-### API Design (Coming Soon)
-- **Module**: `domain-rules/api-design`
-- **Status**: Planned
-- **Description**: RESTful and GraphQL API design guidelines
+### Beads Workflow
+- **Module**: `workflows/beads`
+- **Version**: 1.0.0
+- **Character Count**: ~39,912
+- **Description**: Distributed, git-backed graph issue tracker for AI agents. Provides persistent, structured memory for coding agents with dependency tracking.
+- **Contents**:
+  - Best practices
+  - File format
+  - Manual setup
+  - Workflow
 
-### Security (Coming Soon)
-- **Module**: `domain-rules/security`
-- **Status**: Planned
-- **Description**: Security best practices and common vulnerabilities
+**Usage**:
+```bash
+augx link workflows/beads
+```
+
+### OpenSpec Workflow
+- **Module**: `workflows/openspec`
+- **Version**: 1.0.0
+- **Character Count**: ~32,661
+- **Description**: Spec-driven development (SDD) workflow for AI coding assistants. Provides structured change management with proposals, specs, and tasks.
+- **Contents**:
+  - Best practices
+  - Manual setup
+  - Spec format
+  - Workflow
+
+**Usage**:
+```bash
+augx link workflows/openspec
+```
 
 ## Examples
 
-### Design Patterns (Coming Soon)
+### Design Patterns Examples
 - **Module**: `examples/design-patterns`
-- **Status**: Planned
-- **Description**: Common design patterns with code examples
+- **Version**: 1.0.0
+- **Character Count**: ~42,000
+- **Description**: Common design patterns with TypeScript/JavaScript implementations and use cases
 
-### Testing Strategies (Coming Soon)
-- **Module**: `examples/testing-strategies`
-- **Status**: Planned
-- **Description**: Unit, integration, and E2E testing examples
+**Usage**:
+```bash
+augx link examples/design-patterns
+```
 
-## Contributing New Modules
+### Gutenberg Block Plugin Examples
+- **Module**: `examples/gutenberg-block-plugin`
+- **Version**: 1.0.0
+- **Character Count**: ~15,889
+- **Description**: Complete Gutenberg block plugin examples with block.json, React components, InspectorControls, RichText, MediaUpload, and build process
 
-See [module-development.md](./module-development.md) for guidelines on creating new modules.
+**Usage**:
+```bash
+augx link examples/gutenberg-block-plugin
+```
+
+### REST API Plugin Examples
+- **Module**: `examples/rest-api-plugin`
+- **Version**: 1.0.0
+- **Character Count**: ~40,367
+- **Description**: Complete REST API plugin examples with custom endpoints (GET, POST, PUT, DELETE), authentication, validation, error handling, and JavaScript client examples
+
+**Usage**:
+```bash
+augx link examples/rest-api-plugin
+```
+
+### WooCommerce Extension Examples
+- **Module**: `examples/woocommerce-extension`
+- **Version**: 1.0.0
+- **Character Count**: ~24,196
+- **Description**: Complete WooCommerce extension examples with custom product fields, checkout customization, payment gateway, order hooks, and WooCommerce best practices
+
+**Usage**:
+```bash
+augx link examples/woocommerce-extension
+```
+
+## Skills System
+
+### Overview
+- **Location**: `skills/`
+- **Version**: 1.0.0
+- **Total Skills**: 4
+- **Description**: Token-efficient skill-based system for on-demand AI context injection. Skills are lightweight, focused definitions that replace full modules for specific tasks.
+
+### Key Features
+- **Token Reduction**: 97.18% average reduction vs full modules
+- **Dynamic Loading**: Load only what you need, when you need it
+- **Dependency Resolution**: Automatic dependency management
+- **CLI Integration**: Wrap MCP servers and external tools
+- **Caching**: Intelligent caching for performance
+
+### Skill Categories
+
+#### Retrieval Skills
+- **sdk-query**: Query SDK documentation and code examples
+- **context-retrieval**: Retrieve code context using semantic search
+
+#### Analysis Skills
+- **code-analysis**: Analyze code for quality and patterns
+
+#### Generation Skills
+- **add-mcp-skill**: Generate new MCP-based skills
+
+### Usage
+
+```bash
+# List available skills
+augx skill list
+
+# Show skill details
+augx skill show sdk-query
+
+# Inject skill into context
+augx skill inject sdk-query
+
+# Load multiple skills
+augx skill load sdk-query context-retrieval
+
+# Validate a skill
+augx skill validate skills/retrieval/my-skill.md
+
+# Cache management
+augx skill cache-clear
+augx skill cache-stats
+```
+
+### Token Budget Guidelines
+- **Micro skills**: 500-1000 tokens (single focused task)
+- **Small skills**: 1000-2000 tokens (simple functionality)
+- **Medium skills**: 2000-5000 tokens (moderate complexity)
+- **Large skills**: 5000-10000 tokens (complex functionality)
+
+### Performance Benchmarks
+
+Based on `benchmarks/results.json`:
+
+| Scenario | Baseline Tokens | Skill Tokens | Reduction |
+|----------|----------------|--------------|-----------|
+| SDK Query | 27,706 | 804 | 97.10% |
+| Context Retrieval | 27,706 | 1,021 | 96.31% |
+| Multiple Skills | 27,706 | 1,825 | 93.41% |
+| Workflow Task | 8,804 | 8 | 99.91% |
+| Coding Standards | 1,440 | 12 | 99.17% |
+| **Average** | - | - | **97.18%** |
+
+### Creating New Skills
+
+See `skills/README.md` for detailed instructions on creating new skills.
+
+**Quick Start**:
+1. Choose appropriate category
+2. Create skill file: `skills/<category>/<skill-id>.md`
+3. Follow skill.md schema
+4. Keep within token budget (500-10k tokens)
+5. Test with `augx skill validate <skill-id>`
+
+**Automated MCP Skill Creation**:
+```bash
+# Create a new MCP skill automatically
+augx skill create-mcp \
+  --name "GitHub MCP" \
+  --description "GitHub repository management" \
+  --category "integration" \
+  --package "@modelcontextprotocol/server-github" \
+  --token-budget 2500 \
+  --tags "github,repository"
+```
+
+### MCP Integration
+
+The skills system integrates with Model Context Protocol (MCP) servers:
+
+```bash
+# List MCP servers
+augx mcp list
+
+# Add MCP server
+augx mcp add github-mcp "npx -y @modelcontextprotocol/server-github"
+
+# Execute MCP tool
+augx mcp exec github-mcp search-repos --args '{"query": "augment"}'
+
+# Generate skill wrapper for MCP tool
+augx mcp wrap github-mcp search-repos github-search --category retrieval
+```
 
-## Module Versioning
+### Meta-Skills
 
-All modules follow [Semantic Versioning](https://semver.org/):
-- **MAJOR**: Breaking changes to module structure or rules
-- **MINOR**: New rules or examples added
-- **PATCH**: Bug fixes, typos, clarifications
+**Meta-skills** are skills that help create or manage other skills:
 
-## Character Count Guidelines
+- **add-mcp-skill**: Automates onboarding of new MCP integrations
+  - Generates skill files from templates
+  - Validates skill structure
+  - Updates documentation
+  - Reduces skill creation time from 30+ minutes to < 1 minute
 
-- **Small modules**: < 10,000 characters
-- **Medium modules**: 10,000 - 25,000 characters
-- **Large modules**: > 25,000 characters
+---
 
-Modules should be split if they exceed 50,000 characters.
+## Statistics
 
+- **Total Modules**: 18
+- **Coding Standards**: 5
+- **Domain Rules**: 5
+- **Workflows**: 2
+- **Examples**: 4
+- **Total Skills**: 4
+- **Total Character Count**: ~1,774,692