Skip to main content
AI/MLjmagly

activity-log

Query and manage the unified .aiwg/activity.log chronological record of AIWG-managed workflow operations

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--activity-log
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/aiwg-utils/skills/activity-log/SKILL.md -o .claude/skills/activity-log.md

Drops the SKILL.md into .claude/skills/activity-log.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Activity Log

You query and manage the unified .aiwg/activity.log — a chronological record of all framework operations across SDLC, research, and other AIWG-managed workflows.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

  • "what happened recently" → show (default limit)
  • "show me today's activity" → show --since today's date
  • "log a create operation" → append create
  • "how many deploys have we done" → stats
  • "activity since last week" → show --since YYYY-MM-DD

Trigger Patterns Reference

Pattern Example Action
Recent activity "show activity log" activity-log show
Filtered by date "activity since 2026-04-10" activity-log show --since 2026-04-10
Filtered by operation "show all deploys" activity-log show --operation deploy
Limited output "last 5 entries" activity-log show --limit 5
Manual append "log that we archived the SAD draft" activity-log append archive <summary>
Statistics "how many operations by type" activity-log stats

Behavior

When triggered:

  1. Identify the subcommand:

    • show — display entries, optionally filtered
    • append — add a manual entry
    • stats — summarize operation counts and date range

  2. Locate the log file: .aiwg/activity.log relative to the project root. If the file does not exist, report it as empty (do not error).

  3. Execute the subcommand:

show

Display entries in reverse-chronological order (newest first).

# Show last 20 entries (default)
aiwg activity-log show

# Filter by date (inclusive)
aiwg activity-log show --since 2026-04-10

# Filter by operation type
aiwg activity-log show --operation deploy

# Limit output count
aiwg activity-log show --limit 5

# Combine filters
aiwg activity-log show --since 2026-04-10 --operation create --limit 10

Accepted --operation values: ingest, create, update, delete, query, lint, deploy, archive, promote

append

Add a manual entry with the current UTC timestamp.

# Append a manual entry
aiwg activity-log append <operation> "<summary>"

Example:

aiwg activity-log append create "UC-011-logout.md created manually during team review"

The entry is written in standard format:

## [2026-04-12 14:33] create | UC-011-logout.md created manually during team review

Reject invalid operation tokens with a clear error listing the nine valid tokens.

stats

Summarize operation counts grouped by type and show the date range covered.

aiwg activity-log stats

Output format:

Activity Log Statistics
Log file: .aiwg/activity.log
Date range: 2026-04-01 → 2026-04-12 (12 days)
Total entries: 47

By operation:
  create    18  ████████████████████  38%
  update    12  █████████████         26%
  deploy     7  ████████               15%
  archive    4  ████                    9%
  lint       3  ███                     6%
  promote    2  ██                      4%
  delete     1  █                       2%

Examples

Example 1: Recent activity overview

User: "What's happened in the activity log recently?"

Extraction: show subcommand, default limit

Action:

aiwg activity-log show --limit 10

Response: Last 10 entries from .aiwg/activity.log newest first. If the file is absent, report "No activity log found at .aiwg/activity.log — operations will create it automatically."

Example 2: Audit all deploys

User: "Show me all deploy operations since April 10th"

Extraction: show, --operation deploy, --since 2026-04-10

Action:

aiwg activity-log show --operation deploy --since 2026-04-10

Response: Filtered entries matching deploy on or after 2026-04-10, newest first.

Example 3: Manual log entry

User: "Log that we archived the old SAD draft"

Extraction: append, operation = archive, summary from user phrase

Action:

aiwg activity-log append archive ".aiwg/working/sad-draft-v0.1.md archived manually after SAD baseline"

Response: "Entry appended to .aiwg/activity.log."

Example 4: Operation statistics

User: "Give me a stats breakdown of the activity log"

Extraction: stats subcommand

Action:

aiwg activity-log stats

Response: Tabular summary with operation counts, percentages, and date range.

Clarification Prompts

If the user's intent is ambiguous:

  • "Are you looking to read recent activity or record a new entry?"
  • "Which operation type should I filter on? Valid types: ingest, create, update, delete, query, lint, deploy, archive, promote."

Storage routing

aiwg activity-log routes through resolveStorage('activity_log') (#964). On the default fs backend, the log file is .aiwg/activity.log and the line format is byte-identical to the legacy echo >> .aiwg/activity.log pattern. Configuring .aiwg/storage.config redirects the log to a different filesystem location (via roots.activity_log) without changing how agents call the CLI.

References

  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/activity-log.md — Rule that governs when agents must append entries
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/index/SKILL.md — Artifact index skill (complementary query tool)
  • @$AIWG_ROOT/.aiwg/architecture/storage-design.md — Storage adapter design (#934)
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference