00_dev - Development Scripts & Tools

Central repository for development scripts, utilities, and projects
OneDrive Synced: Available on laptop and desktop

---

📁 Directory Structure

00_dev/
├── README.md                      ← You are here
├── SUMMARY.md                     ← Quick dashboard  
├── CHANGELOG.md                   ← Version history
├── .gitignore                     ← Git configuration
├── 00_dev.code-workspace          ← VS Code workspace
│
├── docs/                          ← Documentation hub ⭐
│   ├── guides/                    ← How-to guides
│   │   ├── CLEANUP_COMPLETE.md
│   │   ├── ENHANCED_STRUCTURE_GUIDE.md
│   │   ├── FUTURE_PROOFING_SUMMARY.md
│   │   ├── GIT_SETUP.md
│   │   └── SETUP_SUMMARY.md
│   ├── standards/                 ← Coding standards
│   └── chatlogs/                  ← AI conversation exports
│       ├── raw/                       → Original exports
│       └── chunked/                   → Processed versions
│
├── templates/                     ← Reusable templates ⭐
│   ├── scripts/                   ← Script templates
│   ├── projects/                  ← Project scaffolding
│   └── configs/                   ← Config templates
│
├── config/                        ← Shared configurations ⭐
│   ├── shared/                    ← Cross-app configs
│   ├── dopus/                     ← DOpus settings
│   └── vscode/                    ← VS Code settings
│
├── data/                          ← Data files ⭐
│   ├── sample/                    ← Example data
│   ├── test/                      ← Test datasets
│   └── reference/                 ← Lookup tables
│
├── output/                        ← Generated files ⭐
│   ├── reports/                   ← Generated reports
│   ├── exports/                   ← Exported data
│   └── temp/                      ← Temporary outputs
│
├── archive/                       ← Archived content
│   ├── chatlogs/                  ← Old AI chat exports
│   ├── phases/                    ← Old phase files
│   ├── inventories/               ← Old inventory reports
│   ├── notes/                     ← Random notes
│   ├── temp/                      ← Temporary files
│   ├── old_backups/               ← Old backup folders
│   └── directory_trees/           ← Old directory listings
│
├── projects/                      ← Active development projects
│   ├── folder_merger/             ← Folder organization tool
│   ├── PowerBI_Date/              ← Power BI date dimension project
│   └── [various chunker projects]
│
├── scripts/                       ← Script collection
│   ├── automation/                ← Automation scripts
│   ├── data_processing/           ← Data processing scripts
│   ├── DOpus/                     ← Directory Opus customizations
│   ├── excel_tools/               ← Excel utilities
│   ├── file_operations/           ← File operation scripts
│   ├── geocoder/                  ← Geocoding utilities
│   ├── utilities/                 ← General utilities
│   │   ├── process_chatlog_portable.bat  ⭐ Portable chatlog processor
│   │   └── [various Python & PowerShell scripts]
│   └── README.md                  ← Script documentation
│
├── tools/                         ← Development tools
│
└── directory_opus/                ← Directory Opus configurations
    ├── github_PolarGoose/         ← Community themes/configs
    └── github_thiojoe/            ← Additional DOpus resources

---

🎯 Purpose

This directory serves as a centralized hub for:

• ✅ Cross-machine scripts (synced via OneDrive)
• ✅ Development projects in active development
• ✅ Reusable utilities for common tasks
• ✅ Tool configurations (DOpus, VS Code, etc.)
• ✅ Archive of old/completed work

---

⭐ Key Features

1. Portable Chatlog Processor

Location: scripts/utilities/process_chatlog_portable.bat

Usage: Drag & drop .md chatlog file onto script
Features:

• Works with any project (Unified Dictionary, CAD, RMS, etc.)
• Auto-detects project locations
• Handles chunking automatically
• OneDrive synced (works on all machines)

Quick Start:

1. Export chatlog from AI with descriptive filename
2. Drag .md file onto: scripts\utilities\process_chatlog_portable.bat
3. Select project from menu
4. Done! File organized and chunked

2. Script Collection

Location: scripts/

Organized by category:

• automation/ - Task automation scripts
• data_processing/ - Data transformation scripts
• excel_tools/ - Excel to CSV converters
• file_operations/ - File management utilities
• DOpus/ - Directory Opus buttons and configs
• geocoder/ - Location geocoding tools
• utilities/ - General-purpose helpers

3. Active Projects

Location: projects/

Current projects in development:

• folder_merger - Intelligent folder organization tool
• PowerBI_Date - Power BI date dimension and automation
• Various chunker versions - Chat log processing tools

4. Archive System

Location: archive/

Organized storage for:

• Old chatlogs from AI sessions
• Completed phase files
• Historical inventories
• Random notes and documentation
• Temporary files
• Old backups

---

🚀 Quick Start

Access Scripts

# Navigate to scripts
cd "C:\Users\carucci_r\OneDrive - City of Hackensack\00_dev\scripts"

# Browse available scripts
dir /s *.py
dir /s *.ps1
dir /s *.bat

Process a Chatlog

# Drag & drop method (recommended)
1. Export chatlog as: Project_Discussion.md
2. Drag onto: scripts\utilities\process_chatlog_portable.bat
3. Select project
4. Done!

# Or use from command line
scripts\utilities\process_chatlog_portable.bat "My_Chat.md" unified_data_dictionary

Open in VS Code

# Open entire workspace
code 00_dev.code-workspace

---

📋 Common Tasks

Add a New Script

# Navigate to appropriate category
cd scripts\[category]\

# Add your script
# Update category README.md
# Test the script

Start a New Project

# Create project folder
mkdir projects\MyNewProject

# Initialize structure
cd projects\MyNewProject
# Create README, .gitignore, etc.

Archive Old Content

# Move to appropriate archive folder
move "old_file.md" archive\chatlogs\
move "Phase_*.md" archive\phases\
move "temp_*" archive\temp\

---

🔧 Development Tools

VS Code Workspace

• File: 00_dev.code-workspace
• Features: Multi-folder workspace configuration
• Usage: code 00_dev.code-workspace

Directory Opus

• Location: directory_opus/
• Content: Buttons, themes, configurations
• Import: Via DOpus Settings > Import

Python Scripts

• Location: Various scripts/ subfolders
• Requirements: See individual script documentation
• Virtual Env: Use project-specific venvs

---

📖 Documentation

Script Documentation

• Main scripts README: scripts/README.md
• Category READMEs in each scripts/[category]/ folder
• Individual script headers contain usage instructions

Project Documentation

• Each project has its own README.md
• See projects/[project_name]/README.md

Archive Index

• Chatlogs: archive/chatlogs/ (by date)
• Phases: archive/phases/ (by phase number)
• See folder structure for organization

---

🎨 TextExpander Integration

Snippets for this Repository

glog - Generate chatlog filename

Prompts AI for descriptive chatlog filename
Then process with portable script

gdoc - Update docs and commit

Updates documentation
Commits to Git
Pushes to GitHub

---

💡 Best Practices

Organization

• ✅ Keep root directory clean (essential files only)
• ✅ Use appropriate subfolder for new content
• ✅ Archive old/completed work regularly
• ✅ Maintain README files in each folder

Scripts

• ✅ Add header comments with usage instructions
• ✅ Use descriptive filenames
• ✅ Include error handling
• ✅ Test before committing

Projects

• ✅ Use Git for version control
• ✅ Maintain README with setup instructions
• ✅ Include requirements.txt for Python projects
• ✅ Use .gitignore appropriately

Chatlogs

• ✅ Use descriptive filenames (4-8 words, Title Case)
• ✅ Process through portable script
• ✅ Raw copies in project-specific docs/chatlogs/raw/
• ✅ Chunked versions in docs/chatlogs/chunked/

---

🔍 Finding Things

Search for Scripts

# PowerShell scripts
dir /S *.ps1 | findstr "automation"

# Python scripts
dir /S *.py | findstr "geocode"

# Batch files
dir /S *.bat

Search Archive

# Find old chatlogs
dir /S archive\chatlogs\*.md

# Find phase files
dir /S archive\phases\Phase*.md

# Recent archived items
dir /O:-D archive\temp\

Find Projects

# List all projects
dir /B projects\

# Find project by name
dir /S projects\ | findstr "PowerBI"

---

🔗 Related Repositories

On GitHub

• Unified Data Dictionary: racmac57/unified_data_dictionary
• Additional repos in development

Local Projects

• 09_Reference/Standards/: Canonical standards repos
  • unified_data_dictionary/
  • CAD/
  • RMS/
  • DV/

---

🛠️ Maintenance

Regular Tasks

• Weekly: Archive completed chatlogs
• Monthly: Review and cleanup temp files
• Quarterly: Update documentation
• As Needed: Reorganize projects

Cleanup Checklist

• Move old chatlogs to archive
• Archive completed projects
• Remove obsolete temp files
• Update README files
• Test key scripts still work
• Verify OneDrive sync is working

---

📊 Statistics

Created: October 2025
Last Organized: December 17, 2025
Root Items: ~8 (kept minimal)
Scripts: 50+ utilities
Projects: 10+ active/archived
Archive: Full history preserved

---

📞 Quick Reference

Key Paths

Root:           C:\Users\carucci_r\OneDrive - City of Hackensack\00_dev
Scripts:        00_dev\scripts\
Projects:       00_dev\projects\
Archive:        00_dev\archive\
Portable Tool:  scripts\utilities\process_chatlog_portable.bat

Common Commands

# Open workspace
code 00_dev.code-workspace

# Navigate to scripts
cd scripts\utilities

# Process chatlog
process_chatlog_portable.bat "filename.md"

# List all scripts
dir /S *.py *.ps1 *.bat

---

✨ Summary

This 00_dev directory is your:

• 📦 Central script repository (synced across machines)
• 🚀 Active project workspace (current development)
• 🗄️ Organized archive (historical reference)
• 🔧 Tool configuration hub (DOpus, VS Code, etc.)

Keep it organized, document your work, and leverage the portable tools!

---

Last Updated: December 17, 2025
Maintained By: R. A. Carucci
OneDrive Synced: ✅ Yes