EXECUTE STEPS:

Step 1: Validate Inputs

Verify all required inputs:

if [ -z "$ARTIFACT_PATH" ]; then
    echo "Error: artifact_path is required"
    exit 1
fi

if [ -z "$ARTIFACT_TYPE" ]; then
    echo "Error: artifact_type is required"
    exit 1
fi

if [ ! -f "$ARTIFACT_PATH" ]; then
    echo "Error: Artifact file not found: $ARTIFACT_PATH"
    exit 1
fi

Step 2: Run XML Markup Validator

Execute XML validator based on artifact type:

VALIDATOR_DIR="$PLUGIN_DIR/validators"
"$VALIDATOR_DIR/xml-validator.sh" "$ARTIFACT_PATH" "$ARTIFACT_TYPE"
XML_EXIT_CODE=$?

if [ $XML_EXIT_CODE -eq 0 ]; then
    echo "✅ XML markup validation passed"
    XML_STATUS="passed"
elif [ $XML_EXIT_CODE -eq 1 ]; then
    echo "❌ XML markup validation failed"
    XML_STATUS="failed"
    XML_ERRORS=$(cat /tmp/xml-errors.txt 2>/dev/null || echo "See validator output above")
else
    echo "⚠️ XML markup validation completed with warnings"
    XML_STATUS="passed_with_warnings"
fi

The XML validator checks:

• All required XML sections present
• Proper UPPERCASE tag naming
• All tags properly closed
• No malformed structure

Step 3: Run Frontmatter Validator

Execute frontmatter validator:

"$VALIDATOR_DIR/frontmatter-validator.sh" "$ARTIFACT_PATH" "$ARTIFACT_TYPE"
FRONTMATTER_EXIT_CODE=$?

if [ $FRONTMATTER_EXIT_CODE -eq 0 ]; then
    echo "✅ Frontmatter validation passed"
    FRONTMATTER_STATUS="passed"
elif [ $FRONTMATTER_EXIT_CODE -eq 1 ]; then
    echo "❌ Frontmatter validation failed"
    FRONTMATTER_STATUS="failed"
    FRONTMATTER_ERRORS=$(cat /tmp/frontmatter-errors.txt 2>/dev/null || echo "See validator output above")
else
    echo "⚠️ Frontmatter validation completed with warnings"
    FRONTMATTER_STATUS="passed_with_warnings"
fi

The frontmatter validator checks:

• Required fields present (name, description)
• Name follows conventions (no leading slash for commands, plugin:command pattern)
• YAML syntax valid
• Description within limits

Step 4: Run Naming Convention Validator

Execute naming validator to check naming standards:

# Extract artifact name from path
ARTIFACT_NAME=$(basename "$ARTIFACT_PATH" .md)

# For commands, extract from frontmatter
if [ "$ARTIFACT_TYPE" = "command" ]; then
    ARTIFACT_NAME=$(grep -Po "^name:\s*\K.*" "$ARTIFACT_PATH" | head -1)
fi

"$VALIDATOR_DIR/naming-validator.sh" "$ARTIFACT_NAME" "$ARTIFACT_TYPE"
NAMING_EXIT_CODE=$?

if [ $NAMING_EXIT_CODE -eq 0 ]; then
    echo "✅ Naming convention validation passed"
    NAMING_STATUS="passed"
elif [ $NAMING_EXIT_CODE -eq 1 ]; then
    echo "❌ Naming convention validation failed"
    NAMING_STATUS="failed"
    NAMING_ERRORS=$(cat /tmp/naming-errors.txt 2>/dev/null || echo "See validator output above")
else
    echo "⚠️ Naming convention validation completed with warnings"
    NAMING_STATUS="passed_with_warnings"
fi

The naming validator checks:

• Artifact follows naming conventions (kebab-case, length, patterns)
• Commands follow plugin:command format
• Plugins have fractary- prefix
• No consecutive hyphens or invalid characters

Step 5: Run Cross-Reference Validator (Agents & Skills only)

For agents and skills, validate cross-references:

if [ "$ARTIFACT_TYPE" = "agent" ] || [ "$ARTIFACT_TYPE" = "skill" ]; then
    "$VALIDATOR_DIR/cross-reference-validator.sh" "$ARTIFACT_PATH" "$ARTIFACT_TYPE"
    CROSSREF_EXIT_CODE=$?

    if [ $CROSSREF_EXIT_CODE -eq 0 ]; then
        echo "✅ Cross-reference validation passed"
        CROSSREF_STATUS="passed"
    elif [ $CROSSREF_EXIT_CODE -eq 1 ]; then
        echo "⚠️ Cross-reference validation found missing references"
        CROSSREF_STATUS="passed_with_warnings"
        # Missing refs are warnings, not blockers (they may not be created yet)
    else
        echo "⚠️ Cross-reference validation completed with warnings"
        CROSSREF_STATUS="passed_with_warnings"
    fi
else
    # Commands don't have cross-references to validate
    CROSSREF_STATUS="skipped"
fi

The cross-reference validator checks:

• Agent references (@agent-plugin:name) exist
• Skill references (@skill-plugin:name) exist
• Reference format is correct

Step 6: Aggregate Results

Determine overall validation status:

OVERALL_STATUS="passed"

# Check for failures
if [ "$XML_STATUS" = "failed" ] || [ "$FRONTMATTER_STATUS" = "failed" ] || [ "$NAMING_STATUS" = "failed" ]; then
    OVERALL_STATUS="failed"
# Check for warnings
elif [ "$XML_STATUS" = "passed_with_warnings" ] || \
     [ "$FRONTMATTER_STATUS" = "passed_with_warnings" ] || \
     [ "$NAMING_STATUS" = "passed_with_warnings" ] || \
     [ "$CROSSREF_STATUS" = "passed_with_warnings" ]; then
    OVERALL_STATUS="passed_with_warnings"
fi

Step 7: Report Results

Output detailed validation report.

OUTPUT COMPLETION MESSAGE (Success):

✅ COMPLETED: Validate Artifact
Status: All validation checks passed
  ✅ XML markup valid
  ✅ Frontmatter valid
  ✅ Naming conventions valid
  ✅ Cross-references valid (or skipped)
  ✅ Standards compliance verified
───────────────────────────────────────
Next: Save and document the artifact

OUTPUT COMPLETION MESSAGE (Warnings):

⚠️ COMPLETED: Validate Artifact
Status: Passed with warnings
  ✅ XML markup valid
  ✅ Frontmatter valid
  ⚠️ Naming conventions have warnings
  ⚠️ Cross-references have warnings (missing references found)
───────────────────────────────────────
Next: Review warnings, then proceed

IF FAILURE:

❌ FAILED: Validate Artifact
Status: Validation errors found

XML Markup:
{xml_errors}

Frontmatter:
{frontmatter_errors}

Naming Conventions:
{naming_errors}

Resolution:
1. Review errors above
2. Fix violations in generated artifact
3. Re-run validation
4. Do not proceed until errors are resolved
───────────────────────────────────────