Skip to content

GH-RUNBOOK.md

Latest commit

 

History

History
214 lines (153 loc) · 6.96 KB

GH-RUNBOOK.md

File metadata and controls

214 lines (153 loc) · 6.96 KB
Raw

GitHub runbook · the parts that need your gh auth

Everything in this file requires you to be authenticated to GitHub. Run gh auth login once at the top, then walk down the list.

0 · Authenticate the gh CLI (one-time)

gh auth login
#   -> GitHub.com
#   -> HTTPS
#   -> Authenticate Git with your GitHub credentials? Y
#   -> Login with a web browser
# Follow the device-code prompt.

Verify:

gh auth status

1 · Push the theailaborg.github.io profile site

Creates the username site (https://theailaborg.github.io) which becomes your organisation's public landing page on GitHub.

cd /tmp/theailaborg.github.io

git init
git add .
git commit -m "Initial profile site for The AI Lab Intelligence Unobscured, Inc.

Redirects to theailab.org with full Organization JSON-LD schema, llms.txt
attribution, and a comprehensive README listing every TIP component, the
Whitepaper Zenodo DOI, and Founder/Institution Wikidata QIDs."

# Create the repo and push (replace path if needed):
gh repo create theailaborg/theailaborg.github.io \
  --public \
  --description "The AI Lab Intelligence Unobscured, Inc. — institutional home of the Trust Identity Protocol (TIP). Whitepaper v1.0 at theailab.org/whitepaper, DOI 10.5281/zenodo.20722378." \
  --source=. \
  --push

# Enable GitHub Pages:
gh repo edit theailaborg/theailaborg.github.io \
  --enable-issues=true \
  --enable-wiki=false
# (Pages auto-enables for username sites when index.html is at root.)

The site is then live at https://theailaborg.github.io within a minute.

2 · Add Topic tags to every repo

GitHub search and the org's repo grid both surface topic tags. Apply the canonical TIP topic set to each repository.

# tip-protocol (canonical spec repo, biggest discovery surface)
gh repo edit theailaborg/tip-protocol \
  --add-topic tip-protocol \
  --add-topic trust-identity-protocol \
  --add-topic content-provenance \
  --add-topic post-quantum-cryptography \
  --add-topic ai-trust \
  --add-topic ai-trust-council \
  --add-topic federated-dag \
  --add-topic verified-human-identity \
  --add-topic deepfake-defense \
  --add-topic eu-ai-act \
  --add-topic open-standard \
  --add-topic ml-dsa \
  --add-topic ml-kem \
  --add-topic slh-dsa \
  --add-topic webauthn \
  --add-topic cna-2-2 \
  --add-topic c2pa-alternative \
  --add-topic the-ai-lab

# theailaborg.github.io (profile site)
gh repo edit theailaborg/theailaborg.github.io \
  --add-topic the-ai-lab \
  --add-topic trust-identity-protocol \
  --add-topic ai-trust-council \
  --add-topic content-provenance \
  --add-topic open-standard

# If you have other repos (whitepaper drafts, SDK repos, plugin repos),
# apply the same topic set with --add-topic flags.  List all org repos:
gh repo list theailaborg --limit 100 --json name --jq '.[].name'

3 · Update repo descriptions (one-line headline pitch)

Descriptions appear on the org page, in search snippets, and on every starred-by feed.

gh repo edit theailaborg/tip-protocol --description \
"Trust Identity Protocol (TIP) Specification v5.0 — the open, post-quantum, federated standard for verified human identity and AI content provenance on the internet. Whitepaper at theailab.org/whitepaper, DOI 10.5281/zenodo.20722378."

gh repo edit theailaborg/theailaborg.github.io --description \
"The AI Lab Intelligence Unobscured, Inc. — institutional home of the Trust Identity Protocol (TIP). Whitepaper v1.0 at theailab.org/whitepaper, DOI 10.5281/zenodo.20722378."

# Pattern for any other repo:
gh repo edit theailaborg/<repo-name> --description "<canonical headline>"

4 · Enable GitHub Discussions

Discussions create a community surface separate from Issues. Critical for "real institution" signal.

# Enable discussions on the main repo:
gh repo edit theailaborg/tip-protocol --enable-discussions

# (Also worth enabling for any repo where users will have questions:)
gh repo edit theailaborg/theailaborg.github.io --enable-discussions

After enabling, configure categories via the web UI: https://github.com/theailaborg/tip-protocol/discussions/categories

  • General
  • Q&A
  • Show and tell
  • Ideas
  • Polls (Council deliberations)

5 · Enable GitHub Sponsors (one-time setup)

GitHub Sponsors signals "real institution" and adds a Sponsor button.

  1. Open https://github.com/sponsors/signup
  2. Sign up as the organization theailaborg (not personal).
  3. Stripe Connect verification (Stripe Atlas should make this fast given the corp is on Stripe Atlas).
  4. Once approved, append the github: line to .github/FUNDING.yml in tip-protocol:
github: theailaborg
custom:
  - "https://theailab.org/ai-trust-council"
  - "mailto:council@theailab.org"
  1. Commit and push.

The Sponsor button appears on the repo header within a few minutes.

6 · Pin the canonical repos to the org profile

Pinned repos appear at the top of https://github.com/theailaborg. The gh CLI does not support this; do it via the web UI.

  1. Open https://github.com/theailaborg
  2. Click "Customize your pins" in the upper-right of the repository list.
  3. Pin in this order:
    • tip-protocol
    • theailaborg.github.io
    • any other high-signal repo

7 · Quick verification pass

After completing 1–6:

# Visit the profile:
open https://github.com/theailaborg

# Check the topic tags are showing:
open https://github.com/topics/trust-identity-protocol

# Check the org profile site is live:
open https://theailaborg.github.io

# Check the Sponsor button is visible (after Sponsors approval):
open https://github.com/theailaborg/tip-protocol

8 · Hacker News submission (separate · timed)

Tuesday morning 7–9 AM PT (Wed morning works too). Use the draft we wrote during the whitepaper publication:

cat /tmp/whitepaper-v101/announce/06-hacker-news.md

The recommended URL to submit is https://theailab.org/whitepaper (not the DOI, not the PDF · the landing has the best dwell-time + retention for HN's algorithm).

Recommended title:

Show HN: Trust Identity Protocol Whitepaper v1.0 — open standard for verified human identity and content provenance, post-quantum from genesis

Post the first comment (the "About this submission" intro) within 5 minutes of submission.

Notes

  • The .github/FUNDING.yml file I created in tip-protocol already has the custom: entries. Once Sponsors is approved, add the github: line and the Sponsor button changes from "Custom" links to the official Sponsor flow.
  • The README I enriched in tip-protocol includes the keyword <sub> block at the bottom of the badge stack. GitHub repo search uses this for full-text matching. Test by searching trust identity protocol in github.com/search?q=trust+identity+protocol — within a few hours your repo should appear in the top results.
  • CITATION.cff enables the Cite this repository button in the GitHub repo header. Test by visiting https://github.com/theailaborg/tip-protocol after the deploy; the button appears in the right sidebar.