Validate AIWG Package

Validate the structure and manifest of an addon, framework, or extension.

Usage

/devkit-validate <path> [options]

Arguments

Argument	Required	Description
path	Yes	Path to addon, framework, or extension

Options

Option	Description
--fix	Attempt to auto-fix common issues
--verbose	Show detailed validation output

What It Validates

Manifest Validation

• manifest.json

  exists
• Required fields present: id, type, name, version, description
• Type is valid: addon, framework, or extension
• For extensions:

  requires

  field specifies valid parent framework
• All referenced agents exist in agents/ directory
• All referenced commands exist in commands/ directory
• All referenced skills exist in skills/ directory
• All referenced templates exist in templates/ directory

Structure Validation

• Directory structure matches type expectations
• README.md exists
• Entry directories exist if specified
• No orphaned files (files not in manifest)

Content Validation

• Agent files have valid frontmatter (name, description, model, tools)
• Command files have valid frontmatter (name, description, args)
• Skill directories have SKILL.md with required fields

Extension-Specific Validation

• Parent framework exists
• Extension is in parent's extensions/ directory

• requires

  field matches parent location

Examples

# Validate addon
/devkit-validate agentic/code/addons/aiwg-utils

# Validate framework
/devkit-validate agentic/code/frameworks/sdlc-complete

# Validate extension
/devkit-validate agentic/code/frameworks/sdlc-complete/extensions/gdpr

# Validate with auto-fix
/devkit-validate agentic/code/addons/my-addon --fix

# Verbose output
/devkit-validate . --verbose

Output Format

Success

✓ Validating: agentic/code/addons/aiwg-utils
  Type: addon
  Version: 1.1.0

✓ Manifest: Valid
  - id: aiwg-utils
  - agents: 1 (1 found)
  - commands: 10 (10 found)
  - skills: 2 (2 found)

✓ Structure: Valid
  - agents/: OK
  - commands/: OK
  - skills/: OK

✓ Content: Valid
  - Agent frontmatter: OK
  - Command frontmatter: OK
  - Skill definitions: OK

═══════════════════════════════
VALIDATION PASSED
═══════════════════════════════

Failure

✓ Validating: agentic/code/addons/my-addon
  Type: addon
  Version: 1.0.0

✓ Manifest: Valid
  - id: my-addon

✗ Structure: Issues Found
  - agents/: Missing (manifest references 2 agents)
  - commands/: OK

✗ Content: Issues Found
  - Missing: agents/code-reviewer.md
  - Missing: agents/security-auditor.md

═══════════════════════════════
VALIDATION FAILED (2 errors)
═══════════════════════════════

Errors:
1. Directory 'agents/' does not exist
2. Referenced agent 'code-reviewer' not found

To fix, run: /devkit-validate <path> --fix

Auto-Fix Capabilities

When

--fix

is specified:

1. Create missing directories: agents/, commands/, skills/
2. Update manifest: Remove references to non-existent files
3. Add missing entries: Add files found in directories but not in manifest
4. Fix frontmatter: Add required fields with defaults

Related Commands

• /devkit-create-addon

  - Create new addon

• /devkit-create-extension

  - Create new extension

• aiwg validate

  - CLI validation tool

References

• @$AIWG_ROOT/agentic/code/addons/aiwg-dev/README.md — aiwg-dev addon overview
• @$AIWG_ROOT/docs/extensions/overview.md — Extension system architecture and manifest spec
• @$AIWG_ROOT/docs/extensions/extension-types.md — Full extension type reference
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference including validate-metadata command
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify before acting pattern