Files
feature-control/docs/canon-interface-card.md
tegwick 571e2f7127 feat(bootstrap): finish FEATURE-WP-0001 State Hub integration workstream
- T01 (Review Generated Integration Files): Reviewed INTENT.md, SCOPE.md, AGENTS.md, .custodian-brief.md. Refined SCOPE.md (removed generic generated placeholder, added repo-specific In/Out Scope, Current State noting completion of WP-0001 and WP-0002, canon alignment). Refined README.md with links to canon-mapping and workplans. Confirmed INTENT and AGENTS already specific.
- T02 (Verify Local Developer Workflow): Confirmed pure-docs repo (no build/test files). Added 'Local Developer Workflow' section to AGENTS.md documenting verification commands (cat/ls for review, hub curls, make fix-consistency from state-hub, progress POSTs) and extension guidance.
- Updated FEATURE-WP-0001 workplan: T01/T02 marked done with detailed notes; frontmatter status set to finished.
- Includes completion of FEATURE-WP-0002 (canon alignment for PRD/UCC, docs/canon-mapping.md + interface card stub, terminology updates with EvaluationScope and ITC mappings).
- Ran make fix-consistency REPO=feature-control after changes (synced hub, set workstreams to finished).

All per AGENTS.md session protocol, workplan instructions, and custodian brief.

Bootstrap workstream now 3/3 complete; no active workstreams remaining.
2026-06-14 21:24:46 +02:00

44 lines
2.2 KiB
Markdown

# 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.