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

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