Reference for managing the devloop worklog - a history of completed work with commit references. Documents format, update rules, and integration with the plan/commit workflow.
This skill inherits all available tools. When active, it can use any tool Claude has access to.
Purpose: The worklog (devloop-worklog.md) maintains a permanent history of completed work, separate from the active plan. While the plan shows what's in progress, the worklog shows what's done.
.devloop/worklog.md
Git Status: Tracked (committed to repository)
Creation: Created automatically on first commit after a plan exists, or manually via worklog reconstruction.
# Devloop Worklog
**Project**: [project-name]
**Last Updated**: [YYYY-MM-DD HH:MM]
---
## [Feature/Epic Name] (vX.Y.Z)
**Period**: YYYY-MM-DD to YYYY-MM-DD
**Plan**: .devloop/plan-[feature].md (archived)
### Commits
| Hash | Date | Message | Tasks |
|------|------|---------|-------|
| abc1234 | 2024-12-11 | feat: add user auth | 1.1, 1.2 |
| def5678 | 2024-12-11 | test: auth tests | 1.3 |
| ghi9012 | 2024-12-12 | feat: user profile | 2.1 |
### Tasks Completed
- [x] Task 1.1: Implement user authentication
- [x] Task 1.2: Add session management
- [x] Task 1.3: Write authentication tests
- [x] Task 2.1: Create user profile page
### Notes
[Optional: Notable decisions, learnings, or context for future reference]
---
## [Previous Feature] (vX.Y.Z)
...
Plan (devloop-plan.md) Worklog (devloop-worklog.md)
┌─────────────────────┐ ┌──────────────────────────┐
│ Active Work │ │ Completed Work │
│ │ │ │
│ - [ ] Task pending │ │ Feature A (v1.2.0) │
│ - [~] Task active │ │ - [x] Task 1.1 (abc123) │
│ - [x] Task done │───────▶│ - [x] Task 1.2 (abc123) │
│ │ commit │ │
│ Progress Log: │ │ Feature B (v1.1.0) │
│ - Completed task... │ │ - [x] Task 1.1 (def456) │
└─────────────────────┘ └──────────────────────────┘
▲ │
│ │
└────── Reference for context ───────┘
Key Principle: The plan tracks what's happening now. The worklog tracks what happened.
When a commit succeeds, the post-commit hook should:
When a phase completes:
When Status changes to "Complete":
- [x] Task X.Y: [Description] (commit-hash)
| abc1234 | 2024-12-11 14:30 | feat(auth): add login - Task 1.1 | 1.1 |
## User Authentication Feature (v1.2.0)
**Period**: 2024-12-10 to 2024-12-15
**Plan**: .devloop/archived/devloop-plan-auth.md
1. Get commit hash from `git rev-parse HEAD`
2. Get commit message from `git log -1 --format=%s`
3. Parse task reference from commit message (e.g., "- Task 1.1")
4. Add to worklog commit table:
| {hash} | {date} | {message} | {tasks} |
5. Update "Last Updated" timestamp
1. Read worklog for completed work context
2. Read plan for in-progress context
3. Generate summary combining both
4. Worklog provides "what was accomplished"
1. Read worklog to understand recent history
2. Read plan to understand current state
3. Display: "Last session: [recent worklog entries]"
4. Display: "Current: [active plan tasks]"
For projects adopting devloop with existing history:
# Get recent commits with conventional format
git log --oneline --since="30 days ago" | \
grep -E "^[a-f0-9]+ (feat|fix|docs|test|refactor):"
## Historical Work (Pre-Devloop)
**Note**: Reconstructed from git history on YYYY-MM-DD
### Commits
| Hash | Date | Message |
|------|------|---------|
| abc1234 | 2024-11-15 | feat: initial API setup |
| def5678 | 2024-11-20 | fix: database connection |
...
/devloop:worklog reconstruct [--since="30 days ago"]
This will:
When a feature is complete and you want to start fresh:
## User Authentication (v1.2.0) - COMPLETE
**Period**: 2024-12-10 to 2024-12-15
**Plan**: .devloop/archived/devloop-plan-auth.md
**Release Notes**: See CHANGELOG.md for v1.2.0
mkdir -p .devloop/archived
mv .devloop/plan.md .devloop/archived/devloop-plan-auth.md
Start fresh with /devloop for the next feature.
| Action | Location | When |
|---|---|---|
| Create worklog | .devloop/worklog.md | First commit with plan |
| Add commit entry | Commit table | Each commit |
| Add task entry | Tasks Completed list | Task committed |
| Update timestamp | Last Updated field | Any change |
| Start new section | New ## Feature header | New plan started |
| Archive | Move to .devloop/archived/ | Feature complete |
Skill: plan-management - Active plan format and updatesSkill: task-checkpoint - Task completion workflowSkill: atomic-commits - Commit timing and grouping/devloop:worklog - Command for worklog operations