feature-control/docs/canon-interface-card.md

44 lines
2.2 KiB
Markdown
Raw Normal View History

# feature-control — Canon Interface Card (Stub)
**Status:** draft (per FEATURE-WP-0002 T09)
**Date:** 2026-06-14
**Based on:** info-tech-canon/infospace/agent/briefs/consumer-brief.template.md and interface-card.schema.yaml
## Produced Concepts
- Feature (as ProducerCapability specialization + availability control)
- FeatureKey
- EvaluationScope / TargetingScope (EvaluationContext dimension)
- FeatureDecision (with rich states, reasons)
- FeatureAvailability / states
- Feature registry & lifecycle hygiene patterns
- Multi-signal composition (entitlement + kill + policy + etc.)
## Consumed Concepts (from InfoTechCanon)
- ITC-ORG: Actor, Agent, Membership, Organization/Unit, Ownership, Tenant patterns
- ITC-ACCESS: Entitlement, Grant, AuthorizationDecision, Subject/Principal
- ITC-LAND: Environment, Deployment, Service, Repository, RuntimeResource
- ITC-GOV: Decision, Control, Evidence, Policy, ProducerCapability, ScopePressure, PurposeFit
- ITC-TaggingStandard: for feature categories
- ITC-TASK: for reviews, expiry, stale-flag cleanup, remediation
## Purpose / Consumer Demand
- Low-impact OpenFeature-based adoption for repos (agentic + human devs)
- Compute governance and cost control via capability flags
- Operational safety (kill switches, degraded modes)
- Agent capability gating (with separate authz)
- Multi-tenant / multi-vendor / multi-scope availability without hard-coding
## Scope Pressure / Evolution Requests
- Need for first-class Feature/FeatureAvailability in canon (currently extension candidate)
- Clarification on EvaluationScope vs producer-scope terminology
- Interface for feature registry export to repos (GitOps + generated constants)
- Patterns for multi-signal decision composition
## References
- docs/canon-mapping.md (primary detailed mapping)
- workplans/FEATURE-WP-0002-canon-prd-ucc-alignment.md
- specs/ProductRequirementsDocument.md and UseCaseCatalog.md (canon-aligned)
- info-tech-canon/infospace/ (models, evaluations, schemas)
- OpenFeature spec for the repo integration surface
This stub can be expanded into a full consumer brief or validated against canon review-kit once ITC-WP-0011 stabilizes. See FEATURE-WP-0002 T08/T09 for extension proposals.