docs: specify repo name fallback

docs/superpowers/specs/2026-06-27-claude-project-tracking-repo-name-fallback-design.md

@@ -0,0 +1,29 @@
+# Claude Project Tracking Repository Name Fallback
+
+## Goal
+
+Ensure the `claude` shell wrapper always adds a normalized `project.name` to `OTEL_RESOURCE_ATTRIBUTES`, including when the current directory is not inside a Git repository.
+
+## Design
+
+The wrapper will determine a raw repository name before normalizing it:
+
+- Inside a Git work tree, use the existing Git-derived top-level directory name.
+- Outside a Git work tree, use the basename of the current working directory.
+
+Both paths will share one normalization step. It will lowercase the name, replace spaces with underscores, preserve letters, digits, underscores, and hyphens, and remove other characters. For example, `My Cool-Project!` becomes `my_cool-project`.
+
+The wrapper will then prepend `project.name=<normalized-name>` to an existing `OTEL_RESOURCE_ATTRIBUTES` value or create the variable when it is empty. Finally, it will invoke the real Claude Code binary with all original arguments.
+
+## Error Handling
+
+Git command failures outside a work tree are expected and will select the current-directory fallback. Existing behavior for invoking `command claude` remains unchanged.
+
+## Verification
+
+Automated shell checks will source the wrapper with a stubbed `claude` executable and verify:
+
+- A non-Git directory with spaces and punctuation produces the expected normalized project name.
+- An existing OTel attribute string is retained after the project name is prepended.
+- The wrapper forwards all arguments to the real command.
+- Existing Git-repository naming behavior remains intact.