#32 feat(32-draft-marking-step): add /draft marking step and do draft execution

[ivan-hilckov]

Summary

Implements the /draft marking step: a new shipped skill that marks code with TODO(yoke) Markers plus a
compilable skeleton and opens a Draft PR for early review, and /do's new draft-execution mode that
implements a reviewed draft and flips the PR to ready. Covers the marking procedure and markup format
contract, the finish-contract Draft PR variants, the /do router rung for draft execution, the /draft
entry point, and full documentation (long-form doc, do/notify docs, help catalog, README, CLAUDE.md,
regenerated skill catalog). Per PRD issue #32 and ADR-0011.

Closes #32

Changes

File	Action	Description
skills/draft/SKILL.md	created	/draft entry point: input, router, principles
skills/draft/reference/mode-draft.md	created	Marking procedure: Plan → Mark → Draft PR + Iteration
skills/draft/reference/markup-format.md	created	Markup contract: Marker, skeleton, build invariant, gate
skills/do/reference/mode-draft-execution.md	created	Draft execution: voices, checklist, replies, ready flip
skills/do/SKILL.md	modified	Input shape, router rung 2, Modes row
skills/do/reference/finish.md	modified	§3 Draft variants: --draft create / gh pr ready flip
docs/draft.md	created	Long-form doc with **Output:** line
docs/do.md	modified	Draft execution row + Connections line
docs/notify.md	modified	draft STAGE_COMPLETE row + note
skills/help/SKILL.md	modified	/draft section + Full cycle optional line
README.md	modified	Mermaid draft node, prose, catalog row (sentinel)
CLAUDE.md	modified	/draft prose + catalog bullet (sentinel)
.claude/skills/sync-docs/SKILL.md	modified	Catalog count 14 → 15, list + draft
site/src/content/docs/skills/draft.mdx	created	Generated catalog page
site/src/content/docs/skills/do.mdx	modified	Regenerated (input bullet + details)
site/src/content/docs/skills/help.mdx	modified	Regenerated (details)

Commits

• d087865 docs(32-draft-marking-step): add execution report
• 589afe7 fix(32-draft-marking-step): cite ADR-0011 by number and clarify post-run actor
• 8631ecd docs(32-draft-marking-step): regenerate skill catalog for /draft
• 6aaf52c chore(32-draft-marking-step): bump sync-docs catalog count to 15
• df8200c refactor(32-draft-marking-step): align notify payload wording and drafted-slug iteration condition
• 721e5a6 docs(32-draft-marking-step): show optional draft step in README flow
• a363640 docs(32-draft-marking-step): document draft execution mode in do doc
• b348548 docs(32-draft-marking-step): add /draft to help catalog and full cycle
• 020f2fb docs(32-draft-marking-step): add long-form draft skill doc
• 08576a3 docs(32-draft-marking-step): mention optional draft step in CLAUDE.md
• 9eb1d93 docs(32-draft-marking-step): add draft notification points to notify map
• 2e73b0d feat(32-draft-marking-step): add /draft skill entry point
• d44dd98 feat(32-draft-marking-step): route draft PRs and drafted slugs to draft execution
• 1aae3f6 fix(32-draft-marking-step): fill all task-executor template fields in draft execution
• bb50def feat(32-draft-marking-step): add do draft-execution mode
• 09f3e76 feat(32-draft-marking-step): add /draft marking procedure
• 2171592 refactor(32-draft-marking-step): align quote style and do-never-merges phrasing
• 4d22d1f feat(32-draft-marking-step): add markup format contract for /draft
• c5c131a feat(32-draft-marking-step): teach finish contract the Draft PR create and ready flip
• c47d81d docs(32-draft-marking-step): add implementation plan

Validation

• prettier --check "**/*.{md,json}" passes
• JSON manifests (plugin.json, marketplace.json) parse
• head -1 skills/*/SKILL.md — every file starts with ---
• yoke-validate lenses (Strunk + plugin-dev) over draft/do/help SKILL.md — 2 LOW findings fixed in 589afe7, 2 INFO accepted
• MDX <details> blocks byte-match their SKILL.md sources (do, help, draft)
• TODO(yoke) grep — only intentional documentation occurrences