headquarter/docs/superpowers/specs/.pi-map.md

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