session-memory git:20260507.9f5be95A

Immutable. This exact content is served forever at /api/v1/blob/33decfa32d7aea14.

---
name: session-memory
description: Mandatory memory persistence system across session resets using three markdown surfaces in .claude/cc10x/. Iron law - every workflow must load at start and update at end.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
graph:
  domains: [domain:software-engineering]
  skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
  workflows: [workflow:feature-development]
  topics: [topic:developer-experience]
  roles: [role:tech-lead, role:backend-engineer]
2. **patterns.md** -- Project conventions, architecture decisions, common gotchas, reusable solutions
3. **progress.md** -- Task completion tracking with verification evidence

---

## Iron Law

EVERY WORKFLOW MUST:
1. LOAD memory at START (and before key decisions)
2. UPDATE memory at END (and after learnings/decisions)

## Stable Edit Anchors

Safe section headers for Edit operations:
- activeContext: `## Recent Changes`, `## Learnings`, `## References`
- patterns: `## Common Gotchas`, `## Project SKILL_HINTS`
- progress: `## Completed`, `## Verification`

## Read-Edit-Verify Pattern

1. Read file
2. Verify anchor exists
3. Edit with exact `old_string`
4. Read back to confirm

## Tool Rules

- Use `Write()` for NEW files (permission-free)
- Use `Edit()` for EXISTING files (permission-free)
- Never use `Write()` to overwrite existing files
- Never compound commands (`mkdir && cat`)

## When to Use

- At the start of every CC10X workflow (load)
- At the end of every CC10X workflow (update)
- Before making key decisions (check patterns)
- After discovering learnings or gotchas (persist)

## Agents Used

All CC10X agents use this skill. The cc10x-router manages load/update lifecycle.