Gaf Schema Quality Gate

GAF Schema Quality Gate

Goal

Prevent invalid writes and status values by enforcing schema and dictionary checks during implementation and review.

Use This Skill When

• Task writes to DB, logs, queues, or object storage metadata.
• User asks for schema validation or quality gates.
• Phase 2 implementation adds new write paths.

Required References

• gaf-core-knowledge/schemas/db-tables.sql
• gaf-core-knowledge/schemas/allowed-values.md
• gaf-core-knowledge/storage-registry/data-dictionary.yaml (generated data-dictionary.md for human review)
• task manifest.yaml

Gate Procedure

1. Identify every write operation and payload shape.
2. Map each field to dictionary/schema definitions.
3. Validate enums/statuses against allowed values.
4. Confirm manifest declares all referenced storage/entities.
5. Flag missing or ambiguous mappings as blockers.

Output

• Pass or Fail.
• If fail, list blocking issues with:
  • write location
  • invalid/missing field
  • expected definition source
  • concrete remediation step

Guardrails

• No guessed schema fields.
• No bypass for undeclared storage access.
• If references are missing, require documentation update before implementation proceeds.