Title: feat: Automatic developer handover via identity/now.md · Issue #181 · github/squad · GitHub
Open Graph Title: feat: Automatic developer handover via identity/now.md · Issue #181 · github/squad
X Title: feat: Automatic developer handover via identity/now.md · Issue #181 · github/squad
Description: Problem When multiple developers work on a feature branch with a shared squad, handing over context to the next developer requires manually telling the squad to "prep for handover." Without this prompt, the incoming developer gets no pro...
Open Graph Description: Problem When multiple developers work on a feature branch with a shared squad, handing over context to the next developer requires manually telling the squad to "prep for handover." Without this pr...
X Description: Problem When multiple developers work on a feature branch with a shared squad, handing over context to the next developer requires manually telling the squad to "prep for handover." Witho...
Opengraph URL: https://github.com/github/squad/issues/181
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat: Automatic developer handover via identity/now.md","articleBody":"## Problem\n\nWhen multiple developers work on a feature branch with a shared squad, handing over context to the next developer requires manually telling the squad to \"prep for handover.\" Without this prompt, the incoming developer gets no proactive briefing — they have to remember to ask \"catch me up\" or re-explain the project state to the squad.\n\nThe data to support handover already exists (Scribe commits session logs, decisions, and agent histories to the branch), but nobody synthesizes it into a handover-ready format, and the coordinator does not deep-read it when a new developer arrives.\n\n## Root Cause (5 interconnected gaps)\n\n1. **Session catch-up is intentionally lazy** — the coordinator is told \"Do NOT scan logs on every session start\" and only does a shallow 2-3 sentence summary even when it detects a different user.\n2. **`now.md` is never updated at session end** — it is read at session start but the Scribe has no task to write handover state back. It goes stale immediately after init.\n3. **`now.md` lacks handover fields** — the template only has `focus_area` and `active_issues`. No space for what was done, what is in progress, what is pending, blockers, or per-agent status.\n4. **No proactive handover detection** — detecting a different user existed but the response was the same shallow catch-up as an explicit ask.\n5. **No routing trigger for manual handover prep** — developers had to explain the concept of handover in natural language every time.\n\n## Proposed Solution\n\n1. **Enhanced `now.md` template** — Add `last_user`, `session_count`, a full \"Last Session Summary\" section (done/in-progress/pending/decisions/blockers), and an \"Agent Last Touched\" table.\n2. **Scribe session-end update** — New Scribe task that updates `now.md` with comprehensive handover state after every batch of agent work. This becomes the primary handover artifact.\n3. **Deep handover briefing on user change** — Split session catch-up: same user gets lazy summary, different user gets automatic deep briefing from `now.md` (proactive, no prompt needed).\n4. **Manual handover routing trigger** — Routing entries for \"prep for handover\", \"wrap up\", \"I am done for today\", \"session done\".\n\n## Files Changed\n\n| File | Change |\n|------|--------|\n| `templates/identity/now.md` | Enhanced template with handover fields |\n| `index.js` | Updated inline `now.md` scaffold to match |\n| `.github/agents/squad.agent.md` | Handover Protocol section, routing trigger, Scribe task |\n| `templates/scribe-charter.md` | Added task 5: write handover state to `now.md` |\n| `docs/guide.md` | Added identity layer to directory tree, handover subsection |\n| `docs/features/memory.md` | Added \"Developer Handover\" section |\n| `docs/tour-first-session.md` | Added handover to tips and next steps |\n| `docs/sample-prompts.md` | Added \"Developer Handover\" prompt section |\n| `docs/whatsnew.md` | Updated identity layer description |\n| `CHANGELOG.md` | Updated identity layer description |\n| `test/init-flow.test.js` | Updated tests for new `now.md` fields |\n| `.squad/identity/now.md` | Updated live file to match new template |\n\n## Testing\n\nAll 95 tests pass (`npm test`).\n","author":{"url":"https://github.com/chrislomonico","@type":"Person","name":"chrislomonico"},"datePublished":"2026-03-03T16:03:51Z","url":"https://github.com/github/squad/issues/181"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:554d1323-ebb8-4078-accb-e470fbfbbb86 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8BDE:A71F9:1898B66:1F0312E:6B017D4E |
| html-safe-nonce | b50ffa70ace9f4d23e6ffd1bb1963bd6a1dfcc8f6adab427895c72f8c4fad3e6 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4QkRFOkE3MUY5OjE4OThCNjY6MUYwMzEyRTo2QjAxN0Q0RSIsInZpc2l0b3JfaWQiOiIxNDQ5NDE3NDc3MzcyOTYyMDYiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 54989c3878b749f3adfb180553fba12c368db7505a71974ede9df7b17beeea0e |
| hovercard-subject-tag | issue:4017474974 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/181/issue_layout |
| twitter:image | https://opengraph.githubassets.com/50f87c01d3e42dbc52fdefb43c683aa1689eb84a224db092ea01a737a7e66857/github/squad/issues/181 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/50f87c01d3e42dbc52fdefb43c683aa1689eb84a224db092ea01a737a7e66857/github/squad/issues/181 |
| og:image:alt | Problem When multiple developers work on a feature branch with a shared squad, handing over context to the next developer requires manually telling the squad to "prep for handover." Without this pr... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | chrislomonico |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width