# SCOPE

## One-liner

Orthogonal vocabulary and canonical model for identity-related concepts.

## Core Idea

`identity-canon` is a research and terminology repository. It defines an
implementation-neutral vocabulary and conceptual model for identity, accounts,
actors, organizations, tenants, communities, families, agents, relationships,
and synonymity across IAM, directory, federation, social graph, authorization,
decentralized identity, and entity-resolution domains.

## In Scope

- Maintain research notes, source summaries, terminology inventories,
  conflict maps, canonical glossary entries, conceptual model notes, scenario
  tests, open questions, downstream recommendations, and State Hub workplans.
- Compare overlapping terms across standards, product documentation, social
  graph models, authorization systems, and privacy/entity-resolution research.
- Keep canonical definitions separate from external product mappings.
- Record decisions, progress, and workplan status through State Hub.
- Verify changes with markdown review, `git diff --check`, and ADR-001
  consistency checks.

## Out of Scope

- Implement identity providers, account-management services, provisioning
  adapters, authorization engines, UI components, CLI commands, databases, or
  production APIs.
- Own unrelated adjacent systems or operational identity lifecycle tooling.
- Make irreversible operational decisions without human approval.
- Treat draft canon artifacts as finalized schemas before source-note backfill
  and scenario review.

## Current State

- Status: active research scaffold.
- The repository is currently documentation-only. It has no package manifest,
  build system, runtime app, or executable test suite.
- `IDENTITY-WP-0002` seeded the first terminology, canon, model, scenario,
  open-question, and downstream recommendation artifacts. The next research
  pass should backfill individual source notes and revise the draft canon from
  evidence.

## Getting Oriented

- Start with: INTENT.md
- Research proposal: ResearchProposal.md
- Corpus index: research/CorpusIndex.md
- Draft canon: canon/CanonicalGlossary.md and model/ConceptualModel.md
- Agent instructions: AGENTS.md
- Workplans: workplans/