Golden Thread System

A “Control Tower” / Meta-Layer system for vertical traceability - connecting high-level goals (OKRs) down to specific code/commits, while indexing scattered data across multiple platforms.

Core Concept: The Golden Thread

Don’t migrate the mess - INDEX it.

Instead of consolidating thousands of notes into one place, use a Project ID as your “golden thread” that connects assets across ALL platforms:

PROJ-NEON-WOLF → Claude.ai chat
             → Local folder D:/Projects/PROJ-NEON-WOLF
             → Google Drive folder
             → GitHub repo
             → Obsidian note
             → StandardNotes tag

Quick Start

1. Generate a Project ID

Option A: CLI Tool

cd golden-thread-system
python src/scripts/project_id_generator.py

Option B: ControlTower Web App

# Open in browser
start src/app/ControlTower.html   # Windows
open src/app/ControlTower.html    # macOS
xdg-open src/app/ControlTower.html # Linux

2. Tag Your AI Chats (New!)

Chat Tagger Wizard - Step-by-step workflow for organizing AI conversations:

start src/app/ChatTaggerWizard.html   # Windows

Four workflow modes:

New Project - Generate ID, tag chat, document scatter index
Tag Existing Chat - Apply existing Project ID to a conversation
Archive Sprint - Bulk-tag old chats (Bankruptcy Protocol)
Morning Scan - 5-minute review of active projects

3. Use the ID Everywhere

Platform	How to Use
Claude/ChatGPT	Name chat: `[PROJ-NEON-WOLF] My Project`
Folders	`D:/Projects/PROJ-NEON-WOLF/`
Files	`PROJ-NEON-WOLF_notes.md`
Git commits	`feat: [PROJ-NEON-WOLF] add feature`
Note apps	Tag: `#PROJ-NEON-WOLF`

3. Track in ControlTower

Open ControlTower to register all locations where the project lives (“Golden Thread” links).

Components

ControlTower Web App

src/app/ControlTower.html

Generate unique Project IDs
Register and track projects
Add “Golden Thread” links (where project lives)
Export/Import JSON backup
Filter and search

Chat Tagger Wizard (New!)

src/app/ChatTaggerWizard.html

New Project workflow: Generate ID → Tag chat → Document scatter index → Create Obsidian note
Tag Existing Chat: Apply existing Project ID to conversations
Archive Sprint: Bulk workflow for the “Bankruptcy Protocol” - tag or archive old chats
Morning Scan: 5-minute daily review of active projects
Shares localStorage with ControlTower (projects sync automatically)

Project ID Generator (CLI)

src/scripts/project_id_generator.py

# Interactive menu
python project_id_generator.py

# Direct commands
python project_id_generator.py generate    # Create new project
python project_id_generator.py list        # List all projects
python project_id_generator.py search TERM # Search projects
python project_id_generator.py export-obsidian  # Export to Obsidian

Obsidian Templates

outputs/obsidian/

templates/Project_Template.md - Template for new project notes
dashboards/00_CAPTAINS_LOG.md - Dataview-powered dashboard

Copy to your Obsidian vault and use with the Dataview plugin.

Project Structure

golden-thread-system/
├── src/
│   ├── app/
│   │   └── ControlTower.html    # Web app
│   └── scripts/
│       ├── project_id_generator.py  # CLI tool
│       └── project_db.json      # Project database
├── outputs/obsidian/            # Obsidian components
├── docs/SOPs/                   # Standard Operating Procedures
├── tests/                       # Unit and manual tests
├── ai-memory/                   # Multi-AI collaboration workspace
├── KB/references/               # Original docs and prototypes
└── scenarios/                   # SPINE orchestration configs

Documentation

SOP-001: Using Project IDs - How to use the Golden Thread

Development

Run Tests

python -m pytest tests/ -v

SPINE Integration

This project is orchestrated by SPINE. See .spine/config.json for configuration.

Philosophy

Index, don’t migrate - Accept that data is scattered; build a meta-layer that points to it
One ID, everywhere - Project IDs are grep-friendly and work across all platforms
AI as Librarian - Use Claude/ChatGPT to summarize messy notes into clean project summaries
Lightweight pointers - No complex syncing, just consistent naming