d879d1d3ea
First-pass adoption of the branch-and-PR workflow so Scott can onboard
Jr Claude contributors without blocking on the Lead. This PR is also
the inaugural test case of the workflow — branch + PR + review rather
than direct-to-master.
Three new files at the repo root:
- **CONTRIBUTING.md** — authoritative workflow policy. Based on the
doc Opus outlined, with ItsGoin-specific amendments:
1. Hotfix carve-out: Lead retains direct-to-master authority for
true production-down scenarios, with mandatory retrospective PR
within 24h.
2. Build trigger is explicit — Scott says "ship it," no rolling
auto-deploy.
3. Review SLA is "natural stopping point," no hard time budget.
Exception: Jr blocked + Scott flags urgent → Lead preempts.
4. Re-evaluation triggers for the Lead role (5+ agents, >1d review
latency, rewriting PRs in review, Scott's routing load).
5. Secrets policy explicit (`.deploy-creds` is .gitignored; never
commit credentials).
A Phase 0 checklist at the bottom tracks which prereqs (CI, branch
protection, Jr Forgejo account) are still pending.
- **AGENTS.md** — cross-agent session-start guide. Originally drafted
as CLAUDE.md, but that filename is `.gitignore`d at the repo root
because it has historically been a credential-leak vector. Switched
to AGENTS.md (emerging cross-tool convention) with an explicit
security banner at the top forbidding credential writes. Covers
session start, role-specific starts (Lead vs Jr), session end,
critical rules.
- **sessions.md** — rolling contributor coordination log. Seeded with
an entry for this PR and the current post-v0.6.2-ship state (anchor
PID 3475521, shipped artifacts, last merged commit 2ce668a).
No code touched. Workflow-only.
Phase 0 prereqs still open after this PR:
- Forgejo CI (`cargo check` + `cargo test` on push + PR)
- Branch protection on master (require PR + 1 review + green CI)
- Second Forgejo account + SSH key for Jr Claude(s)
2.6 KiB
Contributor Sessions Log
Rolling log of active sessions on the ItsGoin repository. Every contributor — Lead or Jr — appends an entry on session start and updates it on session end. Newest entries at the top.
See CONTRIBUTING.md for the protocol. See AGENTS.md for the Claude-specific session-start checklist.
2026-04-23 — primary Claude (Lead) — chore/workflow-adoption
Started: late April 23 UTC
Instance: Scott's primary Claude (Lead role per feedback_senior_role.md)
Issue: none yet (inaugural PR; this is the chicken-and-egg case noted in CONTRIBUTING.md)
Branch: chore/workflow-adoption
Scope: Introduce the multi-contributor workflow to the repo. Creates CONTRIBUTING.md, AGENTS.md, and this file (sessions.md) with a seed entry.
Pre-existing state at session start:
- v0.6.2 shipped end-to-end earlier today: APK, AppImage, CLI, anchor (PID 3475521, up since ~17:39 UTC).
- Last merged-to-master commit before this branch:
2ce668a— People-tab rewrite (recency sort, profile-post Discover, bio modal, ignore primitive, per-author feed filter). - Active artifacts on
itsgoin.com/public_html/:itsgoin-0.6.2.apk(183.7 MB),itsgoin_0.6.2_amd64.AppImage(177.7 MB),itsgoin-cli-0.6.2-linux-amd64(40.8 MB). - No other contributors active.
Completed in this session (before this commit):
- Designed the Lead role + amendments to the base workflow (hotfix carve-out, explicit build trigger, natural-stopping-point review SLA, re-evaluation triggers).
- Saved
feedback_senior_role.mdto instance memory. - Wrote
CONTRIBUTING.md,AGENTS.md,sessions.md(this file). Originally drafted the agent guide asCLAUDE.mdbut that filename is.gitignored at the repo root because it has historically been a credential-leak vector; switched toAGENTS.mdwith an explicit security banner.
Pending after this PR merges:
- Phase 0 prereqs from
CONTRIBUTING.md: Forgejo CI (cargo check --workspace+cargo test -p itsgoin-coreon push + PR), branch protection on master (require PR + 1 review + green CI), second Forgejo account + SSH key for Jr Claude(s). Scott coordinates.
Stopping point: branch pushed, PR open for Scott's review. Awaiting review.