m3tam3re/AGENTS
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Agent restructure

Browse Source
This commit is contained in:
m3tm3re
2026-02-03 20:09:15 +01:00
parent 7e4a44eed6
commit 36c82293f9
2 changed files with 0 additions and 539 deletions
Download Patch File Download Diff File Expand all files Collapse all files

341
skills/basecamp/SKILL.md
View File

@@ -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'"
```

198
skills/basecamp/references/mcp-tools.md
View File

@@ -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
```