worklog

Automates Worklog creation and progress tracking in feature branches via .worklogs Markdown files.

1|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/MayMustAI/ai-dev-playbook --skill worklog-maymustai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worklog
Source: https://github.com/MayMustAI/ai-dev-playbook/tree/main/plugins/maymust/skills/worklog
Command: npx skills add https://github.com/MayMustAI/ai-dev-playbook --skill worklog-maymustai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage a per-task Worklog as a single-page document for each feature branch in .worklogs, enabling creation, lookup, progress entries, and completion tracking, with automatic archival on squash-merge to main.

Core Features & Use Cases

  • One-worklog-per-task: Creates a single-page file per task/branch in .worklogs.
  • Branch-scoped tracking: Ties worklogs to the current branch to keep context.
  • Progress logs & completion: Add progress lines and mark complete for PR summaries.

Quick Start

Run /maymust:worklog on your feature branch to create or open the worklog and begin documenting tasks.

Frequently Asked Questions about worklog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track feature work progress within a branch for squash merges?

Worklog tracking is automated by creating a single Markdown file per task in .worklogs, tied to your current feature branch. It enforces a standard frontmatter schema with date, branch, task, and status, appending structured progress entries that provide a portable audit trail picked up during squash merges.

What is the best way to maintain a portable audit trail for software development tasks?

The best way to maintain a portable audit trail is using a per-task Markdown worklog with standard frontmatter. This approach ties documentation to the feature branch, structuring progress entries in a single-page file that travels with the code and archives automatically upon squash-merge completion.

How do I create a worklog for my current feature branch?

You create a worklog by running the /maymust:worklog command on your feature branch. This generates or opens a single-page Markdown file under .worklogs, scoped to your active branch, allowing you to immediately begin documenting tasks and adding structured progress entries.

Does worklog tracking work with branch-based workflows and squash merges?

Yes, worklog tracking is designed for branch-based workflows using squash merges. It ties a single-page audit trail to the current feature branch and automatically archives the worklog when the branch is squash-merged to main, ensuring progress logs are preserved for PR summaries.

Can I use a standard schema for task tracking in Markdown files?

Yes, you can enforce a standard frontmatter schema in Markdown files for task tracking. The schema includes date, branch, task, and status fields, appending progress logs in a structured format to maintain a concise and consistent audit trail across the team.

What happens to task tracking worklogs when a feature branch is merged?

When a feature branch is squash-merged to main, the task tracking worklog is automatically archived team-wide. This ensures the single-page Markdown audit trail, including all progress entries and completion status, is preserved without manual intervention.