stow

name	stow
description	Sweep the current session for uncaptured durable knowledge and file it to disk before a context reset. Use when the captain invokes /stow (e.g. "/stow", "stow what you've learned"), before a session reset or context compaction, or periodically to keep operational memory current.
user-invocable	true
metadata	{"internal":true}

stow

Sweep this session for durable knowledge that only exists in conversation right now, and write it to the disk locations firstmate already prints in the next session-start context digest. The goal is a session that is safe to reset or destroy because everything durable has already been captured.

What it does

1. Sweep the session for uncaptured durable knowledge. Read back over this conversation and look for:

   • Operational learnings: fleet-local facts and gotchas discovered while operating firstmate (a script's sharp edge, a harness quirk, a recurring false alarm and its real cause).
   • Captain preferences expressed in passing: a working-style or approval preference the captain stated conversationally rather than through data/captain.md directly.
   • Project-intrinsic facts discovered: build, test, release, or architecture facts about a project that belong in that project's own AGENTS.md.
   • Decisions made: a standing choice the captain made this session that should outlive it.
   • Undone next steps: anything left open that has not yet been filed as backlog work.

2. Route each finding using AGENTS.md's knowledge-routing table. AGENTS.md (section 6, "Knowledge routing") is the single source of truth for where each kind of knowledge belongs. Read that table and route each finding there instead of re-deriving the mapping here.

3. Write within firstmate's existing write boundaries. This skill does not grant any new write permission; it only prompts firstmate to use the boundaries that already exist (AGENTS.md section 1):

   • Captain preferences and fleet-local operational facts: hand-write directly, to data/captain.md and data/learnings.md respectively. data/learnings.md may not exist yet; create it on first learning, in the same dated, evidence-backed, curated style as data/captain.md - rewrite and prune stale or superseded entries rather than appending forever.
   • Project-intrinsic knowledge: never hand-write a project's AGENTS.md. Route it through a normal ship task so a crewmate records it via bin/fm-ensure-agents-md.sh and commits it through that project's delivery pipeline, exactly as section 6 describes. If the fleet is live, delegate this to a crewmate rather than doing it inline.
   • Knowledge generalizable to every firstmate user: this repo's own AGENTS.md (or other shared, tracked material), shipped through the normal branch -> no-mistakes -> PR -> captain-merge pipeline for this repo (section 1), never hand-committed straight to main.
   • Task-scoped notes: append to the relevant backlog item's notes with tasks-axi update <id> --append "<note>", or hand-edit data/backlog.md per the active backend (section 10).
   • Undone next steps: file each as a queued backlog item (section 10), with blocked-by recorded if it genuinely depends on something else.

4. Curate, don't just append. When a finding overlaps or supersedes something already on disk, prefer rewriting or pruning the existing entry over piling on a new one. Graduation moves are limited to exactly three: promote a learning to the shared AGENTS.md via PR, fold it into data/captain.md, or delete a stale entry. Do not invent other graduation paths.

5. Report to the captain. Summarize, in plain outcome language (section 9): what was stowed and where, what was filed to the backlog, and whether the session is now safe to reset or destroy - i.e. whether every durable finding from this sweep now lives on disk rather than only in this conversation. If something could not be captured yet (for example, project-intrinsic knowledge waiting on a crewmate to land it), say so explicitly rather than reporting the session fully safe.

Scope exclusion: no skill storage

/stow must never store, create, or edit a skill as a destination for any finding. There is no "graduate this to a skill" move in this skill's routing. This is a deliberate, standing exclusion, not an oversight: even with the two-tier skill layout, a stow sweep is a memory-routing operation, not a way to author or mutate skills. Writing learnings into either .agents/skills/ or public skills/ would still risk mixing fleet-local material with shared firstmate behavior or standalone installer-facing behavior. Until a human deliberately scopes a skill change as firstmate repo work, route generalizable knowledge to the shared AGENTS.md (or other shared, tracked material) via the pipeline, and fleet-local knowledge to data/, never to a skill.