polylith-brick-removal

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

1. Delete the source code: Delete the brick's directory under components/<namespace>/<name> or bases/<namespace>/<name>.
2. Delete the tests: Delete the brick's test directory under test/components/<namespace>/<name> or test/bases/<namespace>/<name>.
3. Remove from projects: Search across all projects/*/pyproject.toml files and remove the brick from the [tool.polylith.bricks] section.
4. Remove from the development project: Remove the brick from the [tool.polylith.bricks] section in the root pyproject.toml (the development project).
5. 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.