diff --git a/docs/backend/manage-cards-spec.md b/docs/backend/004_manage_cards_spec.md similarity index 99% rename from docs/backend/manage-cards-spec.md rename to docs/backend/004_manage_cards_spec.md index e9434c7..744f15f 100644 --- a/docs/backend/manage-cards-spec.md +++ b/docs/backend/004_manage_cards_spec.md @@ -3,6 +3,7 @@ **Feature:** US: Manage Trello Cards **Issue:** #4 **Branch:** `feature/manage-cards` +**Doc:** 004 ## Overview diff --git a/docs/backend/manage-lists-spec.md b/docs/backend/manage-lists-spec.md deleted file mode 100644 index a1d2f1e..0000000 --- a/docs/backend/manage-lists-spec.md +++ /dev/null @@ -1,88 +0,0 @@ -# Trello Plugin — Manage Trello Lists - -**Feature:** US: Manage Trello Lists -**Issue:** #3 -**Branch:** `feature/manage-lists` - -## Overview - -Extends the Trello plugin with list management capabilities: create, rename, archive, and reposition lists on a Trello board. - -## Design Decisions - -- **Lists require a board context** — Creating a list needs a board ID. Other operations (rename, archive, move) use the list's Trello ID which is globally unique. -- **Position parameter** — Uses Trello's `pos` field which accepts `"top"`, `"bottom"`, or a positive number. - -## Tools - -### `trello_create_list` - -Create a new list on a board. - -**Parameters:** -| Param | Type | Required | Description | -|-------|------|----------|-------------| -| `name` | string | Yes | List name | -| `board_id` | string | Yes | Board ID or name | -| `pos` | string | No | Position: `"top"`, `"bottom"`, or number (default: `"bottom"`) | - -**Returns:** -```json -{"success": true, "list": {"id": "l1", "name": "My List", "id_board": "b1"}} -``` - -### `trello_rename_list` - -Rename an existing list. - -**Parameters:** -| Param | Type | Required | Description | -|-------|------|----------|-------------| -| `list_id` | string | Yes | List ID | -| `name` | string | Yes | New name | - -**Returns:** -```json -{"success": true, "list": {"id": "l1", "name": "Renamed List"}} -``` - -### `trello_archive_list` - -Archive a list. - -**Parameters:** -| Param | Type | Required | Description | -|-------|------|----------|-------------| -| `list_id` | string | Yes | List ID | - -**Returns:** -```json -{"success": true, "message": "List 'My List' archived."} -``` - -### `trello_move_list` - -Move a list to a different position. - -**Parameters:** -| Param | Type | Required | Description | -|-------|------|----------|-------------| -| `list_id` | string | Yes | List ID | -| `pos` | string | Yes | Position: `"top"`, `"bottom"`, or a number | - -**Returns:** -```json -{"success": true, "message": "List 'My List' moved."} -``` - -## Trello API Endpoints - -| Purpose | Method | Endpoint | -|---------|--------|----------| -| Create list | POST | `/1/lists` | -| Update list (rename, archive, move) | PUT | `/1/lists/{id}` | - -## Error Handling - -- List not found → clear error message -- Board not found when creating → propagate board lookup error \ No newline at end of file