Skip to content

handbook: GitHub workflow and ABCD#1273

Draft
drewr wants to merge 7 commits into
mainfrom
handbook/github-workflow
Draft

handbook: GitHub workflow and ABCD#1273
drewr wants to merge 7 commits into
mainfrom
handbook/github-workflow

Conversation

@drewr
Copy link
Copy Markdown
Contributor

@drewr drewr commented May 7, 2026

What this is

A new page in build/GitHub workflow — framing GitHub as the medium for human dot-connecting, not just code delivery.

Why

We don't have a code writing velocity problem. Agents can write and review code. The bottleneck is human attention: making cross-functional connections, surfacing assumptions, identifying the decision points hiding inside what looks like implementation detail.

The page runs that idea through every section — issues, PRs, code review, milestones — with ABCD (Always Be Connecting Dots) as the through-line. Agent prompts are woven in so the scanning and queue management are handled, freeing humans for the conversations only humans can have.

Notes for reviewers

  • drafts/github-workflow-v1.md has an earlier version with a more traditional engineering hygiene framing. Keeping it around in case elements are worth pulling back in.
  • The ABCD link goes to an external article — worth confirming that's the right citation.
  • Sidebar order is 7, which puts it last in the build/ section for now.

Not yet done

  • Confirm sidebar order is right
  • Decide whether drafts/ should be gitignored or kept

drewr added 7 commits May 7, 2026 21:17
Introduces a new page in the build section framing GitHub as the medium
for human dot-connecting, not just code delivery. Agent prompts woven
throughout to handle scanning and boilerplate, freeing human attention
for cross-functional connections and surfacing latent decisions.

Two versions saved: v1 (engineering hygiene framing) in drafts/ and the
current ABCD-centered reframe in build/.
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