# 2026-05-23-remove-built-in-tools
dir: 2026-05-23-remove-built-in-tools

index: 2026-05-23-remove-built-in-tools/.pi-map.index.md

## role
This package contains design documents and planning artifacts for a refactoring initiative to eliminate special-case handling of built-in tool types by converting them to regular database records.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for removing built-in tool type special handling by migrating seeded data to regular database records via Alembic migration | dep: Alembic, SQLAlchemy/model layer, main.py startup logic, API layer, frontend
- proposal.md | Proposes a refactoring to eliminate the privileged "built-in" tool type classification and make all tool types equal, first-class database records | dep: ToolType model, main.py, tool_types.py API, database migration system, frontend
- tasks.md | Task checklist tracking the removal of `is_builtin` functionality from tool types across a full-stack application (database, backend, frontend, and testing) | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, PostgreSQL, pytest, ruff, mypy, React/frontend build system
## arch
Documentation-driven change management using a structured proposal pipeline (proposal → design → tasks → OpenSpec config) to coordinate a full-stack migration involving database schema changes (Alembic), backend API modifications, frontend updates, and test suite adjustments.
## tags
tool, type, design, database, alembic, frontend, .openspec, records
## symbols
-
## workflows
-
## dirty
-
