SOP-001: Using Project IDs (The Golden Thread)

Version: 1.0 Created: 2025-12-13 Author: Golden Thread System

---

Purpose

This SOP defines how to create, use, and maintain Project IDs across all platforms. The Project ID is your “Golden Thread” - a unique identifier that connects scattered information across multiple tools and locations.

---

Project ID Format

PROJ-ADJECTIVE-NOUN

Examples:

• PROJ-NEON-WOLF
• PROJ-CYBER-HAWK
• PROJ-SOLAR-PHOENIX

Properties:

• Always uppercase
• Always starts with PROJ-
• Unique across all projects
• Easy to remember
• Easy to search (grep-friendly)

---

Procedure: Creating a New Project ID

Option A: Using the CLI Tool

cd /mnt/d/temp/myprojects/golden-thread-system
python src/scripts/project_id_generator.py

# Or directly:
python src/scripts/project_id_generator.py generate

1. Enter the project name when prompted
2. Enter a brief description (optional)
3. Select status: Active, Planning, or Backlog
4. Copy the generated ID

Option B: Using ControlTower Web App

1. Open src/app/ControlTower.html in a browser
2. Click “Generate ID” in the sidebar
3. Enter project details
4. Click “Save”

Option C: Using Chat Tagger Wizard (Recommended for AI Chats)

1. Open src/app/ChatTaggerWizard.html in a browser
2. Select “New Project” workflow
3. Follow the step-by-step wizard
4. Automatically generates ID, guides chat renaming, documents scatter index

See SOP-002: Chat Tagger Wizard for detailed workflows.

---

Procedure: Using the Project ID Across Platforms

Once you have a Project ID, use it consistently across all platforms where that project exists:

Claude.ai / ChatGPT

• Name the conversation: [PROJ-NEON-WOLF] Building the dashboard
• Or start the chat with: Context: PROJ-NEON-WOLF

Local Folders

D:/Projects/PROJ-NEON-WOLF/
    ├── src/
    ├── docs/
    └── notes.md

File Naming

PROJ-NEON-WOLF_requirements.md
PROJ-NEON-WOLF_architecture.drawio
PROJ-NEON-WOLF_backup_2025-01-01.zip

Git Commits

git commit -m "feat: [PROJ-NEON-WOLF] add user authentication"
git commit -m "fix: [PROJ-NEON-WOLF] resolve login timeout"
git commit -m "docs: [PROJ-NEON-WOLF] update README"

StandardNotes / Note Apps

• Add tag: #PROJ-NEON-WOLF
• Or include in title: [PROJ-NEON-WOLF] Meeting Notes

Google Drive / OneDrive

• Create folder: PROJ-NEON-WOLF
• Name files with prefix: PROJ-NEON-WOLF - Document.docx

Obsidian

• Use the Project Template with the ID in frontmatter
• Tag notes: #PROJ-NEON-WOLF

---

Procedure: Finding Project Assets

To find all assets related to a project:

1. Search in your OS/File Explorer: PROJ-NEON-WOLF
2. Search in Claude.ai: Look for the conversation name
3. Search in Obsidian: Use Dataview or global search
4. Search in code: grep -r "PROJ-NEON-WOLF" .
5. Check ControlTower: Open the project card for links

---

Procedure: Registering Project Locations

When you create a new location for a project (new folder, new Claude chat, etc.):

1. Open ControlTower or the project’s Obsidian note
2. Add the location to the Golden Thread / Links section
3. Include:
   • Platform name (e.g., “Claude”, “Google Drive”)
   • URL or path

This creates a central registry of where the project lives.

---

Best Practices

DO:

• ✅ Use the ID in the first line of any new document
• ✅ Include the ID in commit messages
• ✅ Add the ID as a tag in note-taking apps
• ✅ Register all locations in ControlTower
• ✅ Use consistent casing (always uppercase)

DON’T:

• ❌ Create duplicate IDs manually
• ❌ Use IDs with special characters
• ❌ Abbreviate the ID format
• ❌ Share IDs between unrelated projects

---

Troubleshooting

“I can’t find my project”

1. Check ControlTower for the correct ID
2. Search for the ID in your file system
3. Check the project_db.json file

“I accidentally created a duplicate”

1. Run python project_id_generator.py list to see all IDs
2. The system prevents duplicates automatically
3. If somehow duplicated, update one project’s ID manually

“I forgot which ID belongs to which project”

1. Use python project_id_generator.py search <term>
2. Check ControlTower’s search feature
3. Open the Captain’s Log in Obsidian

---

Related Documents

• src/scripts/project_id_generator.py - CLI tool
• src/app/ControlTower.html - Project registry web interface
• src/app/ChatTaggerWizard.html - Step-by-step AI chat tagging wizard
• SOP-002: Chat Tagger Wizard - Detailed workflows
• outputs/obsidian/templates/Project_Template.md - Obsidian template
• outputs/obsidian/dashboards/00_CAPTAINS_LOG.md - Dashboard

---

Revision History

Version	Date	Changes
1.0	2025-12-13	Initial version