Owner: Training Specialist Tara · Department: knowledge

Process: Creating and Maintaining Training Materials

Process Flow

graph TD
  S0["Purpose"]
  S1["Material types"]
  S0 --> S1
  S2["Creating new training materials"]
  S1 --> S2
  S3["Trigger"]
  S2 --> S3
  S4["Steps"]
  S3 --> S4
  S5["Quarterly review cycle"]
  S4 --> S5
  S6["Trigger"]
  S5 --> S6
  S7["Steps"]
  S6 --> S7
  S8["Update triggers (outside quarterly cycle"]
  S7 --> S8
  S9["Training materials index template"]
  S8 --> S9
  S10["Quality gate"]
  S9 --> S10

Process: Creating and Maintaining Training Materials

Owner: Training Specialist / HR (Tara) Type: Manual Frequency: On-demand (new role, knowledge gap) + quarterly review cycle

Purpose

Defines how training materials are created, maintained, and retired. Ensures factory workers have access to up-to-date, relevant training content that helps them operate effectively. Prevents knowledge rot by enforcing a regular review cycle.

Material types

Type Purpose Example
Role guide Explains what a role does, how to operate it, common scenarios "Operating as QA Engineer — Quick Start"
Process walkthrough Step-by-step guide for executing a specific process "How to run the delivery lifecycle"
Tool reference How to use a specific tool or framework "Using slash commands in Claude Code"
Cross-role playbook How two or more roles collaborate on a workflow "Production-to-QA handoff playbook"
FAQ Answers to common questions about a role or process "QA Engineer FAQ"

Creating new training materials

Trigger

Any of the following:

  • New role is deployed (onboarding identifies training needs)
  • Skill gap analysis reveals missing knowledge
  • Feedback from Fiona indicates role confusion or errors
  • CTO (Clara) directs training on a new topic
  • A cross-role workflow is introduced or changed

Steps

1. Identify the knowledge gap

Actions:

  • Review the trigger source (onboarding report, feedback, directive)
  • Define the specific knowledge or skill that is missing or insufficient
  • Identify the target audience (which roles need this material)
  • Determine the material type that best fits the gap

Output: Training material request: gap description, audience, material type.

2. Gather source content

Actions:

  • Collect relevant source materials:
    • Role definitions (role.md) for the target roles
    • Process documents for relevant processes
    • Knowledge base content from Kai (Knowledge Manager)
    • Eval cases for practical examples
    • Feedback reports from Fiona for real-world issues
  • Interview the role owner or subject matter expert if needed
  • Identify any dependencies (other materials that should exist first)

Output: Source content package.

3. Draft the material

Actions:

  • Write the training material following the appropriate template (see below)
  • Use clear, concise language — assume the reader is a new factory worker
  • Include practical examples from eval cases or real scenarios
  • Include a "common mistakes" section where applicable
  • Include a "when to escalate" section for edge cases
  • Cross-reference related materials and processes

Output: Draft training material in Markdown.

4. Review and validate

Actions:

  • Self-review: Does the material answer the identified knowledge gap?
  • Technical review: Have the relevant role owner or SME verify accuracy
  • Practical review: Walk through the material as if executing it — does it work?
  • If the material involves cross-role collaboration, have both roles review

Output: Reviewed training material with sign-off.

Gate: Material must be reviewed by at least one relevant role owner before publication.

5. Publish and notify

Actions:

  • Store the material in departments/knowledge/training-specialist-tara/materials/
  • Use naming convention: {material-type}-{topic}.md (e.g., role-guide-qa-engineer.md)
  • Notify the target audience that new training material is available
  • Update the training materials index (see below)
  • Record the creation date and next review date (90 days from creation)

Output: Published material, updated index, notifications sent.

Quarterly review cycle

Trigger

Every 90 days from the material's last review date.

Steps

1. Review currency

Actions:

  • Check if the underlying role, process, or tool has changed since last review
  • Check if feedback from Fiona has identified issues related to this material
  • Check if the material references any deprecated roles or processes

Output: Currency assessment: Current / Needs Update / Obsolete.

2. Update or retire

Actions:

  • If Current: Update the "last reviewed" date, no content changes needed
  • If Needs Update:
    • Identify specific changes required
    • Update the material content
    • Re-run the review and validate step (Step 4 from creation)
    • Update the "last reviewed" date
  • If Obsolete:
    • Mark the material as deprecated
    • Move to an archive or delete (per Nomenclature Specialist standards)
    • Remove from the training materials index
    • Notify any roles that relied on this material

Output: Updated or retired material, updated index.

Update triggers (outside quarterly cycle)

The following events trigger an immediate review of affected materials, regardless of the quarterly schedule:

Event Action
Role definition changes Review all materials for that role
Process is modified Review the process walkthrough material
New tool or framework adopted Create new tool reference; update affected materials
Role is deprecated Retire all materials specific to that role
Cross-role workflow changes Review the cross-role playbook
Feedback indicates material is wrong Immediate correction and re-review

Training materials index template

# Training Materials Index

> Last updated: [Date]
> Maintained by: Tara (Training Specialist)

| # | Title | Type | Audience | Created | Last reviewed | Next review | Status |
|---|-------|------|----------|---------|---------------|-------------|--------|
| 1 | [Title] | [Type] | [Roles] | [Date] | [Date] | [Date] | Active |

Quality gate

A training material is ready for publication when:

  • Knowledge gap is clearly identified and documented
  • Source content has been gathered from authoritative sources
  • Material follows the appropriate template
  • At least one relevant role owner has reviewed and approved
  • Material is stored with correct naming convention
  • Training materials index is updated
  • Next review date is set (90 days from publication)