Load Production Context

Skill: load-production-context

Scopo

PunxFilm Breakdown è un'app di pre-produzione cinematografica che deve rispecchiare l'operatività reale di set italiano. Ogni feature che tocca schedule/budget/ODG/screenplay dev'essere coerente con:

• MovieMagic Scheduling (MMS) — industry standard stripboard/DOOD
• MovieMagic Budgeting (MMB) — industry standard chart of accounts
• Final Draft (FDX) — industry standard screenplay format
• CCNL Troupe italiano — turnaround 11h, meal break, overtime
• L.977/67 — lavoro minori nello spettacolo
• Permessi italiani — Comune/Prefettura/Questura/ENAC/ASL/VVFF
• Competitor landscape — StudioBinder, Croogloo, Autodesk Flow, Yamdu, Cinelytic

Questa skill carica in contesto i file KB per permettere all'orchestrator (e ai subagent) di ragionare con fonti verificate invece che con training generico.

Quando invocarmi

Trigger manuale esplicito

• L'utente dice "load production context", "carica KB produzione", "/load-production-context"

Trigger automatico consigliato (hook opzionale)

L'orchestrator carica questa skill prima di task che toccano:

• lib/schedule/** (incluso lib/schedule/compliance/**)
• lib/odg/**
• lib/budget/**
• lib/screenplay/**
• lib/parsers/** (per FDX/PDF screenplay parsing)
• components/schedule/**
• components/odg/**
• components/budget/**

Trigger obbligatorio

• Prima di ogni /convoca-parlamento: così tutti i subagent del parliament ragionano allineati sulla stessa KB.
• Prima di review architettura che tocca il core workflow screenplay → spoglio → breakdown → PdL → DOOD → ODG → budget.
• Prima di task di marketing/competitor analysis che richiede visione competitor.

Prerequisiti

• Directory content/knowledge-base/ presente
• 8 file MD KB presenti:
  • INDEX.md
  • moviemagic-scheduling.md
  • moviemagic-budgeting.md
  • final-draft-screenplay.md
  • produzione-italiana-compliance.md
  • set-operations-realtime.md
  • competitor-landscape.md
  • landing-copywriting-apple-style.md

Se uno o più file mancano, emetto warning ma carico comunque i presenti.

Flusso

Step 1 — Read INDEX

Leggo content/knowledge-base/INDEX.md per ottenere:

• Mappa agent → KB files (quali file deve leggere quale agent)
• Convenzioni KB (version, updated, sources)
• Trigger di caricamento automatico

Step 2 — Load all 7 domain files

Carico sequenzialmente:

1. moviemagic-scheduling.md
2. moviemagic-budgeting.md
3. final-draft-screenplay.md
4. produzione-italiana-compliance.md
5. set-operations-realtime.md
6. competitor-landscape.md
7. landing-copywriting-apple-style.md

Cost stimato: ~10-12K tokens totali (sostenibile per un contesto tipico).

Loading selettivo: per task puramente tech (es. refactor lib/parsers/), posso caricare solo i 4 file produzione core (1-4) e skippare 5-7 per risparmio token. Per task marketing, carico solo 6-7 + INDEX.

Step 3 — Context priming

Una volta caricati, l'orchestrator deve:

1. Citare almeno un pattern MMS/MMB/FD/CCNL ogni volta che propone una decisione architetturale su moduli produzione.

2. Usare gli Example sections nei KB file come reference per "pattern giusto vs sbagliato" (vedi sezione "Pattern critici per tech agent" in ogni MD).

3. Cross-reference tra file KB quando una decisione coinvolge più domini (es. scheduling change → budget impact + compliance constraint).

4. Aggiornare la KB se durante il lavoro emerge un pattern produzione non ancora documentato:

   • Aggiungi entry al MD corrispondente
   • Commit separato: docs(kb): <file> +<topic>
   • Incrementa version nel header

Step 4 — Subagent briefing

Quando invoco un subagent che dichiara nel frontmatter reads_knowledge_base: [...]:

• Passo in automatico i riferimenti ai MD rilevanti nel prompt
• Aspetto che il subagent citi almeno 1 KB file nella sua response (gate di qualità)

Output

Questa skill NON produce un file output. Il suo effetto è:

1. Contesto popolato con KB complete (disponibile per tutti i successivi tool call)
2. Consapevolezza operativa — ogni decisione può essere tracciata a un pattern verificato
3. Consistency tra subagent — tutti ragionano sullo stesso base di conoscenza

Log info a summary-level:

• Quali file sono stati caricati (count + total size)
• Eventuali file mancanti (warning)
• Version + last updated di ogni file

Esempi d'uso

Esempio 1 — Prima di programmare su lib/schedule

Utente: "Voglio implementare il T702 Realtime recompute PdL"

Orchestrator:

1. Riconosce che T702 tocca lib/schedule/**
2. Invoca automaticamente /load-production-context
3. Ora ha in contesto le KB
4. Procede con design ragionando su:
   • MMS pattern: strip drag → DOOD auto-recompute (stable)
   • CCNL turnaround: hard constraint mai silent
   • Impact stradale: company move → calcolo cost budget (cita KB budget)
5. Giustifica scelte in terms di produzione reale, non solo code hygiene

Esempio 2 — Prima di convocare parliament

Utente: "Convoca parliament 005"

Orchestrator:

1. Invoca /load-production-context (prerequisito)
2. Il contesto è popolato
3. Invoca /convoca-parlamento
4. Il parlamento-produzione-agent (e tutti i subagent che inviterà) ragionano su fonti KB verificate
5. Proposte emesse sono production-grounded, non astratte

Esempio 3 — Durante code review

Utente: "Review questo refactor di lib/schedule/build.ts"

Orchestrator:

1. Riconosce il path lib/schedule/**
2. Invoca /load-production-context
3. Review il codice con lente: "questo pattern riflette MMS stripboard mechanics? Il naming è production-coherent? Le funzioni single-responsibility mirror della pipeline screenplay→breakdown→stripboard→DOOD?"

Troubleshooting

KB file mancante

Se un file KB non esiste:

• Emetto warning "KB file <name> missing, reasoning may be incomplete"
• Carico comunque i presenti
• Suggerisco di aggiungerlo in prossimo sprint (o se critico, creo stub + task in TODO_STATUS)

KB file outdated

Se updated in header è >90 giorni:

• Emetto warning "KB file <name> updated >90 days ago, may need refresh"
• Prosegue
• Trigger opzionale skill /refresh-kb (T1805, future)

Context budget

Se i KB totali + task corrente superano token budget:

• Carico priorità: INDEX + file dominio rilevante + competitor-landscape (se marketing task)
• Skippo file meno rilevanti con log warning

Integration con CLAUDE.md

La sezione "Production Knowledge References" in CLAUDE.md (aggiunta in T1701.8) riferisce a questa skill come protocollo obbligatorio per task produzione. L'orchestrator deve:

• Caricare KB prima di task produzione (automatico o manuale)
• Citare KB nelle giustificazioni architetturali
• Richiedere ai subagent di fare lo stesso

Related skills

• /update-todo — pre-requisito se lavoro con TODO_STATUS
• /convoca-parlamento — lo consuma come prerequisito
• /refresh-kb (T1805, future) — aggiornamento KB da fonti esterne
• /competitor-feature-gap (T1703, future) — usa competitor-landscape.md specificamente

Version + maintenance

• Version: 1.0 (created 2026-04-23 in T1701)
• Maintained by: orchestrator + product-architect-agent
• Update policy: quando KB files cambiano, questa skill non cambia (è stateless wrapper); quando aggiungo nuovi KB files, aggiorno la lista in Step 2.

References

• content/knowledge-base/INDEX.md — struttura KB
• CLAUDE.md §"Production Knowledge References" — protocollo orchestrator
• TODO_STATUS.md — roadmap task T1701 creation context
• Plan file: /Users/simonerossi/.claude/plans/ora-ti-chiedo-di-rippling-tiger.md