Init Manager

Init Manager Skill

This skill enables AI agents to work with Init Manager as a project management backend — picking up tasks, doing work, and closing them out.

Setup

Your workspace needs these in TOOLS.md or environment:

• Init Manager URL (e.g. https://manager.init.hr)
• API Key (Bearer token, starts with initm_)
• Your User ID (UUID)

AI Guides (Instruction Hierarchy)

There are three levels of AI instructions. Always follow them. More specific wins on conflict:

1. Global AI Guide — GET /api/settings?key=ai_global_guide
2. Per-User AI Guide — GET /api/users/<your-user-id> → aiGuide field
3. Project AI Guide — GET /api/projects/<project-id> → aiGuide field

On first boot and periodically: fetch all three and follow the combined instructions.

Task Workflow

1. Pick up tasks in ready status assigned to you
2. Move to in_progress before starting work
3. Read full description + all comments + project AI guide before writing code
4. If unsure — comment asking for clarification, keep in ready, assign to a human
5. When done — move to done, add comment with commit/PR link + summary
6. If blocked — comment with details, assign to a human

API Reference

Authentication

All requests need:

Authorization: Bearer initm_<your-key>

Key Endpoints

Create a Task

POST /api/tasks
{
  "projectId": "<uuid>",
  "title": "Task title",
  "type": "task",           // epic | task | bug
  "status": "backlog",      // backlog | ready | in_progress | done | verified
  "priority": "medium",     // low | medium | high | urgent
  "description": "...",     // plain text or Tiptap JSON
  "parentId": "<uuid>",     // optional, makes subtask
  "dueDate": "2026-03-01T00:00:00.000Z"
}

Update a Task

PATCH /api/tasks/<id>
{
  "status": "in_progress",
  "title": "New title",
  "priority": "high"
}

All fields optional — only include what changes.

Add a Comment

POST /api/tasks/<id>/comments
{
  "body": "Your comment text"
}

⚠️ Use body field, not content.

Assign a User

POST /api/tasks/<id>/assign
{ "userId": "<uuid>" }

Labels

GET    /api/labels?projectId=<uuid>
POST   /api/labels                        { "name": "Bug", "color": "#ef4444", "projectId": "<uuid>" }
POST   /api/tasks/<id>/labels             { "labelId": "<uuid>" }
DELETE /api/tasks/<id>/labels             { "labelId": "<uuid>" }

Behavior Notes

• Assignments auto-complete when task moves to done or verified
• Moving task back to ready/backlog clears notification flags and assignment completion
• Comments created via API are flagged viaApi: true
• Task keys (e.g. IMG-32) are auto-generated from project prefix

Error Responses

{ "error": "Description" }

Common Workflow: Check for Tasks

# Get all projects
curl -H "Authorization: Bearer $KEY" $URL/api/projects

# Check each project board for ready tasks assigned to you
curl -H "Authorization: Bearer $KEY" $URL/api/projects/$PID/board

# Pick up a task
curl -X PATCH -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"status":"in_progress"}' $URL/api/tasks/$TID

# ... do the work ...

# Close it out
curl -X PATCH -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"status":"done"}' $URL/api/tasks/$TID

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"body":"Done. Commit: https://..."}' $URL/api/tasks/$TID/comments