# Gaf Schema Quality Gate

> Enforces GAF schema and allowed-value gates before data writes by validating planned payloads and status transitions against core-knowledge references. Use when implementing writes, updating statuses, or preparing for validation.

- Skill: `miguel-carrera/gaf-schema-quality-gate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add miguel-carrera/gaf-schema-quality-gate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/miguel-carrera/gaf-schema-quality-gate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: miguel-carrera (https://skillmd.com/u/miguel-carrera)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/miguel-carrera/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.