moai-foundation-tags
TAG inventory management, scanning, and orphan detection (Consolidated from moai-alfred-tag-scanning).
When & Why to Use This Skill
The Foundation Tags skill is a specialized tool for TAG inventory management and orphan detection, designed to ensure code-first traceability and adherence to TRUST 5 principles. It automates the scanning of source directories to maintain high-quality standards, supports TDD workflows, and enforces best practices for foundation domains through automated quality gates.
Use Cases
- Orphan Detection: Automatically identify and resolve orphaned tags or disconnected code elements to reduce technical debt and maintain codebase cleanliness.
- Compliance Auditing: Review codebases for adherence to TRUST 5 principles and foundation domain best practices during the development lifecycle.
- Traceability Management: Maintain a robust inventory of tags across source directories to ensure full traceability between specifications and implementation.
- Quality Gate Enforcement: Integrate with TDD workflows to monitor test coverage (ensuring ≥85%) and validate code quality before deployment.
| 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