docs: document polecat lifecycle (session/sandbox/slot layers)

Clarifies the three distinct lifecycle layers to prevent confusion:
- Session (Claude context): ephemeral, cycles per step
- Sandbox (worktree): persistent until nuke
- Slot (name from pool): persistent until nuke

Addresses anti-patterns like "idle polecats" and misunderstanding
what recycling means. (gt-bc6gm)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
chumbucket
2026-01-04 14:22:20 -08:00
committed by Steve Yegge
parent eea4435269
commit 4b8b444133
3 changed files with 229 additions and 1 deletions

View File

@@ -182,6 +182,9 @@ to the merge queue. Without this step:
## Self-Managed Session Lifecycle
> See [Polecat Lifecycle](docs/polecat-lifecycle.md) for the full three-layer architecture
> (session/sandbox/slot).
**You own your session cadence.** The Witness monitors but doesn't force recycles.
### Closing Steps (for Activity Feed)