Skip to content

Update design-doc-writing skill from HLD review feedback - #83

Merged
conallob merged 1 commit into
mainfrom
claude/design-doc-writing-edits
Oct 22, 2026
Merged

conallob merged 1 commit into
mainfrom
claude/design-doc-writing-edits

Conversation

@conallob

Copy link
Copy Markdown
Owner

Edits to design-doc-writing (SKILL.md, references/hld-structure.md, references/google-docs-mechanics.md):

  • Requirements are grouped bullets (Functional, Non-functional, Nice to have), not a numbered table; no R-numbers, comparison rows labelled by name.
  • Verify the current state across every instance, and carry corrections through the whole doc.
  • Goals: motivating goal first, include organisational goals.
  • Doc comments: read with includeComments, don't detach anchors, connectors can't reply or resolve.
  • Research: label a vendor's article about a competitor as secondhand; note fallback when vendor sites can't be fetched.
  • Docs mechanics: HTML create, re-bulleting indent fix, replaceAllText index drift, table-to-bullets recipe, verify nesting from read_doc JSON.

Generated by Claude Code

Group requirements as bullets without R-numbers, verify current state
across every instance, handle doc comments without detaching them, and add
Google Docs mechanics lessons.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CnhMaZrWigweuyinNRkNe5
@conallob
conallob merged commit 75daf26 into main Oct 22, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant