feat(#26): implement mosaic-plugin-gantt skill
This commit is contained in:
91
packages/skills/gantt/README.md
Normal file
91
packages/skills/gantt/README.md
Normal file
@@ -0,0 +1,91 @@
|
||||
# Mosaic Stack Gantt Plugin
|
||||
|
||||
Clawdbot skill for querying and analyzing project timelines, task dependencies, and schedules from Mosaic Stack's Gantt/Project API.
|
||||
|
||||
## Features
|
||||
|
||||
- Query project timelines and task lists
|
||||
- Check task dependencies and blocking relationships
|
||||
- Get project status overviews with statistics
|
||||
- Identify critical path items in projects
|
||||
- PDA-friendly language (supportive, non-judgmental)
|
||||
|
||||
## Installation
|
||||
|
||||
1. **Copy skill to Clawdbot plugins directory:**
|
||||
```bash
|
||||
cp -r ~/src/mosaic-skills/gantt ~/.claude/plugins/mosaic-plugin-gantt
|
||||
```
|
||||
|
||||
2. **Set up environment variables:**
|
||||
|
||||
Add to your `.env` or shell profile:
|
||||
```bash
|
||||
export MOSAIC_API_URL="http://localhost:3000/api"
|
||||
export MOSAIC_WORKSPACE_ID="your-workspace-uuid"
|
||||
export MOSAIC_API_TOKEN="your-api-token"
|
||||
```
|
||||
|
||||
3. **Verify installation:**
|
||||
```bash
|
||||
~/.claude/plugins/mosaic-plugin-gantt/gantt-api.sh projects
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
### Via Clawdbot
|
||||
|
||||
Once installed, you can ask Clawdbot:
|
||||
|
||||
- "Show me the timeline for Project Alpha"
|
||||
- "What blocks task 'Implement Auth'?"
|
||||
- "What's the critical path for Q1 release?"
|
||||
- "Show all high-priority tasks due this week"
|
||||
- "Give me a status overview of Project Beta"
|
||||
|
||||
### Via Command Line
|
||||
|
||||
The `gantt-api.sh` helper script can be used directly:
|
||||
|
||||
```bash
|
||||
# List all projects
|
||||
./gantt-api.sh projects
|
||||
|
||||
# Get project details with tasks
|
||||
./gantt-api.sh project <project-id>
|
||||
|
||||
# Get tasks for a project
|
||||
./gantt-api.sh tasks <project-id>
|
||||
|
||||
# Get task details
|
||||
./gantt-api.sh task <task-id>
|
||||
|
||||
# Get dependency chain for a task
|
||||
./gantt-api.sh dependencies <task-id>
|
||||
|
||||
# Calculate critical path for a project
|
||||
./gantt-api.sh critical-path <project-id>
|
||||
|
||||
# Find tasks by status
|
||||
./gantt-api.sh status IN_PROGRESS
|
||||
./gantt-api.sh status COMPLETED <project-id>
|
||||
```
|
||||
|
||||
## API Reference
|
||||
|
||||
### Endpoints
|
||||
|
||||
- `GET /api/projects` - List projects (paginated)
|
||||
- `GET /api/projects/:id` - Get project with tasks
|
||||
- `GET /api/tasks` - List tasks with filters
|
||||
- Query params: `projectId`, `status`, `priority`, `assigneeId`, `page`, `limit`
|
||||
|
||||
### Authentication
|
||||
|
||||
All requests require headers:
|
||||
- `X-Workspace-Id`: Workspace UUID
|
||||
- `Authorization`: Bearer {token}
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user