myaidev-method 0.3.2 → 0.3.4

package/skills/sparc-documenter/SKILL.md

@@ -1,155 +0,0 @@
----
-name: sparc-documenter
-description: Generates comprehensive documentation following the SPARC Completion phase. Use when creating API docs, README files, architecture documentation, user guides, changelogs, or adding code documentation.
-argument-hint: [path] [--type=api]
-allowed-tools: [Read, Write, Edit, Glob, Grep, Task]
----
-
-# SPARC Documenter Skill
-
-The Completion phase of the SPARC methodology focused on documentation. Generate comprehensive documentation for code, APIs, and features.
-
-Handles the **Completion (C)** phase of the SPARC methodology, focused on documentation. Part of the `/myaidev-method:sparc-workflow` pipeline.
-
-## Capabilities
-
-- Generate API documentation
-- Create README files
-- Document code with JSDoc/docstrings
-- Generate architecture documentation
-- Create user guides and tutorials
-- Update changelog entries
-- Generate TypeScript declarations
-
-## Documentation Types
-
-| Type | Output | Use Case |
-|------|--------|----------|
-| `api` | API reference | HTTP endpoints, SDK methods |
-| `code` | JSDoc/docstrings | Functions, classes, modules |
-| `readme` | README.md | Project overview |
-| `architecture` | Architecture docs | System design |
-| `guide` | User guide | How-to documentation |
-| `changelog` | CHANGELOG.md | Version history |
-| `types` | TypeScript .d.ts | Type definitions |
-
-## Process
-
-1. **Code Analysis**
-   - Parse source files
-   - Extract function signatures
-   - Identify public APIs
-   - Understand code purpose
-
-2. **Documentation Generation**
-   - Generate appropriate doc format
-   - Add usage examples
-   - Include parameter descriptions
-   - Document return values and errors
-
-3. **Quality Check**
-   - Verify completeness
-   - Check for accuracy
-   - Ensure consistency
-
-4. **Integration**
-   - Update existing docs
-   - Add to documentation site
-   - Update README links
-
-## API Documentation Template
-
-```markdown
-# API Reference
-
-## Overview
-[Brief description of the API]
-
-## Authentication
-[Auth requirements and examples]
-
-## Endpoints
-
-### `POST /api/resource`
-Create a new resource.
-
-**Request Body:**
-```json
-{
-  "name": "string",
-  "value": "number"
-}
-```
-
-**Response:**
-```json
-{
-  "id": "string",
-  "name": "string",
-  "createdAt": "ISO8601"
-}
-```
-
-**Errors:**
-| Code | Description |
-|------|-------------|
-| 400 | Invalid request body |
-| 401 | Unauthorized |
-| 409 | Resource already exists |
-
-**Example:**
-```bash
-curl -X POST https://api.example.com/resource \
-  -H "Authorization: Bearer TOKEN" \
-  -d '{"name": "test"}'
-```
-```
-
-## Parameters
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `path` | File or directory to document | Required |
-| `--type` | Documentation type | api |
-| `--output` | Output directory | ./docs |
-| `--format` | markdown, html, json | markdown |
-| `--update` | Update existing docs | false |
-
-## Example Usage
-
-```bash
-# Generate API documentation
-/myaidev-method:documenter ./src/api --type=api
-
-# Add JSDoc to code
-/myaidev-method:documenter ./src/utils --type=code
-
-# Generate README
-/myaidev-method:documenter ./ --type=readme
-
-# Update changelog
-/myaidev-method:documenter --type=changelog --update
-```
-
-## Integration
-
-- Documents code from `/myaidev-method:coder`
-- Uses review insights from `/myaidev-method:reviewer`
-- Final phase of `/myaidev-method:sparc` workflow
-
-## Output Structure
-
-```
-docs/
-├── README.md           # Project overview
-├── API.md              # API reference
-├── ARCHITECTURE.md     # System design
-├── CHANGELOG.md        # Version history
-├── guides/
-│   ├── getting-started.md
-│   └── advanced-usage.md
-└── api/
-    ├── endpoints.md
-    └── types.md
-```
-

package/skills/sparc-reviewer/SKILL.md

@@ -1,138 +0,0 @@
----
-name: sparc-reviewer
-description: Performs comprehensive code reviews for quality, security, and performance following the SPARC Refinement phase. Use when reviewing code changes, assessing code quality, or identifying bugs and vulnerabilities.
-argument-hint: [path] [--focus=security]
-allowed-tools: [Read, Glob, Grep, Task, WebSearch]
----
-
-# SPARC Reviewer Skill
-
-The Refinement phase of the SPARC methodology focused on code review. Perform comprehensive code reviews, identify issues, and suggest improvements.
-
-Handles the **Refinement (R)** phase of the SPARC methodology, focused on code review. Part of the `/myaidev-method:sparc-workflow` pipeline.
-
-## Capabilities
-
-- Code quality assessment
-- Security vulnerability detection
-- Performance issue identification
-- Best practice verification
-- Style and convention checking
-- Documentation completeness review
-- Dependency audit
-
-## Review Categories
-
-| Category | Focus Areas |
-|----------|-------------|
-| **Quality** | Readability, maintainability, complexity |
-| **Security** | Vulnerabilities, input validation, secrets |
-| **Performance** | Efficiency, memory usage, async patterns |
-| **Architecture** | Design patterns, SOLID principles, coupling |
-| **Testing** | Coverage, test quality, edge cases |
-| **Documentation** | Comments, README, API docs |
-
-## Process
-
-1. **Code Analysis**
-   - Read and understand the code
-   - Identify the purpose and context
-   - Note patterns and anti-patterns
-
-2. **Issue Detection**
-   - Check for bugs and logic errors
-   - Identify security vulnerabilities
-   - Find performance bottlenecks
-   - Note code smells
-
-3. **Improvement Suggestions**
-   - Recommend refactoring opportunities
-   - Suggest better patterns
-   - Propose documentation additions
-
-4. **Report Generation**
-   - Categorize findings by severity
-   - Provide actionable recommendations
-   - Highlight positive aspects
-
-## Review Output Format
-
-```markdown
-# Code Review: [File/Feature Name]
-
-## Summary
-- **Files Reviewed**: X
-- **Critical Issues**: X
-- **Warnings**: X
-- **Suggestions**: X
-- **Overall Score**: X/10
-
-## Critical Issues 🔴
-### [Issue Title]
-- **Location**: `file.ts:123`
-- **Description**: [What's wrong]
-- **Impact**: [Why it matters]
-- **Suggestion**: [How to fix]
-
-## Warnings 🟡
-### [Warning Title]
-- **Location**: `file.ts:45`
-- **Description**: [The concern]
-- **Suggestion**: [Improvement]
-
-## Suggestions 🟢
-### [Suggestion Title]
-- **Description**: [What could be better]
-- **Benefit**: [Why it helps]
-
-## Positive Highlights ✨
-- [Good practice observed]
-- [Well-written code example]
-
-## Recommendations
-1. [Priority action 1]
-2. [Priority action 2]
-3. [Priority action 3]
-```
-
-## Severity Levels
-
-| Level | Icon | Criteria |
-|-------|------|----------|
-| Critical | 🔴 | Security vulnerabilities, data loss, crashes |
-| Warning | 🟡 | Bugs, performance issues, bad practices |
-| Suggestion | 🟢 | Improvements, refactoring, style |
-| Info | 🔵 | Notes, alternatives, best practices |
-
-## Parameters
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `path` | File or directory to review | Required |
-| `--focus` | security, performance, quality, all | all |
-| `--severity` | Filter by minimum severity | suggestion |
-| `--output` | Output format: markdown, json | markdown |
-| `--pr` | Review as PR (GitHub integration) | false |
-
-## Example Usage
-
-```bash
-# Full code review
-/myaidev-method:reviewer ./src/auth
-
-# Security-focused review
-/myaidev-method:reviewer ./src/api --focus=security
-
-# Performance review
-/myaidev-method:reviewer ./src/utils --focus=performance
-
-# Review a specific file
-/myaidev-method:reviewer ./src/auth/login.ts
-```
-
-## Integration
-
-- Reviews code from `/myaidev-method:coder`
-- Validates test coverage from `/myaidev-method:tester`
-- Part of `/myaidev-method:sparc` full workflow
-

package/skills/sparc-tester/SKILL.md

@@ -1,100 +0,0 @@
----
-name: sparc-tester
-description: Creates and runs comprehensive test suites following the SPARC Refinement phase. Use when generating unit/integration/e2e tests, running test suites, analyzing coverage, or validating code against specifications.
-argument-hint: [path] [--coverage] [--type=unit]
-allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task]
----
-
-# SPARC Tester Skill
-
-The Refinement phase of the SPARC methodology focused on testing. Create comprehensive tests, run test suites, and ensure code quality through systematic testing.
-
-Handles the **Refinement (R)** phase of the SPARC methodology, focused on testing. Part of the `/myaidev-method:sparc-workflow` pipeline.
-
-## Capabilities
-
-- Generate unit tests for components
-- Create integration tests for workflows
-- Run existing test suites
-- Analyze code coverage
-- Identify untested code paths
-- Generate test fixtures and mocks
-- Validate against specifications
-
-## Test Types
-
-| Type | Scope | Tools |
-|------|-------|-------|
-| Unit | Single function/component | Jest, Vitest, Mocha |
-| Integration | Multiple components | Jest, Playwright |
-| E2E | Full user flow | Playwright, Cypress |
-| API | HTTP endpoints | Supertest, REST Client |
-| Performance | Load/stress | Artillery, k6 |
-
-## Process
-
-1. **Analysis**
-   - Identify testable units
-   - Map code paths to test cases
-   - Check existing coverage
-
-2. **Test Generation**
-   - Write test cases for happy paths
-   - Add edge case tests
-   - Create error scenario tests
-   - Generate fixtures/mocks
-
-3. **Execution**
-   - Run test suites
-   - Collect coverage data
-   - Report failures
-
-4. **Validation**
-   - Verify against specifications
-   - Check coverage thresholds
-   - Document test gaps
-
-## Parameters
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `path` | File or directory to test | ./src |
-| `--type` | unit, integration, e2e, all | unit |
-| `--coverage` | Generate coverage report | false |
-| `--watch` | Run in watch mode | false |
-| `--update-snapshots` | Update snapshot tests | false |
-| `--generate` | Generate missing tests | false |
-
-## Example Usage
-
-```bash
-# Run all tests
-/myaidev-method:tester --type=all
-
-# Generate tests for a module
-/myaidev-method:tester ./src/auth --generate
-
-# Run with coverage
-/myaidev-method:tester ./src --coverage
-
-# Integration tests only
-/myaidev-method:tester --type=integration
-```
-
-## Coverage Thresholds
-
-Default thresholds for quality gates:
-
-| Metric | Minimum |
-|--------|---------|
-| Statements | 80% |
-| Branches | 75% |
-| Functions | 80% |
-| Lines | 80% |
-
-## Integration
-
-- Tests code from `/myaidev-method:coder`
-- Results feed into `/myaidev-method:reviewer`
-- Part of `/myaidev-method:sparc` full workflow
-

package/skills/sparc-workflow/SKILL.md

@@ -1,130 +0,0 @@
----
-name: sparc-workflow
-description: Orchestrates the complete SPARC development workflow through Specification, Pseudocode, Architecture, Refinement, and Completion phases. Use when building features systematically, running multi-phase development, or coordinating design-to-implementation workflows.
-argument-hint: "[task description] [--phase spec|pseudo|arch|refine|complete]"
-allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, WebSearch, AskUserQuestion]
-context: fork
----
-
-# SPARC Workflow Orchestrator
-
-You are the **SPARC Workflow Orchestrator** — coordinating the complete 5-phase systematic development methodology by dispatching specialized subagents for each phase.
-
-## SPARC Methodology
-
-```
-S - Specification    → Define requirements and acceptance criteria
-P - Pseudocode       → Design algorithms and logic flow
-A - Architecture     → System design and component structure
-R - Refinement       → Code review, testing, quality assurance
-C - Completion       → Documentation and deployment readiness
-```
-
-## Arguments
-
-Parse from: `$ARGUMENTS`
-
-- `[task]` → Development task description (required)
-- `--phase <name>` → Run specific phase only
-- `--from <phase>` → Start from specific phase
-- `--skip-tests` → Skip test generation in Refinement
-- `--verbose` → Detailed progress
-
-## Orchestration
-
-### Phase 1: Specification (sparc-architect skill)
-```
-Task(subagent_type: "general-purpose")
-```
-- Gather requirements from task description
-- Define acceptance criteria
-- Identify constraints and dependencies
-- Output: `.sparc-session/spec.md`
-
-### Phase 2: Pseudocode (sparc-coder skill)
-```
-Task(subagent_type: "general-purpose")
-```
-- Design algorithms from specification
-- Plan data structures
-- Define function signatures and interfaces
-- Output: `.sparc-session/pseudocode.md`
-
-### Phase 3: Architecture (sparc-architect skill)
-```
-Task(subagent_type: "general-purpose")
-```
-- Component design and relationships
-- Technology choices
-- File structure planning
-- API design
-- Output: `.sparc-session/architecture.md`
-
-### Phase 4: Refinement (sparc-reviewer + sparc-tester skills)
-```
-Task(subagent_type: "general-purpose") × 2 (parallel)
-```
-- Code implementation from architecture
-- Test generation
-- Code review for quality and security
-- Output: `.sparc-session/implementation/`, `.sparc-session/tests/`
-
-### Phase 5: Completion (sparc-documenter skill)
-```
-Task(subagent_type: "general-purpose")
-```
-- Generate documentation
-- Create deployment checklist
-- Verify all acceptance criteria met
-- Output: `.sparc-session/docs/`
-
-## Session State
-
-```
-.sparc-session/
-├── config.json          # Task parameters
-├── spec.md              # Specification output
-├── pseudocode.md        # Algorithm design
-├── architecture.md      # System design
-├── implementation/      # Code files
-├── tests/               # Test files
-├── docs/                # Documentation
-└── completion-report.md # Final summary
-```
-
-## Progress Reporting
-
-```
-SPARC Workflow: "{task}"
-════════════════════════════
-→ Phase 1/5: Specification...
-  ✓ 5 requirements, 8 acceptance criteria defined
-
-→ Phase 2/5: Pseudocode...
-  ✓ 3 algorithms, 4 interfaces designed
-
-→ Phase 3/5: Architecture...
-  ✓ 6 components, 2 services planned
-
-→ Phase 4/5: Refinement...
-  ✓ 12 files implemented, 24 tests passing
-
-→ Phase 5/5: Completion...
-  ✓ API docs generated, deployment checklist ready
-
-Summary:
-  Files: 12 | Tests: 24 | Coverage: 87%
-  Documentation: API + README + Deploy guide
-```
-
-## Error Recovery
-
-- Specification fails → Ask user for clarification
-- Pseudocode fails → Proceed with high-level architecture
-- Architecture fails → Use simpler flat structure
-- Refinement fails → Report issues, proceed to docs
-- Completion fails → Generate minimal docs from code comments
-
-## Cleanup
-
-Remove `.sparc-session/` after successful completion. Keep on failure for debugging.