devdraft

name	devdraft
description	Generates and incrementally updates project docs from codebase. Trigger: "generate docs", "create documentation", "update my docs", "my docs are outdated", "document my codebase", "write docs", "devdraft", "doc my project", "sync docs". First run: full scan → writes per-app/module docs + stores git commit ID in docs/index.md. Next runs: git diff → patch only changed sections. Monorepo: folder per app/package. Monolith: folder per domain module.
license	Apache-2.0
user-invocable	true
effort	high
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob","AskUserQuestion","Agent"]
tags	["docs","documentation","readme","codebase","devdraft","incremental","git","monorepo","turborepo"]
metadata	{"author":"priyalraj","version":"0.0.1","platforms":["claude-code"],"triggers":["devdraft","generate docs","create documentation","update my docs","document my codebase","write docs","sync docs","my docs are outdated","doc my project"]}

devdraft

Folder-per-app doc generator. First run = full scan. Next runs = git diff → patch changed sections only.

Reference files live in references/ next to this SKILL.md. Derive absolute path at runtime — never hardcode.

S1 — Git Detection

git rev-parse HEAD

No git repo / no commits → FULL mode, skip commit tracking. Store CURRENT_HEAD.

S2 — Structure Classification

List root files. Auto-detect structure:

1. Workspace manifest present (go.work, Cargo.toml, pnpm-workspace.yaml, package.json, pyproject.toml, lerna.json, nx.json, turbo.json, rush.json) → read it. If it declares a workspace (members list / workspaces key / workspace section) → monorepo.
2. Generic layout — apps/ + packages/ both at root, OR services/ dir with 2+ subdirs each containing any manifest → monorepo.
3. No signals → monolith.

• Monorepo → Read references/monorepo.md for workspace expansion + unit discovery per format.
• Monolith → Read references/monolith.md for domain detection rules.

Print detected structure + unit list before proceeding.

S3 — Commit State

Marker location: docs/index.md only → <!-- devdraft-commit: <sha> -->

Legacy: .devdraft-state at root → migrate into docs/index.md, delete file.

Read marker → store as STORED_COMMIT. Then validate:

git cat-file -e <STORED_COMMIT>^{commit} 2>/dev/null   # SHA exists?
git merge-base --is-ancestor <STORED_COMMIT> HEAD       # SHA is ancestor of HEAD?

Either check fails → treat as FULL (SHA was rebased away / force-pushed / wrong branch).

State	Mode
No docs / no marker