# Requirements Checklist: Managed Environment Terminology & Copy Cleanup

**Purpose**: Validate that Spec 298 preparation is bounded, implementation-ready, and constitution-aligned.  
**Created**: 2026-05-13  
**Feature**: [spec.md](/Users/ahmeddarrazi/Documents/projects/wt-plattform/specs/298-managed-environment-terminology-copy-cleanup/spec.md)

## Applicability And Low-Impact Gate

- [x] CHK001 The change explicitly affects operator-facing copy, localization values, tests, guards, and possible browser smoke anchors.
- [x] CHK002 The spec, plan, and tasks carry the same native/custom classification, shared-family relevance, state-layer ownership, and exception policy.

## Native, Shared-Family, And State Ownership

- [x] CHK003 The scope keeps existing Laravel/Filament/Blade surfaces and does not introduce a new custom UI system.
- [x] CHK004 No shared-detail or shared-family surface is replaced; labels and selectors are updated in place.
- [x] CHK005 Copy/value, page/action label, view text, test helper wording, guard regex descriptions, and browser selectors are named as separate state layers.
- [x] CHK006 Existing action hierarchy and inspect/open models remain unchanged unless an affected label needs a noun update.

## Shared Pattern Reuse

- [x] CHK007 The cross-cutting interaction classes are explicitly marked: localization, shell/context copy, action labels, guard tests, and browser anchors.
- [x] CHK008 The existing shared paths are named: localization arrays, `ManagedEnvironmentLinks`, `setAdminEnvironmentContext()`, and current guard/browser patterns.
- [x] CHK009 No parallel operator-facing vocabulary framework is introduced.

## OperationRun Start UX Contract

- [x] CHK010 The spec states that no new OperationRun start/completion/link behavior is introduced.
- [x] CHK011 Existing OperationRun UX/link contracts remain the owner if copy around operations is touched.
- [x] CHK012 No queued DB notification or terminal notification behavior changes are planned.

## Provider Boundary And Vocabulary

- [x] CHK013 Provider-owned terms such as Microsoft tenant ID and Entra tenant ID are allowed only when the external provider is the subject.
- [x] CHK014 Generic platform/operator vocabulary is required to use workspace, managed environment, environment, provider connection, operation, finding, review, evidence, and governance terms.

## Signals, Exceptions, And Test Depth

- [x] CHK015 Repository signals are classified as review-mandatory: final scans, guard literals, browser selector changes, localization value decisions, and destructive action label changes.
- [x] CHK016 Remaining tenant references must be documented in `terminology-audit.md` with explicit categories.
- [x] CHK017 Required surface test profiles are explicit: `standard-native-filament`, `global-context-shell`, and targeted `browser-smoke` only when touched.
- [x] CHK018 The chosen test lanes are focused and do not require a full-suite repair loop.

## Audience-Aware Disclosure And Decision Hierarchy

- [x] CHK019 Default-visible context copy must be environment-first while provider/raw/support details remain in existing disclosure tiers.
- [x] CHK020 Customer/read-only paths do not gain raw JSON, copied context payloads, fingerprints, or internal reason ownership.
- [x] CHK021 The spec does not add new primary actions; it only relabels existing actions where needed.
- [x] CHK022 Duplicate or contradictory tenant/environment wording is treated as drift to fix or document.

## Filament v5 Contract

- [x] CHK023 Filament v5 / Livewire v4.0+ compliance is explicit.
- [x] CHK024 Laravel 12 panel provider registration remains in `apps/platform/bootstrap/providers.php`.
- [x] CHK025 Globally searchable resource handling is called out for any touched resource.
- [x] CHK026 Destructive actions that are relabeled must retain `->action(...)`, `->requiresConfirmation()`, and authorization.
- [x] CHK027 Asset strategy is unchanged unless implementation unexpectedly registers assets, in which case `filament:assets` is required in deployment notes.
- [x] CHK028 Testing plan names affected pages/actions/guards/browser anchors.

## Review Outcome

- [x] CHK029 Review outcome class: `acceptable-special-case`.
- [x] CHK030 Workflow outcome: `keep`.
- [x] CHK031 Final note location: active feature PR close-out entry `Guardrail / Terminology Cleanup / Smoke Coverage`.

## Notes

- This is a cleanup spec, not a broad rename or localization foundation.
- Remaining provider/internal/historical tenant references are allowed only when categorized in the audit.