jmagly 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.jsonexists - Required fields present: id, type, name, version, description
- Type is valid: addon, framework, or extension
- For extensions:
requiresfield 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
-
requiresfield 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:
- Create missing directories: agents/, commands/, skills/
- Update manifest: Remove references to non-existent files
- Add missing entries: Add files found in directories but not in manifest
- Fix frontmatter: Add required fields with defaults
Related Commands
/devkit-create-addon- Create new addon/devkit-create-extension- Create new extensionaiwg validate- CLI validation tool
References
- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/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