Skill: Activity Log

Purpose

Log and track all agent activities, providing visibility into agent communications, actions, and workflow progress.

When to Use

• Workflow coordination
• Debugging issues
• Audit trail maintenance
• Progress tracking
• Handoff documentation
• Stakeholder updates

---

Activity Types

Action Categories

Type	Code	Description	Example
Receive	RECV	Agent receives input	Request from stakeholder
Analyze	ANLZ	Agent analyzes information	Requirements analysis
Decision	DECN	Agent makes a decision	Story prioritization
Create	CREA	Agent creates artifact	Jira ticket created
Update	UPDT	Agent updates artifact	Story modified
Handoff	HAND	Agent transfers to another	BA → PO
Escalate	ESCL	Agent escalates issue	Needs stakeholder input
Complete	COMP	Agent completes task	Workflow step done
Block	BLCK	Agent encounters blocker	Missing information

---

Log Entry Structure

Standard Entry Format

interface ActivityLogEntry {
  // Identity
  id: string;                    // Unique entry ID
  timestamp: string;             // ISO 8601 timestamp
  session_id: string;            // Workflow session

  // Agent
  agent: string;                 // Agent name
  agent_icon: string;            // Agent emoji

  // Action
  action_type: ActivityType;     // RECV, ANLZ, DECN, etc.
  action_description: string;    // Human-readable description

  // Context
  workflow?: string;             // Parent workflow
  related_tickets?: string[];    // Jira tickets
  related_docs?: string[];       // Confluence pages

  // Details
  input?: any;                   // What triggered this
  output?: any;                  // What was produced
  decision?: DecisionRecord;     // If decision was made

  // Handoff
  target_agent?: string;         // If handoff
  handoff_context?: string;      // Context passed

  // Metadata
  duration_ms?: number;          // Time spent
  status: 'success' | 'pending' | 'blocked' | 'failed';
}

---

Logging Operations

Log an Action

## Log Action

**Agent:** {{agent_name}}
**Type:** {{action_type}}
**Description:** {{description}}

**Context:**
{{context_details}}

**Artifacts:**
- {{artifact_list}}

**Next:** {{next_action}}

Log a Handoff

## Log Handoff

**From:** {{source_agent}}
**To:** {{target_agent}}
**Time:** {{timestamp}}

**Work Completed:**
{{completed_work}}

**Artifacts Transferred:**
- {{artifacts}}

**Context for Next Agent:**
{{handoff_context}}

**Decisions Made:**
{{decisions_summary}}

**Open Items:**
{{open_items}}

Log a Blocker

## Log Blocker

**Agent:** {{agent_name}}
**Blocked At:** {{timestamp}}
**Workflow Step:** {{step}}

**Blocker:**
{{blocker_description}}

**Impact:**
- Workflow: {{workflow_impact}}
- Timeline: {{timeline_impact}}

**Resolution Options:**
1. {{option_1}}
2. {{option_2}}

**Escalated To:** {{escalation_target}}

---

Activity Query Patterns

Recent Activity

## Recent Activity Query

### Filters
- Time range: Last {{hours}} hours
- Agents: {{agent_filter}}
- Types: {{type_filter}}
- Tickets: {{ticket_filter}}

### Results

| Time | Agent | Type | Description |
|------|-------|------|-------------|
{{activity_rows}}

Workflow Activity

## Workflow Activity: {{workflow_name}}

**Session:** {{session_id}}
**Started:** {{start_time}}
**Status:** {{status}}

### Activity Timeline

{{timeline_entries}}

### Summary
- Total actions: {{action_count}}
- Decisions made: {{decision_count}}
- Handoffs: {{handoff_count}}
- Blockers: {{blocker_count}}
- Duration: {{duration}}

---

Output Templates

Jira Comment Log

🤖 **{{agent_name}}** - {{timestamp}}

**Action:** {{action_type}}

{{action_description}}

**Context:**
{{context}}

**Artifacts:**
{{artifacts}}

**Next Steps:**
{{next_steps}}

Confluence Activity Page

# {{workflow_name}} Activity Log

## Session: {{session_id}}

| Time | Agent | Action | Details | Artifacts |
|------|-------|--------|---------|-----------|
{{activity_table_rows}}

## Decisions Made

{{decisions_section}}

## Blockers Encountered

{{blockers_section}}

---

Integration

Auto-logging Points

Activity is automatically logged at these points:

1. Workflow start/end
2. Agent activation
3. Decision points
4. Artifact creation/update
5. Handoffs between agents
6. Escalations
7. Blockers encountered
8. Workflow completion

Manual Logging

Agents can add manual log entries for:

• Important observations
• Assumption documentation
• Rationale notes
• Stakeholder communications

---

Agents Using This Skill

• All Agents - Log their activities
• Orchestrator - Aggregate and report
• Project Manager - Activity reporting

Related Skills

• observability-decision-trail - Decision tracking
• observability-workflow-trace - Workflow visualization
• jira-comment-logging - Jira integration
• confluence-meeting-notes - Documentation

MCP Tools Used

• Atlassian:addCommentToJiraIssue - Log to Jira
• Atlassian:createConfluencePage - Activity documentation
• Atlassian:updateConfluencePage - Update logs