[codex] add Git identity personas design

[SamErde]

Summary

Adds an approved design spec for the next Personas compartment: Git identity personas for local desktop repositories.

Details

• Defines the v1 scope for synced Git persona catalog, repo-root bindings, identity audit, preview/apply, and post-apply verification.
• Keeps v1 bounded to local desktop repositories and repo-local Git config writes.
• Captures explicit non-goals and future v2 specs for identity webview editing, directory persona rules, profile associations, and signing/credential policies.

Validation

• Ran git diff --check successfully.
• Reviewed the spec for placeholders, contradictions, ambiguity, and scope creep.

Summary by CodeRabbit

• Documentation
  • Added a new design specification for “Git identity personas” (V1).
  • Covers auditing the effective user.name/user.email, creating personas from current identity, binding personas to repository roots, and applying identity changes locally.
  • Specifies storage and binding behavior, including preview/confirm flows, post-apply verification, and rollback protection against partial updates.
  • Details UX responsibilities, mismatch/error handling for common Git/workspace scenarios, and outlines planned future editor and rules features.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b880324e-9f76-4749-b472-d564bcad6e84

📥 Commits

Reviewing files that changed from the base of the PR and between 4dad7a2 and d9c2946.

📒 Files selected for processing (1)

• docs/superpowers/specs/2026-07-09-git-identity-personas-design.md

---

📝 Walkthrough

Walkthrough

Adds a new markdown design specification for Git Identity Personas, defining V1 scope, storage boundaries, data contracts, service responsibilities, user flows, error handling, testing expectations, and future roadmap items. No code changes are included.

Changes

Design Specification Document

Layer / File(s)	Summary
Scope and storage model docs/superpowers/specs/2026-07-09-git-identity-personas-design.md	Defines the document header, V1 goals and non-goals, and the separation between VS Code profile or extension state and Git identity storage rules.
Identity data contracts docs/superpowers/specs/2026-07-09-git-identity-personas-design.md	Defines Git persona, repo binding, and identity audit contracts, including provenance fields, environment override reporting, and repo-root normalization rules.
Services and command responsibilities docs/superpowers/specs/2026-07-09-git-identity-personas-design.md	Specifies PersonaCatalogService, RepoBindingService, GitIdentityService, and IdentityCommandController responsibilities, along with the sidebar home layout.
Audit, bind, and apply flows docs/superpowers/specs/2026-07-09-git-identity-personas-design.md	Defines the audit, create, bind, and apply flows, including repo selection, preview and confirmation, local git config writes, verification, rollback, and error handling.
Tests and future work docs/superpowers/specs/2026-07-09-git-identity-personas-design.md	Lists unit and integration-style test coverage expectations and the future spec areas for a webview editor, directory rules, persona associations, and signing or credential policy separation.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding a Git identity personas design spec.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/git-identity-personas-design

---

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Pull request overview

Adds an approved design spec describing the next Personas compartment: Git identity personas for local desktop repositories, covering scope, architecture, UX flows, storage, and testing approach for a v1 implementation.

Changes:

• Introduces a v1 design for a synced Git persona catalog plus local-only repo-root bindings.
• Specifies audit, preview/apply, and post-apply verification flows (including env override warnings).
• Documents explicit non-goals and future v2 directions (webview editor, directory rules, associations, signing/credentials).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/superpowers/specs/2026-07-09-git-identity-personas-design.md`:
- Around line 70-74: The RepoPersonaBinding definition currently uses repoRoot
directly as the binding key, but that can vary across symlinks and
case-insensitive paths. Update the binding flow around RepoPersonaBinding to
canonicalize repoRoot before it is stored or compared, and define a single
normalization rule up front so lookups always use the same normalized checkout
identity.
- Around line 122-127: The apply flow updates Git identity in two separate
writes, which can leave a partially applied state if one step fails. Update the
apply logic for the Git identity persona flow to be transactional by adding
rollback/revert handling or switching to a single atomic update path, and make
sure the change is implemented in the section that performs the `git config
--local` writes for `user.name` and `user.email`.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: c7ffca2f-1273-4413-b657-84a3a79b17f4

📥 Commits

Reviewing files that changed from the base of the PR and between c1203e5 and 4dad7a2.

📒 Files selected for processing (1)

• docs/superpowers/specs/2026-07-09-git-identity-personas-design.md