Plugin Development Triage Extension

Provides decision-making knowledge for triaging marketplace plugin development findings during the finalize phase.

Purpose

This skill is a triage extension loaded by the plan-finalize workflow skill when processing plugin development findings (Python scripts, markdown documentation, YAML configurations).

Key Principle: This skill provides knowledge, not workflow control. The finalize skill owns the process.

When This Skill is Loaded

Loaded via resolve-workflow-skill-extension --domain plan-marshall-plugin-dev --type triage during finalize phase when:

Python script tests fail (pytest)
Plugin-doctor reports issues
Markdown linting issues detected
YAML validation errors occur

Standards

| Document | Purpose | |----------|---------| | suppression.md | Python and markdown suppression syntax | | severity.md | Plugin-specific severity guidelines |

Extension Registration

Registered in marshal.json under the plugin development domain:

"plan-marshall-plugin-dev": {
  "workflow_skill_extensions": {
    "triage": "pm-plugin-development:ext-triage-plugin"
  }
}

Quick Reference

Suppression Methods

| Finding Type | Syntax | |--------------|--------| | Python linting | # noqa: E501 or # noqa | | Python typing | # type: ignore | | Pytest skip | @pytest.mark.skip(reason="...") | | Markdown lint |  |

Decision Guidelines

| Severity | Default Action | |----------|----------------| | Test failure | Fix (tests must pass) | | Plugin-doctor error | Fix (quality gate) | | Script type error | Fix or add type ignore | | Documentation issue | Fix for consistency |

Acceptable to Accept

Markdown formatting in code examples
Test skip for environment-specific tests
Type ignores for dynamic patterns
Plugin-doctor warnings in experimental code