# docs/superpowers/plans
dir: docs/superpowers/plans

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

## role
Contains architectural implementation plans and design documents for major system features and infrastructure changes.
## files
- 2024-05-16-docker-infrastructure.md | Plan for implementing a complete Docker-based development infrastructure with multi-service orchestration including PostgreSQL, Redis, Traefik, Authentik, FastAPI backend, and React frontend | dep: Docker, Docker Compose, Make, Python 3.11, Node.js 20, PostgreSQL, Redis, Traefik, Authentik, FastAPI, React, Vite, nginx, uvicorn, SQLAlchemy, alembic, pydantic
- 2026-05-17-auth-oauth.md | Implementation plan for adding Authentik-backed OIDC authentication with JWT access tokens and database-backed refresh tokens to a FastAPI application | dep: FastAPI, SQLAlchemy, Alembic, python-jose, httpx, pytest, PostgreSQL, Authentik
- 2026-05-17-database-models.md | Define an implementation plan for building SQLAlchemy 2.0 async database models with Alembic migrations and seed data for a FastAPI backend. | dep: SQLAlchemy 2.x, asyncpg, Alembic, pytest, pytest-asyncio, Pydantic Settings, PostgreSQL, FastAPI, superpowers:subagent-driven-development
- 2026-05-24-session-branch-selection.md | Implementation plan for replacing free-text branch input with a dropdown of available branches and adding "Create new branch" functionality in a session creation form | dep: React, TypeScript, FastAPI, Python, Git, subprocess, Pydantic
- tool-container-home-directory.md | Implementation plan for migrating tool containers from `/workspace` to configurable `/home/user` home directory with backward compatibility symlink and repository name preservation | dep: Alembic, Docker, Docker Compose, Python (SQLAlchemy, Jinja2), pytest, npm/TypeScript
## arch
Markdown-based technical specification documents using dated versioning, covering full-stack concerns (Docker orchestration, auth, database, UI/UX, container tooling) with detailed step-by-step implementation guidance for complex cross-cutting changes.
## tags
05, fastapi, 2026, plan, docker, alembic, postgresql, authentik
## symbols
-
## workflows
-
## dirty
-
