Liaison Workflows

Liaison Workflows

Complete guide to task management and workflow automation using the Liaison CLI.

When to use this skill

Use this skill when:

• Creating tasks with liaison task create
• Managing task status and lifecycle
• Working with task-driven workflows
• Setting up automatic workflow triggers
• Monitoring task completion and metrics

Task Management

Creating Tasks

Use liaison task create to create new tasks:

# Basic task
liaison task create "Fix security vulnerability"

# With description
liaison task create "Fix security vulnerability" --description "Patch XSS in login form"

# With priority
liaison task create "Fix security vulnerability" --priority critical

# With auto-trigger
liaison task create "Security audit required" --auto-trigger "security-response"

# With assignment
liaison task create "Review pull request" --assigned-to @username

Task Status

Check task status with liaison task list:

# List all tasks
liaison task list

# Filter by status
liaison task list --status closed

# Filter by priority
liaison task list --priority critical

# Output as JSON
liaison task list --format json

Updating Tasks

Update task status with liaison task update:

# Mark as in-progress
liaison task update TASK-ID --status in-progress

# Mark as completed
liaison task update TASK-ID --status closed

# Add assignee
liaison task update TASK-ID --assigned-to @username

Workflow Triggers

Priority-Based Auto-Triggers

Tasks automatically trigger workflows based on priority:

Example:

liaison task create "Critical security issue" --priority critical
# Automatically triggers security-response workflow

Keyword-Based Auto-Triggers

Tasks can specify which workflow to trigger:

liaison task create "Update documentation" --auto-trigger "documentation-update"

Available keywords:

• security → security-response workflow
• bug → bug-fix workflow
• production → deployment workflow
• documentation → documentation-update workflow
• testing → qa-testing workflow

Explicit Auto-Triggers

Force a specific workflow regardless of task content:

liaison task create "Custom task" --auto-trigger "custom-workflow"

Task-Driven Workflow Integration

Liaison implements complete task-driven workflow automation:

How It Works

1. Task Created → Event Emitted
2. Agentic Workflow Manager → Evaluates Triggers
3. Matches Found → Workflow Activated
4. Subtasks Created → Additional automation
5. Task Completed → Workflow Completes

Closed-Loop System

The system creates a virtuous cycle where work generates more work:

User Task → Workflow → Subtasks → More Tasks → More Workflows → ...

This enables:

• Self-Optimizing: The system continuously improves itself
• Scalable: Add more workflows, system scales automatically
• Reduced Manual Work: Automation handles repetitive tasks
• Faster Resolution: Specialized workflows respond faster

Workflow Types

Liaison supports multiple workflow types:

1. Security Response

Triggered by critical priority tasks handling security issues.

Auto-Created Subtasks:

• Investigation task
• Patch development task
• Verification task
• Deployment task

2. Bug Fix

Triggered by tasks containing "bug" or production keywords.

Auto-Created Subtasks:

• Reproduction task
• Fix development task
• Testing task
• Deployment task

3. Documentation Update

Triggered by documentation tasks.

Process:

• Update API docs
• Generate changelog
• Create pull request

4. High Priority Response

Triggered by high priority tasks.

Process:

• Acknowledge task
• Plan approach
• Execute within SLA
• Update status

5. Standard Workflow

Triggered by medium priority tasks.

Process:

• Queue task
• Assign to available agent
• Monitor progress
• Complete and report

6. Quality Assurance

Triggered by QA workflows.

Process:

• Run tests
• Review code
• Verify quality gates
• Report results

Workflow Configuration

Workflows are defined in configuration files. Create custom workflows:

# List available workflows
liaison workflow list

# Create new workflow
liaison workflow create "code-review" --trigger "task-created:tag=pull-request"

Monitoring Workflows

Track workflow execution:

# Workflow status
liaison workflow status

# Execution history
liaison workflow history --limit 10

Best Practices

Task Creation

1. Use Descriptive Titles

   ✅ Good: "Security: Fix XSS in login form"
   ❌ Bad: "Fix security thing"
   

2. Set Appropriate Priority

   --priority critical   # Security, production outages
   --priority high      # Production bugs, performance issues
   --priority medium     # Feature requests, improvements
   --priority low        # Documentation, minor fixes
   

3. Include Auto-Triggers Wisely

   # Good - Use specific workflows
   liaison task create "Add authentication" --auto-trigger "security-response"
   
   # Avoid - Don't over-trigger on everything
   # liaison task create "Update docs" --no-auto-trigger
   

4. Write Clear Descriptions

   # Good
   "Implement OAuth2 authentication using JWT tokens"
   
   # Bad
   "Auth stuff"
   

Workflow Management

1. Define Clear Triggers

   • Be specific about what activates a workflow
   • Use priority-based for critical issues
   • Use keyword matching for domain-specific workflows

2. Keep Workflows Focused

   • One workflow per purpose
   • Avoid overly complex multi-purpose workflows
   • Break complex workflows into smaller ones

3. Monitor Workflow Performance

   liaison workflow metrics
   liaison workflow history
   

`

4. Handle Workflow Failures
   • Always log failures
   • Create rollback procedures
   • Set up alerting for critical workflows

Duplicate Prevention

Tasks automatically check for duplicates before creation:

# Default behavior (checks for 80% similarity)
liaison task create "New feature"

# Bypass check (only use for intentional duplicates)
liaison task create "Known duplicate" --force-create

# Disable check entirely (batch operations)
liaison task create --no-check-duplicates task1 task2 task3

Common Patterns

Security Issue Handling

User: "Found security issue"

Process:
1. liaison task create "Investigate XSS vulnerability" --priority critical
2. Automatically triggers: security-response workflow
3. Workflow creates: investigation, patch, verification tasks
4. Complete verification → patch deployed

Feature Development

User: "Add user authentication"

Process:
1. liaison task create "Design auth system" --priority medium
2. liaison task create "Implement JWT tokens" --auto-trigger "development-workflow"
3. liaison task create "Write auth tests" --auto-trigger "qa-testing"
4. liaison task create "Deploy to staging" --auto-trigger "deployment-workflow"
5. Development workflow manages all subtasks automatically

Documentation Updates

User: "Update API docs"

Process:
1. liaison task create "Review current docs" --priority low
2. Development workflow triggers automatically
3. Documentation workflow processes all changes
4. Generate changelog and create PR

Integration with Other Skills

This skill works alongside other skills:

• Git Automation (.skills/git-automation/SKILL.md) - Version control for task tracking
• Library Research (.skills/library-research/SKILL.md) - Research for implementing new features
• Bun Development (.skills/bun-development/SKILL.md) - Using the right build tools

Workflow Example

Combining skills for complex automation:

User: "Add new user onboarding feature"

Automation:
1. [Liaison Workflows] Creates tasks for design, implementation, testing
2. [Git Automation] Creates feature branch with proper naming
3. [Library Research] Researches existing auth libraries
4. [QA Testing] Validates all changes
5. [Deployment Workflow] Deploys to staging
6. Automatic triggers coordinate all workflows

References

• Task-Driven Workflow Order
• Liaison CLI
• Workflow Commands
• Task Commands

Keywords

liaison, task, workflow, automation, task-driven, triggers, auto-trigger, subtasks, security, bug-fix, deployment, testing, qa, priorities, closed-loop