Skip to content

feat: Automatic developer handover via identity/now.md #180

New issue
New issue
Closed
Closed
feat: Automatic developer handover via identity/now.md#180
Labels
go:needs-researchNeeds investigationpriority:p2Next sprintsquadSquad triage inbox — Lead will assign to a membertype:featureNew capability

Description

@chrislomonico
chrislomonico
opened on Mar 3, 2026

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 proactive briefing — they have to remember to ask "catch me up" or re-explain the project state to the squad.

The 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.

Root Cause (5 interconnected gaps)

  1. 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.
  2. 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.
  3. 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.
  4. No proactive handover detection — detecting a different user existed but the response was the same shallow catch-up as an explicit ask.
  5. No routing trigger for manual handover prep — developers had to explain the concept of handover in natural language every time.

Proposed Solution

  1. 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.
  2. 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.
  3. 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).
  4. Manual handover routing trigger — Routing entries for "prep for handover", "wrap up", "I am done for today", "session done".

Files Changed

File Change
templates/identity/now.md Enhanced template with handover fields
index.js Updated inline now.md scaffold to match
.github/agents/squad.agent.md Handover Protocol section, routing trigger, Scribe task
templates/scribe-charter.md Added task 5: write handover state to now.md
docs/guide.md Added identity layer to directory tree, handover subsection
docs/features/memory.md Added "Developer Handover" section
docs/tour-first-session.md Added handover to tips and next steps
docs/sample-prompts.md Added "Developer Handover" prompt section
docs/whatsnew.md Updated identity layer description
CHANGELOG.md Updated identity layer description
test/init-flow.test.js Updated tests for new now.md fields
.squad/identity/now.md Updated live file to match new template

Testing

All 95 tests pass (npm test).

Activity

  1. bradygaster
    added 4 commits that reference this issue on Mar 4, 2026

    test: edge-case coverage for resolution module (#180)

    a854ba4

    chore(squad): merge decision inbox and log epic #180 completion

    3801fc1

    docs: squad-sdk README + root README fixes

    acb73a3

    docs: squad-cli README for npmjs.com

    5dc9282
  2. bradygaster
    added
    release:deferDeferred past next release
    squadSquad triage inbox — Lead will assign to a member
    squad:keaton
    release:v0.8.22Release v0.8.22
    on Mar 6, 2026
  3. github-actions
    removed
    release:deferDeferred past next release
    on Mar 7, 2026

  4. github-actions commented on Mar 7, 2026

    @github-actions
    github-actionsBot
    on Mar 7, 2026 – with GitHub Actions
    Contributor

    🏷️ Release target updated → release:v0.8.22

  5. github-actions commented on Mar 7, 2026

    @github-actions
    github-actionsBot
    on Mar 7, 2026 – with GitHub Actions
    Contributor

    📋 Assigned to Keaton (Lead)

    Issue: #180 — feat: Automatic developer handover via identity/now.md

    Keaton will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    Keaton, work on issue #180

  6. github-actions
    added
    squad:hockney
    on Mar 7, 2026

  7. github-actions commented on Mar 7, 2026

    @github-actions
    github-actionsBot
    on Mar 7, 2026 – with GitHub Actions
    Contributor

    🏗️ Squad Triage — Keaton (Lead)

    Issue: #180 — feat: Automatic developer handover via identity/now.md
    Assigned to: Hockney (Tester)
    Reason: Issue relates to testing/quality work

    @copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

    Team roster:

    • Keaton (Lead) → label: squad:keaton
    • Verbal (Prompt Engineer) → label: squad:verbal
    • Fenster (Core Dev) → label: squad:fenster
    • Hockney (Tester) → label: squad:hockney
    • McManus (DevRel) → label: squad:mcmanus
    • Kujan (SDK Expert) → label: squad:kujan
    • Edie (TypeScript Engineer) → label: squad:edie
    • Kobayashi (Git & Release) → label: squad:kobayashi
    • Fortier (Node.js Runtime) → label: squad:fortier
    • Rabin (Distribution) → label: squad:rabin
    • Baer (Security) → label: squad:baer
    • Redfoot (Graphic Designer) → label: squad:redfoot
    • Strausz (VS Code Extension) → label: squad:strausz
    • Saul (Aspire & Observability) → label: squad:saul
    • Kovash (REPL & Interactive Shell) → label: squad:kovash
    • Marquez (CLI UX Designer) → label: squad:marquez
    • Cheritto (TUI Engineer) → label: squad:cheritto
    • Breedan (E2E Test Engineer) → label: squad:breedan
    • Nate (Accessibility Reviewer) → label: squad:nate
    • Waingro (Product Dogfooder) → label: squad:waingro
    • Ralph (Work Monitor) → label: squad:ralph
    • @copilot (Coding Agent) → label: squad:copilot

    To reassign, remove the current squad:* label and add the correct one.

  8. github-actions
    added
    go:needs-researchNeeds investigation
    on Mar 7, 2026
  9. bradygaster
    added
    squad:flight
    squad:fido
    and removed
    release:v0.8.22Release v0.8.22
    squad:keaton
    squad:hockney
    on Mar 8, 2026

  10. github-actions commented on Mar 9, 2026

    @github-actions
    github-actionsBot
    on Mar 9, 2026 – with GitHub Actions
    Contributor

    📋 Assigned to Flight (Lead)

    Issue: #180 — feat: Automatic developer handover via identity/now.md

    Flight will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    Flight, work on issue #180

  11. github-actions commented on Mar 9, 2026

    @github-actions
    github-actionsBot
    on Mar 9, 2026 – with GitHub Actions
    Contributor

    📋 Assigned to FIDO (Quality Owner)

    Issue: #180 — feat: Automatic developer handover via identity/now.md

    FIDO will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    FIDO, work on issue #180

  12. bradygaster
    added
    type:featureNew capability
    priority:p2Next sprint
    squad:eecom
    and removed
    squad:flight
    squad:fido
    on Mar 13, 2026

  13. github-actions commented on Mar 15, 2026

    @github-actions
    github-actionsBot
    on Mar 15, 2026 – with GitHub Actions
    Contributor

    📋 Assigned to EECOM (Core Dev)

    Issue: #180 — feat: Automatic developer handover via identity/now.md

    EECOM will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    EECOM, work on issue #180

  14. bradygaster commented on Mar 15, 2026

    @bradygaster
    bradygaster
    on Mar 15, 2026
    Collaborator

    Hey @chrislomonico — great news! The handover concept you described here is now live. .squad/identity/now.md exists and the coordinator reads it on every session start, automatically briefing the next developer on what the team's been focused on. Your idea shaped how we think about continuity between sessions. Closing this as implemented — thank you for the thoughtful proposal! 🚀

  15. bradygaster
    closed this as completedon Mar 15, 2026
  16. bradygaster
    removed
    squad:eecom
    on Sep 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    go:needs-researchNeeds investigationpriority:p2Next sprintsquadSquad triage inbox — Lead will assign to a membertype:featureNew capability

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions