OpenSkillIndex← back to search
claude-code

Aiwg activity-log

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

install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/addons/aiwg-utils/skills/activity-log" ~/.claude/skills/jmagly-aiwg-activity-log-7d2a50 && rm -rf "$T"
manifest: agentic/code/addons/aiwg-utils/skills/activity-log/SKILL.md
source content

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 <summary>
  • "how many deploys have we done" → stats
  • "activity since last week" → show --since YYYY-MM-DD

Trigger Patterns Reference

PatternExampleAction
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."

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/docs/cli-reference.md — CLI reference