From 36c82293f9a48d0b35ea2fa7fcdba58f2f62f3d7 Mon Sep 17 00:00:00 2001 From: m3tm3re Date: Tue, 3 Feb 2026 20:09:15 +0100 Subject: [PATCH] Agent restructure --- skills/basecamp/SKILL.md | 341 ------------------------ skills/basecamp/references/mcp-tools.md | 198 -------------- 2 files changed, 539 deletions(-) delete mode 100644 skills/basecamp/SKILL.md delete mode 100644 skills/basecamp/references/mcp-tools.md diff --git a/skills/basecamp/SKILL.md b/skills/basecamp/SKILL.md deleted file mode 100644 index e00f42b..0000000 --- a/skills/basecamp/SKILL.md +++ /dev/null @@ -1,341 +0,0 @@ ---- -name: basecamp -description: "Manage work projects in Basecamp via MCP. Use when: (1) creating or viewing Basecamp projects, (2) managing todos or todo lists, (3) working with card tables (kanban boards), (4) searching Basecamp content, (5) syncing project plans to Basecamp. Triggers: basecamp, create todos, show my projects, card table, move card, basecamp search, sync to basecamp, what's in basecamp." -compatibility: opencode ---- - -# Basecamp - -Manage work projects in Basecamp via MCP server. Provides workflows for project overview, todo management, kanban boards, and syncing from plan-writing skill. - -## Quick Reference - -| Action | Command Pattern | -| --------------- | -------------------------------------- | -| List projects | "Show my Basecamp projects" | -| View project | "What's in [project name]?" | -| Create todos | "Add todos to [project]" | -| View card table | "Show kanban for [project]" | -| Move card | "Move [card] to [column]" | -| Search | "Search Basecamp for [query]" | -| Sync plan | "Create Basecamp todos from this plan" | - -## Core Workflows - -### 1. Project Overview - -List and explore projects: - -``` -1. get_projects → list all projects -2. Present summary: name, last activity -3. User selects project -4. get_project(id) → show dock items (todosets, card tables, message boards) -``` - -**Example output:** - -``` -Your Basecamp Projects: -1. Q2 Training Program (last activity: 2 hours ago) -2. Website Redesign (last activity: yesterday) -3. Product Launch (last activity: 3 days ago) - -Which project would you like to explore? -``` - -### 2. Todo Management - -**View todos:** - -``` -1. get_project(id) → find todoset from dock -2. get_todolists(project_id) → list all todo lists -3. get_todos(project_id, todolist_id) → show todos with status -``` - -**Create todos:** - -``` -1. Identify target project and todo list -2. For each todo: - create_todo( - project_id, - todolist_id, - content, - due_on?, # YYYY-MM-DD format - assignee_ids?, # array of person IDs - notify? # boolean - ) -3. Confirm creation with links -``` - -**Complete/update todos:** - -``` -- complete_todo(project_id, todo_id) → mark done -- uncomplete_todo(project_id, todo_id) → reopen -- update_todo(project_id, todo_id, content?, due_on?, assignee_ids?) -- delete_todo(project_id, todo_id) → remove -``` - -### 3. Card Table (Kanban) Management - -**View board:** - -``` -1. get_card_table(project_id) → get card table details -2. get_columns(project_id, card_table_id) → list columns -3. For each column: get_cards(project_id, column_id) -4. Present as kanban view -``` - -**Example output:** - -``` -Card Table: Development Pipeline - -| Backlog (3) | In Progress (2) | Review (1) | Done (5) | -|-------------|-----------------|------------|----------| -| Feature A | Feature B | Bug fix | ... | -| Feature C | Feature D | | | -| Refactor | | | | -``` - -**Manage columns:** - -``` -- create_column(project_id, card_table_id, title) -- update_column(project_id, column_id, title) → rename -- move_column(project_id, card_table_id, column_id, position) -- update_column_color(project_id, column_id, color) -- put_column_on_hold(project_id, column_id) → freeze work -- remove_column_hold(project_id, column_id) → unfreeze -``` - -**Manage cards:** - -``` -- create_card(project_id, column_id, title, content?, due_on?, notify?) -- update_card(project_id, card_id, title?, content?, due_on?, assignee_ids?) -- move_card(project_id, card_id, column_id) → move to different column -- complete_card(project_id, card_id) -- uncomplete_card(project_id, card_id) -``` - -**Card steps (subtasks):** - -``` -- get_card_steps(project_id, card_id) → list subtasks -- create_card_step(project_id, card_id, title, due_on?, assignee_ids?) -- complete_card_step(project_id, step_id) -- update_card_step(project_id, step_id, title?, due_on?, assignee_ids?) -- delete_card_step(project_id, step_id) -``` - -### 4. Search - -``` -search_basecamp(query, project_id?) -- Omit project_id → search all projects -- Include project_id → scope to specific project -``` - -Results include todos, messages, and other content matching the query. - -### 5. Sync from Plan-Writing - -When user has a project plan from plan-writing skill: - -``` -1. Parse todo-structure.md or tasks.md for task hierarchy -2. Ask: "Which Basecamp project should I add these to?" - - List existing projects via get_projects - - Note: New projects must be created manually in Basecamp -3. Ask: "Use todo lists or card table?" -4. If todo lists: - - Create todo list per phase/milestone if needed - - Create todos with due dates and assignees -5. If card table: - - Create columns for phases/statuses - - Create cards from tasks - - Add card steps for subtasks -6. Confirm: "Created X todos/cards in [project]. View in Basecamp." -``` - -### 6. Status Check - -``` -User: "What's the status of [project]?" - -1. get_project(id) -2. For each todo list: get_todos, count complete/incomplete -3. If card table exists: get columns and card counts -4. Calculate summary: - - X todos complete, Y incomplete, Z overdue - - Card distribution across columns -5. Highlight: overdue items, blocked items -``` - -**Example output:** - -``` -Project: Q2 Training Program - -Todos: 12/20 complete (60%) -- 3 overdue items -- 5 due this week - -Card Table: Development -| Backlog | In Progress | Review | Done | -| 3 | 2 | 1 | 8 | - -Attention needed: -- "Create training materials" (overdue by 2 days) -- "Review curriculum" (due tomorrow) -``` - -## Tool Categories - -For complete tool reference with parameters, see [references/mcp-tools.md](references/mcp-tools.md). - -| Category | Key Tools | -| ---------- | -------------------------------------------------------------- | -| Projects | get_projects, get_project | -| Todos | get_todolists, get_todos, create_todo, complete_todo | -| Cards | get_card_table, get_columns, get_cards, create_card, move_card | -| Card Steps | get_card_steps, create_card_step, complete_card_step | -| Search | search_basecamp | -| Comments | get_comments, create_comment | -| Documents | get_documents, create_document, update_document | - -## Limitations - -- **No create_project tool**: Projects must be created manually in Basecamp UI -- **Work projects only**: This skill is for professional/team projects -- **Pagination handled**: MCP server handles pagination transparently - -## Project Mapping Configuration - -### Map Basecamp Projects to PARA - -When setting up the integration, create a mapping between Basecamp projects and Obsidian project folders: - -**Example configuration** (to be customized): -```json -{ - "basecamp_projects": { - "project_123": { - "name": "API Integration Platform", - "para_path": "01-projects/work/api-integration-platform", - "area": "technical-excellence", - "type": "engineering" - }, - "project_456": { - "name": "Customer Portal Redesign", - "para_path": "01-projects/work/customer-portal-redesign", - "area": "technical-excellence", - "type": "product-design" - } - // ... add all projects - } -} -``` - -**Where to store**: -- Obsidian: `~/CODEX/_chiron/context/basecamp-projects.md` -- Or in skill: `references/basecamp-project-map.md` - -### Usage in Workflows - -When creating/syncing to Basecamp: - -``` -1. User mentions: "API Integration Platform" -2. Look up in project map: - - Get: project_id = "project_123" - - Get: para_path = "01-projects/work/api-integration-platform" -3. Use project_id for Basecamp operations -4. Use para_path for Obsidian operations -``` - -### Fetching Real Projects - -**When first setting up**: - -``` -User: "Fetch my Basecamp projects and set up PARA structure" - -Steps: -1. get_projects() → Get all Basecamp projects -2. For each project: - - Extract: id, name, status, last_activity - - Determine PARA path (kebab-case from name) - - Create project folder with _index.md - - Add frontmatter: basecamp_id, project_link -3. Create mapping in basecamp-projects.md -4. Confirm: "Mapped 10 Basecamp projects to PARA structure" -``` - -**Example project _index.md frontmatter**: -```yaml ---- -title: "[Project Name]" -basecamp_id: "project_123" -basecamp_url: "https://3.basecampapi.com/123456/projects/project_123" -status: active -deadline: YYYY-MM-DD -source: basecamp -tags: [work, project, engineering] ---- -``` - ---- - -## Integration with Other Skills - -| From Skill | To Basecamp | -| --------------- | ------------------------------------------------- | -| brainstorming | Save decision → reference in project docs | -| plan-writing | todo-structure.md → Basecamp todos or cards | -| task-management | Obsidian tasks ↔ Basecamp todos (manual reference) | -| daily-routines | Morning planning with Basecamp todos, evening review | -| meeting-notes | Sync action items from meetings to Basecamp | - -## Common Patterns - -### Create todos from a list - -``` -User provides list: -- Task 1 (due Friday) -- Task 2 (due next week) -- Task 3 - -1. Identify or confirm project and todo list -2. Parse due dates (Friday → YYYY-MM-DD) -3. Create each todo via create_todo -4. Report: "Created 3 todos in [list name]" -``` - -### Move cards through workflow - -``` -User: "Move Feature A to In Progress" - -1. search_basecamp("Feature A") or get_cards to find card_id -2. get_columns to find target column_id -3. move_card(project_id, card_id, column_id) -4. Confirm: "Moved 'Feature A' to 'In Progress'" -``` - -### Add subtasks to a card - -``` -User: "Add subtasks to the Feature B card" - -1. Find card via search or get_cards -2. For each subtask: - create_card_step(project_id, card_id, title) -3. Report: "Added X steps to 'Feature B'" -``` diff --git a/skills/basecamp/references/mcp-tools.md b/skills/basecamp/references/mcp-tools.md deleted file mode 100644 index 620fa3b..0000000 --- a/skills/basecamp/references/mcp-tools.md +++ /dev/null @@ -1,198 +0,0 @@ -# Basecamp MCP Tools Reference - -Complete reference for all 46 available Basecamp MCP tools. - -## Projects - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_projects` | none | List of all projects with id, name, description | -| `get_project` | project_id | Project details including dock (todosets, card tables, etc.) | - -## Todo Lists - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_todolists` | project_id | All todo lists in project | - -## Todos - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_todos` | project_id, todolist_id | All todos (pagination handled) | -| `create_todo` | project_id, todolist_id, content, due_on?, assignee_ids?, notify? | Created todo | -| `update_todo` | project_id, todo_id, content?, due_on?, assignee_ids? | Updated todo | -| `delete_todo` | project_id, todo_id | Success confirmation | -| `complete_todo` | project_id, todo_id | Completed todo | -| `uncomplete_todo` | project_id, todo_id | Reopened todo | - -### Todo Parameters - -- `content`: String - The todo text -- `due_on`: String - Date in YYYY-MM-DD format -- `assignee_ids`: Array of integers - Person IDs to assign -- `notify`: Boolean - Whether to notify assignees - -## Card Tables - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_card_tables` | project_id | All card tables in project | -| `get_card_table` | project_id | Primary card table details | - -## Columns - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_columns` | project_id, card_table_id | All columns in card table | -| `get_column` | project_id, column_id | Column details | -| `create_column` | project_id, card_table_id, title | New column | -| `update_column` | project_id, column_id, title | Updated column | -| `move_column` | project_id, card_table_id, column_id, position | Moved column | -| `update_column_color` | project_id, column_id, color | Updated color | -| `put_column_on_hold` | project_id, column_id | Column frozen | -| `remove_column_hold` | project_id, column_id | Column unfrozen | -| `watch_column` | project_id, column_id | Subscribed to notifications | -| `unwatch_column` | project_id, column_id | Unsubscribed | - -### Column Colors - -Available colors for `update_column_color`: -- white, grey, pink, red, orange, yellow, green, teal, blue, purple - -## Cards - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_cards` | project_id, column_id | All cards in column | -| `get_card` | project_id, card_id | Card details | -| `create_card` | project_id, column_id, title, content?, due_on?, notify? | New card | -| `update_card` | project_id, card_id, title?, content?, due_on?, assignee_ids? | Updated card | -| `move_card` | project_id, card_id, column_id | Card moved to column | -| `complete_card` | project_id, card_id | Card marked complete | -| `uncomplete_card` | project_id, card_id | Card reopened | - -### Card Parameters - -- `title`: String - Card title -- `content`: String - Card description/body (supports HTML) -- `due_on`: String - Date in YYYY-MM-DD format -- `assignee_ids`: Array of integers - Person IDs -- `notify`: Boolean - Notify assignees on creation - -## Card Steps (Subtasks) - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_card_steps` | project_id, card_id | All steps on card | -| `create_card_step` | project_id, card_id, title, due_on?, assignee_ids? | New step | -| `get_card_step` | project_id, step_id | Step details | -| `update_card_step` | project_id, step_id, title?, due_on?, assignee_ids? | Updated step | -| `delete_card_step` | project_id, step_id | Step deleted | -| `complete_card_step` | project_id, step_id | Step completed | -| `uncomplete_card_step` | project_id, step_id | Step reopened | - -## Search - -| Tool | Parameters | Returns | -|------|------------|---------| -| `search_basecamp` | query, project_id? | Matching todos, messages, etc. | - -- Omit `project_id` for global search across all projects -- Include `project_id` to scope search to specific project - -## Communication - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_campfire_lines` | project_id, campfire_id | Recent chat messages | -| `get_comments` | project_id, recording_id | Comments on any item | -| `create_comment` | project_id, recording_id, content | New comment | - -### Comment Parameters - -- `recording_id`: The ID of the item (todo, card, document, etc.) -- `content`: String - Comment text (supports HTML) - -## Daily Check-ins - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_daily_check_ins` | project_id, page? | Check-in questions | -| `get_question_answers` | project_id, question_id, page? | Answers to question | - -## Documents - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_documents` | project_id, vault_id | Documents in vault | -| `get_document` | project_id, document_id | Document content | -| `create_document` | project_id, vault_id, title, content, status? | New document | -| `update_document` | project_id, document_id, title?, content? | Updated document | -| `trash_document` | project_id, document_id | Document trashed | - -### Document Parameters - -- `vault_id`: Found in project dock as the docs/files container -- `content`: String - Document body (supports HTML) -- `status`: "active" or "archived" - -## Attachments - -| Tool | Parameters | Returns | -|------|------------|---------| -| `create_attachment` | file_path, name, content_type? | Uploaded attachment | - -## Events - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_events` | project_id, recording_id | Activity events on item | - -## Webhooks - -| Tool | Parameters | Returns | -|------|------------|---------| -| `get_webhooks` | project_id | Project webhooks | -| `create_webhook` | project_id, payload_url, types? | New webhook | -| `delete_webhook` | project_id, webhook_id | Webhook deleted | - -### Webhook Types - -Available types for `create_webhook`: -- Comment, Document, GoogleDocument, Message, Question::Answer -- Schedule::Entry, Todo, Todolist, Upload, Vault, Card, CardTable::Column - -## Common Patterns - -### Find project by name - -``` -1. get_projects → list all -2. Match name (case-insensitive partial match) -3. Return project_id -``` - -### Find todoset ID for a project - -``` -1. get_project(project_id) -2. Look in dock array for item with name "todoset" -3. Extract id from dock item URL -``` - -### Find card table ID - -``` -1. get_project(project_id) -2. Look in dock for "kanban_board" or use get_card_tables -3. Extract card_table_id -``` - -### Get all todos across all lists - -``` -1. get_todolists(project_id) -2. For each todolist: get_todos(project_id, todolist_id) -3. Aggregate results -```