# Project Log

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

- Skill: `switch-dimension/project-log` (Agent Skill)
- Install (CLI): `npx skillmds@latest add switch-dimension/project-log`
- Raw SKILL.md: https://api.skillmd.com/api/skills/switch-dimension/project-log/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: switch-dimension (https://skillmd.com/u/switch-dimension)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/switch-dimension/project-log

---


# 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

```markdown
## [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"