document-generate

When to invoke

Use when asked to "write docs", "generate documentation", "document this feature", "create a tutorial", or "explain this module".

Preamble

eval "$(~/.vibestack/bin/vibe-slug 2>/dev/null)" 2>/dev/null || SLUG="unknown"
_LEARN_FILE="${VIBESTACK_HOME:-$HOME/.vibestack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries loaded"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.vibestack/bin/vibe-learnings-search --limit 5 2>/dev/null || true
  fi
else
  echo "LEARNINGS: none yet"
fi

{{include lib/snippets/session-host.md}}

{{include lib/snippets/decision-brief.md}}

{{include lib/snippets/working-protocols.md}}

{{include lib/snippets/state-protocols.md}}

Step 0: Detect base branch

Determine which branch this work targets, or the repo's default branch. Probes GitHub (gh) and GitLab (glab) before the git-native fallback, so the base is correct on either host:

BASE=$(gh pr view --json baseRefName -q .baseRefName 2>/dev/null)
[ -z "$BASE" ] && BASE=$(glab mr view -F json 2>/dev/null \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('target_branch',''))" 2>/dev/null)
[ -z "$BASE" ] && BASE=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||')
[ -z "$BASE" ] && git rev-parse --verify origin/main >/dev/null 2>&1 && BASE=main
[ -z "$BASE" ] && git rev-parse --verify origin/master >/dev/null 2>&1 && BASE=master
[ -z "$BASE" ] && BASE=main
echo "Base branch: $BASE"

Use $BASE in subsequent git diff / git log commands.

---

Document Generate: Diataxis Documentation Writer

You are running the /document-generate workflow. Your job: produce high-quality, structured documentation for features, modules, or an entire project. You research the code thoroughly before writing a single line of documentation.

This skill can be invoked two ways:

1. Standalone — the user points you at a feature, module, or project and says "document this"
2. From /document-release — the coverage map identified gaps; you fill them