project-log

name	project-log
description	Ensures a .docs folder exists, creates project-log.md, and records current project status for handoff. Use when ending a session, before context switches, when handing off to another person or agent, or when the user asks to save project status or create a project log.
metadata	{"author":"switch-dimension","version":"1.0.0"}

Project Log Skill

Creates or updates a project handoff log so anyone picking up the project understands its current state.

Instructions

1. Ensure .docs folder exists

• List the project root directory.
• If .docs does not exist, create it.
• Use the workspace root path for all operations.

2. Create or update project-log.md

• Path: .docs/project-log.md
• If the file exists, append a new entry rather than overwriting.
• If it does not exist, create it with the structure below.

3. Record current project status

Populate the log entry with information that helps the next person (or agent) understand:

• What was done: Summary of recent work, changes made, or decisions.
• Current state: Working / broken / in progress / blocked.
• Next steps: Explicit recommendations for what to do next.
• Context: Relevant tech stack, important files, environment notes, blockers.
• Timestamp: Date and brief context (e.g. "After implementing auth", "End of session").

Template

## [YYYY-MM-DD] — [Brief title, e.g. "End of auth implementation"]

### Summary
[1–2 sentences: what was accomplished in this session or phase]

### Current State
[ ] Working
[ ] In progress
[ ] Blocked — [reason]
[ ] Broken — [what’s wrong]

### Next Steps
1. [First concrete action]
2. [Second action]
3. [Third action]

### Context
- **Stack**: [e.g. Next.js 14, PostgreSQL]
- **Key files**: [e.g. `src/auth/`, `lib/db.ts`]
- **Notes**: [Environment setup, credentials location, known gotchas]

---

When to Use

• User says: "Save the project status", "Create a project log", "Log what we did", "Hand off"
• Before ending a long session or switching to unrelated work
• When explicitly handing off to another person or agent
• When user asks to "document current state" or "note next steps"