moai-foundation-specs

Validate SPEC YAML frontmatter fields and enforce HISTORY sections.

1|Updated Jul 28, 2025
One-click install
npx skills add https://github.com/kivo360/quickhooks --skill moai-foundation-specs-kivo360
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-foundation-specs
Source: https://github.com/kivo360/quickhooks/tree/main/.claude/skills/moai-foundation-specs
Command: npx skills add https://github.com/kivo360/quickhooks --skill moai-foundation-specs-kivo360

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces SPEC YAML frontmatter structure and HISTORY section across MoAI-ADK specs.

Core Features & Use Cases

  • Frontmatter Validation: Enforces 7 required fields
  • HISTORY Enforcement: Requires history entries and versioning
  • Integration: Aligns with TRUST 5 governance
  • Practical Guidance: Examples and templates

Quick Start

Validate a SPEC.md against the 7 required fields and verify HISTORY presence.

Frequently Asked Questions about moai-foundation-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate YAML frontmatter in my SPEC documentation?▼

SPEC YAML frontmatter validation enforces seven required fields and HISTORY section structure. Run validation against your SPEC.md to ensure compliance with MoAI-ADK standards and trigger automatic quality gates.

What are the seven required fields for SPEC frontmatter?▼

The Skill enforces seven mandatory YAML frontmatter fields in SPEC files. The exact field names are defined in the validation schema; refer to the SPEC template and documentation for the complete list and required formats.

How do I enforce HISTORY section requirements in my specs?▼

HISTORY enforcement validates versioning entries and audit trails within SPEC documents. The Skill requires history entries to be present and properly structured, integrating with TRUST 5 compliance checks during code reviews and feature design workflows.

Can I use SPEC validation with language detection in my project?▼

Yes. SPEC frontmatter validation integrates with moai-foundation-langs for automatic language detection and moai-foundation-trust for quality gates, enabling language-aware validation across foundation-domain projects.

What test coverage is required when using SPEC validation?▼

SPEC validation requires ≥85% test coverage enforced within a test-driven development workflow. This ensures quality gates pass during validation and maintains consistency across TRUST 5 compliance reviews.

When should I run SPEC validation—manually or automatically?▼

SPEC validation triggers automatically in code discussions and SPEC implementations. Manual reviews are recommended for TRUST 5 compliance checks, feature design decisions, and troubleshooting edge cases within foundation-domain projects.