ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
platform-dev
TenantAtlas/specs/324-ui-productization-coverage-guardrails/checklists/requirements.md
ahmido e35706b846 Spec 324: add UI productization coverage guardrails (#384) 
## Summary
- add the Spec 324 package for UI Productization Coverage Guardrails, including spec, plan, tasks, and requirements checklist
- update Spec Kit templates and implementation prompts so future work must record UI surface impact, including navigation and Filament panel/provider surfaces
- harden the UI productization coverage guard script and add the validation helper for lightweight guard execution
- document the proportional guardrail flow in the UI/UX enterprise audit README

## Validation
- not run in this step
- change set is docs/tooling/governance only; no product runtime implementation included

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #384
2026-05-17 19:01:48 +00:00

2.6 KiB
Raw Permalink Blame History

Requirements Checklist - Spec 324

Purpose: Implementation acceptance checklist for Spec 324.
Created: 2026-05-17
Feature: specs/324-ui-productization-coverage-guardrails/spec.md

Scope

  • Spec remains governance/tooling/docs only.
  • No product runtime behavior is changed.
  • No UI redesign is implemented.
  • No business logic is changed.

Constitution

  • UI/Productization principle is present.
  • Constitution wording is concise.
  • Process detail remains in templates/scripts, not Constitution.

Templates

  • Spec template requires UI Surface Impact.
  • Spec template supports no-impact rationale.
  • UI-impacting specs must document coverage decisions.
  • Navigation changes are explicitly represented.
  • Filament panel/provider surface changes are explicitly represented.
  • Plan/tasks/checklist templates include guardrail checks.

Agent Prompts

  • Prompts require UI impact evaluation before implementation.
  • Prompts require coverage decision before completion.
  • Prompts describe proportional coverage.
  • Prompts include navigation/provider surface awareness.

Script

  • Script exists.
  • Script is executable.
  • UI-relevant path triggers are not too broad.
  • Script detects Filament paths.
  • Script detects Blade view paths.
  • Script detects Livewire paths.
  • Script detects routes.
  • Script detects apps/platform/app/Support/Navigation/.
  • Script detects apps/platform/app/Providers/Filament/.
  • Script does not trigger on all of apps/platform/app/Support/.
  • Script does not trigger on all of apps/platform/app/Providers/.
  • Coverage acknowledgment detection works.
  • Unchecked template headings and generic prompt/doc phrases do not satisfy guarded UI changes.
  • Failure message is clear.
  • No-impact rationale is supported.
  • Script avoids external dependencies.

Validation

  • bash -n scripts/check-ui-productization-coverage was run.
  • bash -n scripts/validate-ui-productization-coverage-guard was run.
  • bash scripts/validate-ui-productization-coverage-guard was run.
  • bash scripts/check-ui-productization-coverage HEAD was run.
  • git diff --check was run.
  • Full suite was intentionally not run.

Preparation Notes

  • This checklist is intentionally left as an implementation acceptance checklist, not a completed preparation-quality checklist.
  • The preparation pass found no open question that blocks implementation.
  • The later implementation pass should check these items off as the guardrail work is completed and validated.