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

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

## role
Contains design specifications and test plans for upcoming features ("superpowers") being planned for the project.
## 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
- tool-container-home-directory-test-plan.md | Test plan and QA checklist for validating configurable home directory behavior in tool containers, covering manifest compilation, path expansion, database migrations, and mount target resolution. | dep: pytest, alembic, docker, compose, manifest compiler, instance service, ToolType, config profiles, git mounts
## arch
Document-driven architecture using dated Markdown design documents for feature specifications, plus standalone test plans for QA validation of complex features.
## tags
design, 2026, 05, branch, database, session, test, plan
## symbols
-
## workflows
-
## dirty
-