diff --git a/packages/gittensory-engine/src/focus-manifest.ts b/packages/gittensory-engine/src/focus-manifest.ts
index 38677a31d..0468271b4 100644
--- a/packages/gittensory-engine/src/focus-manifest.ts
+++ b/packages/gittensory-engine/src/focus-manifest.ts
@@ -83,6 +83,10 @@ export type FocusManifestGateConfig = {
   pack: GatePolicyPack | null;
   linkedIssue: GateRuleMode | null;
   duplicates: GateRuleMode | null;
+  /** `gate.readiness.mode`/`gate.readiness.minScore` -- this engine-layer pair folds into
+   *  `RepositorySettings.qualityGateMode`/`qualityGateMinScore` (src/signals/focus-manifest.ts), a third
+   *  spelling of the same concept alongside the yml key name; the `readiness` gate is distinct from the
+   *  separate `mergeReadiness` composite gate above. */
   readinessMode: GateRuleMode | null;
   readinessMinScore: number | null;
   slopMode: GateRuleMode | null;