# docs/superpowers/specs
dir: docs/superpowers/specs

index: docs/superpowers/specs/.pi-map.index.md

## role
Contains design specification documents for planned system features, serving as architectural decision records for authentication and session management capabilities.
## files
- 2026-05-17-auth-oauth-design.md | Design document for implementing OAuth2/OIDC authentication with Authentik, internal JWT access tokens, and database-backed refresh token rotation. | dep: Authentik, JWKS, JWT, database/PostgreSQL, cookies, pytest, mypy, ruff
- 2026-05-24-session-branch-selection-design.md | Design document for replacing free-text branch input with a dropdown of available branches and adding the ability to create a new local branch at clone time in a session creation UI. | dep: React/TypeScript frontend, Python/FastAPI backend, Git, API client, ToolInstance database model
## arch
Markdown-based technical design documentation following a chronological naming convention (YYYY-MM-DD-feature-name-design.md) with no executable code, using a lightweight specification format for capturing requirements, decisions, and implementation plans before development.
## tags
design, 2026, 05, branch, session, document, authentik, jwt
## symbols
-
## workflows
-
## dirty
-
