Session 4 — Context Management & Custom Skills (Detailed Agenda)

Total Duration: 2.5 hours (150 minutes) Phase / Week: Phase 2, Week 3 or 4 Format: Hands-on workshop, co-authoring in real Turner repos Required attendees: Turner developers; at least one architect; the learning bed's domain expert (committed in Session 0)

Pre-session prep (Turner)

  • Identify the workflow on the learning bed product that will anchor the SKILL.md exercise (a code-review checklist, a deployment runbook, a domain-specific test pattern, etc.) — surfaced during Sessions 1-2
  • Confirm write access to the learning bed's repo (or a branch/fork) for the live authoring exercise
  • Have the learning bed's domain expert for the chosen workflow on the call

Agenda

0:00 – 0:15 (15 min) — Recap of the governance framework and where context lives

  • Lead: Nubitz
  • Format: Briefing
  • Tie back to Session 2's governance decisions. Reinforce why context assets matter and how they enforce Turner's standards on AI-generated code.

0:15 – 0:40 (25 min) — Anatomy of a good CLAUDE.md / AGENTS.md

  • Lead: Nubitz
  • Format: Demo with annotated examples
  • Walk through 2-3 real examples (sanitized). What goes in, what doesn't, how to keep it maintainable. Address common antipatterns (kitchen-sink files, stale instructions, conflicting signals).

0:40 – 1:20 (40 min) — Exercise A: Author a CLAUDE.md for the learning bed's repo

  • Lead: Developers, architect coordinating; Nubitz floating
  • Format: Hands-on, paired
  • Working in pairs, draft a CLAUDE.md/AGENTS.md for the learning bed. Test it with a small task and observe whether Claude's behavior actually shifts. Iterate.

1:20 – 1:30 (10 min) — Break

1:30 – 1:50 (20 min) — SKILL.md fundamentals

  • Lead: Nubitz
  • Format: Demo
  • What a skill is, when to write one, how it's discovered, and what differentiates a useful skill from one that fights you. Show one example skill end-to-end.

1:50 – 2:20 (30 min) — Exercise B: Build a SKILL.md together

  • Lead: Joint — Nubitz drives, domain expert provides content, developers contribute
  • Format: Co-authoring
  • Build a skill for the chosen learning bed workflow. Validate against 2-3 real tasks on the learning bed. Note adjustments and capture them.

2:20 – 2:30 (10 min) — Maintenance and rollout discussion

  • Lead: Nubitz, facilitating
  • Format: Discussion + synthesis
  • Who owns these files in Turner's org? How do they get reviewed and updated? Capture the operational plan and preview Session 5.

Materials

  • 2-3 sanitized CLAUDE.md example files (Nubitz)
  • A vetted SKILL.md template (Nubitz)
  • Maintenance/ownership one-pager template

What Nubitz produces after this session

  • A committed CLAUDE.md/AGENTS.md in the learning bed's repo (or a PR with one)
  • At least one SKILL.md ready to ship into the learning bed's repo
  • Updates to the Developer Reference Guide covering context-asset authoring

Risks to manage

  • Repo access blockers: without write access this exercise becomes hypothetical — confirm 48 hours in advance.
  • Skill scope creep: pick a narrow,