On this page

Gem Creation Guide

💎 Creating the “Forensic Architect” Gem

Objective: Consolidate your “Hack Packs” into a single, always-on AI expert.

1. Preparation

Ensure you have the following artifacts ready (generated by python scripts/compile_registry.py):

  1. Registry: public/assets/prompts/PROJECT_INDEX.md
  2. Instructions: public/assets/prompts/GEM_MASTER_INSTRUCTION.md

2. Gemini Creation Steps

  1. Direct Link: Go to gemini.google.com/gems. (This should bypass the “Labs” interface).
  2. Click “New Gem”.
  3. Critical Check:
    • If you see “Steps” (Case Details, Render Portfolio), you are still in Gemini Labs. Stop.
    • If you see “Instructions” (System Prompt), you are in the Gem Manager. Proceed.
  4. The “Magic Maker” Interface:
    • You may see a screen asking: “Describe the AI mini app you want to build”.
    • Action: Type “A forensic portfolio architect” and hit Enter.
    • Let it generate a draft.
  5. Enter Manual Editor:
    • Look for the Edit button (or Pencil icon) to switch to the structured view.
    • You need the view that shows Name, Instructions, and Knowledge.
  6. Configuration:
    • Name: Forensic Portfolio Architect
    • Instructions:
      • Open GEM_MASTER_INSTRUCTION.md.
      • Copy the Entire Text.
      • Paste it into the “Instructions” box (replace whatever the Magic Maker wrote).
    • Knowledge (The Registry):
      • Click “Add Source” (Google Drive or Upload).
      • Select PROJECT_INDEX.md. (Note: You may need to upload this file to Google Drive first, or copy-paste it into a new Google Doc if you prefer live-editing).
      • Result: The Gem now has the “Card Catalog.”
  7. Tools:
    • Default Tool: Select “No default tool”.
    • Why? We want the Gem to prioritize your Registry (PROJECT_INDEX.md). We do not want it arbitrarily searching the web (“Deep Research”) or trying to generate images. Use the “Air Gap” logic.

Pro Tip: Model Selection (Preview Window)

You may see a dropdown for Fast / Pro / Thinking.

  • Recommended: Thinking (or Gemini 3 Thinking).
  • Why? The “Forensic Architect” often needs to “Synthesize Context” across multiple projects (e.g., “Compare the thermal strategy of WebTV and C24”). The Thinking model is significantly better at this multi-step reasoning and adherence to the “Air Gap” protocol.

3. Deployment Check

Test the Gem with the “C24 Shibboleth”:

User: “Tell me about the C24 thermal crisis.”

Expected Response:

  1. Summary: Mentions the “Banana Defect” and the “Vertical Hanging Fixture” (Method A).
  2. Routing: “For the validation data, consult the Detail Pod: [NotebookURL]“

4. Maintenance

When you add a new project:

  1. Run python scripts/compile_registry.py.
  2. Open your Gem in Gem Manager.
  3. Delete the old PROJECT_INDEX.md.
  4. Upload the new PROJECT_INDEX.md. (Note: As of Jan 2026, Gems do not auto-sync with local files. Manual re-upload is required).