moai-foundation-tags
TAG inventory management, scanning, and orphan detection (Consolidated from moai-alfred-tag-scanning).
When & Why to Use This Skill
The moai-foundation-tags skill is a specialized developer utility designed for code-first tag inventory management, scanning, and orphan detection. It streamlines project traceability by enforcing TRUST 5 principles and best practices, ensuring that codebases remain clean, compliant, and well-documented through automated scanning and TDD workflow support.
Use Cases
- Automated Orphan Detection: Scan source directories to identify and eliminate unused or 'orphan' tags, reducing technical debt and maintaining codebase integrity.
- Compliance and Quality Audits: Review code for adherence to TRUST 5 principles and foundation domain best practices during the development or migration phase.
- Traceability Management: Maintain a comprehensive inventory of tags across complex projects to ensure full traceability from specification to implementation.
- TDD Workflow Integration: Generate test and lint execution plans based on tag metadata to support test-driven development and maintain high test coverage.
| name | moai-foundation-tags |
|---|---|
| version | 2.1.0 |
| created | 2025-10-22 |
| updated | 2025-11-05 |
| status | active |
| description | TAG inventory management, scanning, and orphan detection (Consolidated from moai-alfred-tag-scanning). |
| keywords | ['tag', 'inventory', 'traceability', 'code-first'] |
Foundation Tags Skill
Skill Metadata
| Field | Value |
|---|---|
| Skill Name | moai-foundation-tags |
| Version | 2.0.0 (2025-10-22) |
| Allowed tools | Read (read_file), Bash (terminal) |
| Auto-load | On demand when keywords detected |
| Tier | Foundation |
What It Does
TAG inventory management and orphan detection (CODE-FIRST principle).
Key capabilities:
- ✅ Best practices enforcement for foundation domain
- ✅ TRUST 5 principles integration
- ✅ Latest tool versions (2025-10-22)
- ✅ TDD workflow support
When to Use
Automatic triggers:
- Related code discussions and file patterns
- SPEC implementation (
/alfred:2-run) - Code review requests
Manual invocation:
- Review code for TRUST 5 compliance
- Design new features
- Troubleshoot issues
Inputs
- Language-specific source directories
- Configuration files
- Test suites and sample data
Outputs
- Test/lint execution plan
- TRUST 5 review checkpoints
- Migration guidance
Failure Modes
- When required tools are not installed
- When dependencies are missing
- When test coverage falls below 85%
Dependencies
- Access to project files via Read/Bash tools
- Integration with
moai-foundation-langsfor language detection - Integration with
moai-foundation-trustfor quality gates
References (Latest Documentation)
Documentation links updated 2025-10-22
Changelog
- v2.0.0 (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
- v1.0.0 (2025-03-29): Initial Skill release
Works Well With
moai-foundation-trust(quality gates)moai-alfred-code-reviewer(code review)moai-essentials-debug(debugging support)
Best Practices
✅ DO:
- Follow foundation best practices
- Use latest stable tool versions
- Maintain test coverage ≥85%
- Document all public APIs
❌ DON'T:
- Skip quality gates
- Use deprecated tools
- Ignore security warnings
- Mix testing frameworks