Purpose

Keep the CoC7 knowledgebase consistent across:

• data/*.json source files
• TypeScript definitions (src/types/...)
• loader hooks (e.g., useCoc7Data or equivalent)
• caching strategy and path invariants

Use when

• Adding/updating knowledgebase entries (rules/skills/occupations/etc.)
• Normalizing or deduplicating knowledgebase data
• Fixing data load performance or caching behavior
• Updating auxiliary equipment datasets (weapons/armor/vehicles/etc.)

Inputs expected

• docs/COC7_KNOWLEDGE_GUIDE.md
• knowledgebase data directory
• loader hooks and related types

Workflow

0) Read the guide (required)

Read:

• docs/COC7_KNOWLEDGE_GUIDE.md

1) Data edits with invariants

• Keep file names and paths stable unless the guide explicitly allows changes.
• Maintain consistent IDs/keys if referenced elsewhere.
• For large datasets, avoid duplicating entries; prefer shared references where the system supports it.

2) Types and consumers

• Update TypeScript types if the shape changes.
• Ensure loaders handle optional/missing fields with defaults (unless breaking change is intended).

3) Regression

• Verify at least:
  • knowledgebase loads without errors
  • rulebook pages dependent on datasets render
  • quick find covers newly added items (if relevant)

Output requirements (must output)

• files edited (data + types)
• invariants checked (paths/ids/caching)
• regression steps + key pages tested