Skip to content

📝 [docs] readme: why line, star/community ask, prerequisites checklist - #87

Merged
EricTechPro merged 2 commits into
mainfrom
docs/readme-live-talk
Oct 29, 2026
Merged

EricTechPro merged 2 commits into
mainfrom
docs/readme-live-talk

Conversation

@EricTechPro

Copy link
Copy Markdown
Owner

Note

⏳ Awaiting Eric's merge · ✅ 3/3 AC · head 5befc0b

Problem

  • Where: README top, landed on from a QR code at Eric's live talk
    • a. Scan the QR code
    • b. Read the header, then Install
  • Who: first-time visitors on a phone
  • What happened: no reason to care in one line, no star or community ask, and the prerequisites sit in deeper docs, so installs stall at /config or the merge gate

Solution

  • One "why" line under the tagline
  • Star ask, Skool community link and YouTube walkthrough link under the live site link
  • 3-item prerequisites checklist at the top of Install, linking Backends and Setup notes

Acceptance criteria

  • Header shows the why line, star ask, Skool and YouTube links before Install
    ↳ README.md lines 9 and 21 · absent on a2809b6, present on 5befc0b
  • Install opens with the 3 prerequisites, each linking an existing heading
    ↳ docs/super-board/README.md#backends and #setup-notes both exist
  • Generated skill tables unchanged
    ↳ bash tests/test-readme-sync.sh passes (6 scenarios)

Iteration history

Lane Done Time Details
🔨 builder ✅ Oct 29 draft · 5befc0b

Risk

🟢 Low · README copy only; no scripts, skills or templates touched.

  • Door: two-way · revert the PR and the old header returns
  • Blast radius: none · README readers see three new lines

🤖 Generated with Claude Code

- Header: one-line why, star ask, Skool community and YouTube walkthrough links
- Install: 3-item prerequisites checklist linking backends and setup notes
- test-readme-sync.sh passes; generated skill tables untouched

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@qodo-code-review

Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

ialeandrodelfino pushed a commit to ialeandrodelfino/super-board that referenced this pull request Oct 29, 2026
…3 breakdown

- implement-spec: spec-ref example (/implement-spec EricTechPro#87), dependency map, hand-loop trigger
- pr: evidence tiers (screenshots first) and roll-back framing for merge danger
- retro: all 7 check areas, lint/hook/CI for mechanical mistakes, you pick the fixes
- add Gary Chen's 1.3 breakdown video as a source

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@EricTechPro
EricTechPro merged commit a0e52de into main Oct 29, 2026
13 checks passed
@EricTechPro
EricTechPro deleted the docs/readme-live-talk branch October 29, 2026 19:33
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