Softcover: Skill for Claude Code

Handoff

Close out this session so a fresh one can pick up from the tracker alone. The next session starts from the ## Now block of the tracker listed in docs/working/ACTIVE.md, so that block must carry everything it needs.

Procedure

1. Resolve the tracker. Read docs/working/ACTIVE.md (one repo-relative path per line). If it lists one file, use it. If it lists several and this session touched more than one of them, ask the user which to hand off. If it is missing or empty, tell the user and stop.

2. Run the close-out gate when this session changed Kotlin (git diff --name-only HEAD plus untracked *.kt):

   • Grep the changed *.kt files for a glommed closer, ^\s*\)\s*\}. Every hit on a multi-line trailing-lambda body is a finding.
   • In changed test files, every @Test function carries // ----- Arrange -----, // ----- Act ----- and // ----- Assert ----- (or the combined // ----- Act & Assert ----- only where the act cannot be separated). A missing marker is a finding.
   • ./gradlew styleCheck must have passed this session, after the last Kotlin edit. If not, run it.

   Any finding or a failed styleCheck means the step is not done: State must not call it done, and the findings go under Next. Write the gate results under Verification.

3. Rewrite its ## Now block (everything from ## Now up to the next ## heading) to this shape, at most 40 lines:

   ## Now
   
   - **State:** what is done, in one or two sentences. Name finished steps/sections, not the journey.
   - **Next:** the exact next action, with repo-relative file references (the step file and section,
     e.g. `steps/02-gradle-and-read-guards.md` § 3). One item, not a list of options.
   - **Open questions:** anything waiting on the user, or "none".
   - **Verification:** the last gate that ran and its result (e.g. "`./gradlew styleCheck` passed"), or
     "not run" with the reason.
   - **Uncommitted:** a summary of `git status --short` (step 5).