turn-entry-map

Maintains the turn map and its session-entry hook serving logic.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill turn-entry-map-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: turn-entry-map
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/turn-entry-map
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill turn-entry-map-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When editing a session-entry hook or the turn map it serves, it is easy to break silent behaviors: serving an unreadable handover, exiting with a non-zero code, or letting the map drift out of sync with the governing rule. This Skill encodes the pattern for keeping the map, the hook, and the consistency check correct. ## Core Features & Use Cases - Content separation guidance: Defines which lines belong in the turn map (what to do) versus the rule (why), with a concrete selection table. - Hook serving order and safety: Prescribes serving the handover before the map, using -r readability checks, branch-derived handover filenames, and a mandatory exit 0. - Verification workflow: Runs node tools/check-turn-map.mjs to compare map states against the rule both ways, plus a four-case live trial of the hook (both parts, missing handover, missing map, missing both). - Use Case: After adding a new state to the work-conduct rule, use this Skill to update the turn map, re-run the consistency check, and verify the entry hook stays silent with a zero exit code when files are absent. ## Quick Start Ask the assistant to apply the turn-entry-map pattern to update the turn map and verify the entry hook after adding a new state to the work-conduct rule.

Frequently Asked Questions about turn-entry-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep a turn map in sync with its governing rule?

Run node tools/check-turn-map.mjs, which compares state names between the map and the rule's table in both directions. A state declared in the rule but missing from the map, or left in the map after a rename, is reported as a divergence.

What content belongs in a turn map versus the rule?

The map holds lines the session reads to take its next step: state names, mandatory actions, and the four turn exits. Explanations of why an action is required, incident analyses, and rationale stay in the rule.

Why should a session entry hook always exit with code 0?

The entry hook refuses nothing: a session missing part of its context is better than a refused launch. A non-zero exit reads as a refused launch, so the hook must end with exit 0 and have no other exit paths.

Why use -r instead of -f when checking files in a shell hook?

A file can exist but not be readable; -f would let cat through and print a heading over emptiness. The -r test ensures the hook only prints content it can actually read.

What happens when the turn map exceeds its size limit?

The map must be split rather than raising the limit, since a raised limit tends to be raised again until the map becomes a second copy of the rule. The limit itself should be set by measurement, not estimated by line count.