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,