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

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

## role
Contains technical design specifications and test plans for upcoming features, serving as the project's architectural decision record and implementation blueprint repository.
## files
- 2026-05-17-auth-oauth-design.md | Design document for implementing OAuth2/OIDC authentication via Authentik with internal JWT access tokens, DB-backed refresh token rotation, and secure cookie handling. | dep: Authentik, JWT library, database/ORM, web framework (implied), JWKS client, cookie handling library
- 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, Python, FastAPI, Pydantic, Git, API client, ToolInstance model
- tool-container-home-directory-test-plan.md | This file is a comprehensive QA test plan for validating a configurable home directory feature in tool containers, covering unit tests, integration tests, manual QA checklist, and exit criteria for the implementation. | dep: pytest, alembic, docker, compose, manifest compiler, instance service, git mounts, config profiles, ToolType, workspace mounts, entrypoint permission fixer
## arch
Markdown-based documentation with date-prefixed design documents following a chronological naming convention, plus standalone test plans; each spec isolates a single feature concern (auth, session UI, container configuration) with no code dependencies between documents.
## tags
design, 2026, 05, branch, session, test, plan, home
## symbols
-
## workflows
-
## dirty
-