projects

# Projects Operate on Plane projects. For initial creation with Agile defaults use `/setup-project`. ## Arguments Format: `<action> [args...]` - `action`: `list` | `get` | `update` | `archive` | `unarchive` | `delete` | `features` - For `get`/`update`/`delete`/`features`: project name or identifier - For `update`: `--name`, `--identifier <SLUG>`, `--description`, `--icon` (the `emoji` field), `--lead <user>` (`project_lead`), `--default-assignee <user>`, `--time-tracking on|off` - For `features`: `--enable cycles,modules,epics,intakes,pages,views,workitem_types` or `--disable ...` (also `parallel_cycles`, `project_updates`, `workflows`) Parse from `"$ARGUMENTS"`. ## Process 1. **Bootstrap connector** — consult `connector-bootstrap`. Probe for the Plane resource tools `project` and `member`. 2. **Route**: - `list` → `project(action=list)` (paginated: follow `next_cursor`; the list is trimmed, use `retrieve` for full detail). Render: identifier | name | lead | members | cycles? | modules? | last activity. Highlight archived. - `get` → `project(action=retrieve, project_id)` + `member(action=list_project, project_id)` member count + `project(action=get_features, project_id)` + active cycle count (`cycle(action=list, project_id, status=current)`). - `update` → `project(action=update, project_id, ...)`. Changing `identifier` rewrites all work item IDs (`OLD-42` → `NEW-42`) — warn loudly before doing this. `--time-tracking` sets `is_time_tracking_enabled`. - `archive` / `unarchive` → `project(action=archive|unarchive, project_id)`: the safer alternative to delete. - `delete` → **destructive** (the whole project with its work items, cycles, modules and pages). Confirm with project name typed back. Suggest `archive` as the safer alternative. `project(action=delete, project_id)`. - `features` → `project(action=get_features, project_id)` first, show current state, then `project(action=update_features, project_id, <flag>=true|false, ...)`; omitted flags are left as they are. Flags: cycles, modules, views, pages, intakes (the triage inbox), workitem_types, epics, parallel_cycles, project_updates, workflows. Time tracking is not a feature flag: it is `project(action=update, is_time_tracking_enabled=...)`. A plan without a feature refuses the call with a message naming it. 3. **Confirm** — print result. ## Examples ``` /projects list /projects get "TaskFlow" /projects update "TaskFlow" --lead alice --description "Customer-facing checkout app" /projects features "TaskFlow" --enable intakes,pages,modules /projects delete "Old Sandbox" ``` ## Best Practices - Don't rename project `identifier` after launch — every existing reference (commits, PR titles, Slack threads) breaks. - Disable unused features — clutter in the sidebar slows everyone down. Most teams need: cycles, modules, pages, views. - Use `/projects features` to enable `intakes` before running `/triage-intake`.