# Manual Identity Migration

> A technique for renaming files one container at a time by hand, re-pointing each pattern and comparing what each aggregator collects before and after.

Record: `architecture:manual-identity-migration`
Kind: technique
Layer: [Structural Core](https://banes-lab.com/records/layer/structural-core.md)
Severity: mandatory
Scope: repository, refactor
Canonical: https://banes-lab.com/ontology#architecture-manual-identity-migration

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Set-Relative Member Name](https://banes-lab.com/records/architecture/set-relative-member-name.md) and before [Collision Consolidation](https://banes-lab.com/records/architecture/collision-consolidation.md).

## Repair

- Refactored by: Re-point the Pattern, Verify the Collected Count
- Detected by: a shape-discovered surface whose collected count changed across a rename
- Violated by: renaming by tool across a tree whose aggregators resolve by pattern
- Measured by: collected-member delta per aggregator
- Enforced by: per-container reshape review, gate green between containers

## Requires

- [Identity Migration](https://banes-lab.com/records/lexicon/identity-migration.md)
- [Shape-Discovered Surface](https://banes-lab.com/records/lexicon/shape-discovered-surface.md)
- [Conversion Record](https://banes-lab.com/records/lexicon/conversion-record.md)
- [Alignment Entry](https://banes-lab.com/records/lexicon/alignment-entry.md)
- [Re-Alignment Cadence](https://banes-lab.com/records/lexicon/re-alignment-cadence.md)
- [Frozen Baseline](https://banes-lab.com/records/lexicon/frozen-baseline.md)
- [Unreferenced Export Triage](https://banes-lab.com/records/lexicon/unreferenced-export-triage.md)

## Reinforces

- [Container-by-Container Reshape](https://banes-lab.com/records/lexicon/container-by-container-reshape.md)

## Enables

- [Maintainability](https://banes-lab.com/records/lexicon/maintainability.md)

## Conflicts with

- [Automated Reshape](https://banes-lab.com/records/lexicon/automated-reshape.md)

## Contracts

- [Reshape Risk Priority](https://banes-lab.com/records/algorithms/reshape-risk-priority.md)
- [Container Reshape](https://banes-lab.com/records/algorithms/container-reshape.md)
- [Export Triage Ladder](https://banes-lab.com/records/algorithms/export-triage-ladder.md)
- [Alignment Cadence](https://banes-lab.com/records/algorithms/alignment-cadence.md)

## Severity

- [mandatory](https://banes-lab.com/records/vocabulary/severity-mandatory.md)

## Category

- [Taxonomy / Classification / Naming](https://banes-lab.com/records/architecture-category/taxonomy-classification-naming.md)

## Linked from

- [Placement is a grammar](https://banes-lab.com/disciplined-methodology/build/placement-is-a-grammar.md)
- [Moves and renames](https://banes-lab.com/disciplined-methodology/verify/moves-and-renames.md)
- [Quality Attributes](https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md)
- [Taxonomy / Classification / Naming](https://banes-lab.com/ontology/lexicon/lexicon-category-taxonomy-classification-naming.md)
- [Taxonomy](https://banes-lab.com/ontology/algorithms/algorithms-domain-taxonomy.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
