Create or satisfy a Collaborative Development Document (CDD) — a structured session log that records user prompts and agent responses with git context. ALWAYS use this skill when the user invokes /cdd, wants to start or continue a tracked working session, or asks to satisfy a numbered prompt in a CDD file. Usage: /cdd <title> to create a new CDD; /cdd <N> to satisfy Prompt N in the attached CDD.
Manage a Collaborative Development Document (CDD). A CDD is a dated markdown file that logs a working session as numbered prompts and responses — creating a versioned, human-readable record of collaborative development work.
Detect mode from the argument:
/cdd 3) → Satisfy mode: process Prompt 3 in the CDD file in context/cdd implementing auth system) → Create mode: scaffold a new CDD fileEnsure cdd/ exists at the workspace root: mkdir -p cdd
Get git hash: git rev-parse --short HEAD
Create cdd/YYYY-MM-DD-kebab-title.md with this structure:
---
date: YYYY-MM-DD
title: <title from argument>
current_head: <hash>
agent: "<your model name>"
session_type: exploration # exploration | feature | bugfix | refactor | maintenance
topics: [<keywords extracted from the title>]
---
# Prompt 1:
Leave the Prompt 1 body blank — the user writes the first prompt.
Populate topics: with 2–4 keywords inferred from the title. Populate session_type: with the most appropriate value from the comment.
Report the filename created.
# Response N: brief summary at the end of the # Prompt N: section — after the prompt's full body text, before your work begins.The # Prompt N: section includes both the header line and all the body text the user wrote beneath it. The # Response N: header goes at the end of that section — after the entire prompt body — not between the prompt title line and the body text. Any work output appearing before the Response header makes the log hard to read. Use markdown links [label](path) for file references and code blocks for commands and code. Keep prompt/response numbers sequential. Update the topics list in the front-matter if relevant topics emerged during the work.