polylith-brick-removal - SKILL.md Agent Skill

name: polylith-brick-removal description: Safely remove a Polylith brick (component or base) from the workspace. Use when the user wants to delete, remove, or tear down a component or base.

Brick Removal Skill

💡 Terminology: this skill uses Polylith terms like brick, component, base, and development project. If they're unfamiliar, load polylith-concepts first.

There is no poly remove CLI command. Removing a brick is a manual process.

Steps to remove a brick

Delete the source code: Delete the brick's directory under components/<namespace>/<name> or bases/<namespace>/<name>.
Delete the tests: Delete the brick's test directory under test/components/<namespace>/<name> or test/bases/<namespace>/<name>.
Remove from projects: Search across all projects/*/pyproject.toml files and remove the brick from the [tool.polylith.bricks] section.
Remove from the development project: Remove the brick from the [tool.polylith.bricks] section in the root pyproject.toml (the development project).
Sync and Check: Run poly sync (load polylith-sync) and poly check (load polylith-check) to ensure the workspace is valid and no other bricks were importing the deleted brick.

Notes for the agent

Always use your directory and file tools to verify the paths before deleting.
If poly check fails after removal, it means another brick was depending on the removed brick. You must fix the importing brick.