Sam wanted to organize his Projects folder so that each first-level child folder would become its own git repository, structured for AI tools (Claude Code, Cowork, etc.) to work from autonomously. The folder contained 7 project directories: Google Business Profile, Litify Repo, Marketing Repo, Paid Digital, SEO Repo, Server Issues Repo, and UPS Repo. The scope expanded during the session to include credential consolidation, GitHub remote setup, and a Claude Code handoff document.
The core goal: every repo should be clean, logically organized, well-documented, and ready for AI tools to clone and start working from without needing human guidance on where things are or how to access credentials.
Every folder was audited. Loose files were sorted into logical subdirectories. Duplicates were identified and removed. The SEO Repo was the biggest job, with 88 items reorganized into 12 top-level directories: audits/, cannibalization/, content-batches/ (with sub-buckets: keep, fix, rewrite, repurpose, gap-deploy, 8-page-rewrites), landing-pages/ (amazon, location, home), aguiar-landing-page/, design/ (attorney-profiles, results-page, authority-bar, faq-page), blog-content/, skills/, handoffs/, assets/site-images/, and reference/.
The UPS Repo (91 items) was organized into: pleadings/, research/ (with audio/ and transcripts/ subdirectories), evidence/, strategy/, correspondence/, and reference/.
The Marketing Repo (29 items) was organized into: ad-creatives/, brand-kit/, campaigns/, social/, and reference/.
Smaller repos (Google Business Profile, Litify Repo, Paid Digital, Server Issues Repo) got basic structures with posts/, reviews/, optimization/ or audits/, issues/ directories as appropriate.
Six plaintext credential files were found scattered across the SEO Repo, both in a subfolder called "SSH and API Keys" and as duplicate root-level copies. These contained: OpenAI API key, Claude API key, Gemini API key, ElevenLabs API key, Cloudways SSH public key with SFTP access (host: ssh.app21392.cloudwayssites.com, user: admin, port: 2217, password included), and WordPress admin credentials.
All credentials were consolidated into a single CREDENTIALS.md file at the project root (/Projects/CREDENTIALS.md), outside all repos. The root .gitignore blocks this file from ever being committed. Every repo's README.md includes a "Credentials" section pointing AI tools to ../CREDENTIALS.md for autonomous access.
Important design decision: credentials are kept visible and accessible (not hidden in a .secrets folder) because the entire point is for AI tools to find and use them autonomously on Sam's local machine.
All 7 folders were initialized as git repos with per-repo .gitignore files tailored to each repo's content (credentials patterns, large binaries, OS files, node_modules for SEO Repo, audio files for UPS Repo, image assets for Marketing Repo), README.md files with folder structure trees and "Context for AI Tools" sections, initial commits on the main branch, and git config set per-repo (user.email samaguiar1982@gmail.com, user.name Sam Aguiar).
Created setup-github.sh at the project root. This bash script uses the GitHub CLI (gh) to create 7 private repos under the samaguiar1982 account and push each local repo. Repo name mapping: Google Business Profile to google-business-profile, Litify Repo to litify, Marketing Repo to marketing, Paid Digital to paid-digital, SEO Repo to seo, Server Issues Repo to server-issues, UPS Repo to ups-litigation.
Prerequisites for running: brew install gh, then gh auth login.
Created CLAUDE-CODE-HANDOFF.md at the project root with complete instructions for Claude Code to pick up this work.