Restructure: extract projects to standalone repos, convert root to README index (rebased)

[hansraj316]

Supersedes #8 (closed due to merge conflicts with subsequent automation commits on main).

Summary

• Extracted three substantive projects to their own private repos with preserved history (git subtree split):
  • CoachAI/ → hansraj316/coach-ai (15 commits)
  • InterviewAgent/ → hansraj316/interview-agent (46 commits) — public hansraj316/InterviewAgent showcase repo is untouched
  • ai_agent_project/ → hansraj316/ai-agent-project (3 commits)
• Removed exploratory stubs: ClaudeCode, ClaudeCode-v2, WikiRevamp, windsurf-demo, Project Starlink, Azure DevOps MCP, Ghostty, plus stray root drafts.
• Removed agentdate submodule; now a plain link in the README index.
• Removed .github/workflows/ci.yml — every job was targeting deleted folders; no code remains in-repo to test or lint.
• Removed orphaned Python linter configs (mypy.ini, pytest.ini, .flake8).
• Removed an orphaned .git/hooks/pre-commit (local only).
• Rewrote README.md: merged with the automation's richer portfolio index — kept AgentDate, AgentMesh, Mission Control, PMChat, OllamaBar, EdgeShield, PhishShield, InterviewAgent sections; added the newly-extracted repos; dropped the "Experiments & Learning" and "Project Structure" blocks (they described folders that no longer exist); preserved the "Daily TPM delivery update" format so the automation can keep appending to it.

Test plan

• Verified extracted branches had no secrets in tree or history (only .env.example files; encrypt_credentials.py is a script for encrypting, not credentials themselves)
• Local .env files backed up to ~/projects-env-backup-2026-04-23/ before folder deletion
• Merge this PR — Projects/ becomes a clean README index
• After merge, watch for the automation's next run — it may re-introduce deleted folders or references; if so, we'll need to update the automation's source (likely in mission-control-openclaw)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
projects	Ready	Preview, Comment	Apr 23, 2026 7:38am

[claude]

Claude finished @hansraj316's task —— View job

---

Pull Request Review

Comprehensive review of this major restructuring PR that extracts projects to standalone repos and converts the root to a README index.

Review Checklist:

• Analyze the current repository structure
• Review the README.md conversion
• Evaluate the project extraction approach
• Assess security implications
• Check for potential issues with removed configurations
• Provide comprehensive feedback

---

Summary

This is an excellent repository restructuring that successfully transforms a sprawling monorepo into a clean, focused index of standalone projects. The approach demonstrates thoughtful architectural decisions and proper execution.

✅ Strengths

Extraction Strategy

• Excellent use of git subtree split - Preserves commit history for substantive projects (CoachAI: 15 commits, InterviewAgent: 46 commits, ai_agent_project: 3 commits)
• Smart project categorization - Kept meaningful projects, removed exploratory stubs appropriately
• Proper scope management - Clear distinction between implementation repos and showcase repos (e.g., InterviewAgent public vs private)

README Index Design

• Well-structured project catalog - Clear categorization by type (AI Agents & Platforms)
• Informative metadata - Tech stack, status, and purpose for each project
• Maintains continuity - Preserves the "Daily TPM delivery update" format for automation
• Transparency about access - Notes that some repos are private

Security & Cleanup

• No security issues found - Only .env.example files in extracted projects, no actual credentials
• Proper secret handling - .gitignore correctly excludes .env files, includes them in security documentation
• Clean removal - Removed orphaned configs (.flake8, mypy.ini, pytest.ini, pre-commit hooks)

💡 Areas for Improvement

Documentation Inconsistencies

• SECURITY.md needs updating - Still references deleted projects like "Project Starlink" and "Azure DevOps MCP" in the supported projects table /home/runner/work/Projects/Projects/SECURITY.md:12-13
• Missing test guidance - No indication of how to run tests in the new structure

CI/CD Considerations

• Good removal of obsolete CI - Correctly removed .github/workflows/ci.yml since all tested code was extracted
• Claude workflows remain - Properly kept Claude Code automation workflows

Minor Issues

• Stray .gitignore entry - Line 62 still references Project Starlink/.env.example which no longer exists /home/runner/work/Projects/Projects/.gitignore:62

🔧 Recommendations

1. Update SECURITY.md - Remove references to extracted/deleted projects and focus on the current repo structure
2. Clean .gitignore - Remove the orphaned Project Starlink/.env.example entry
3. Consider test strategy - Document how testing works in the new distributed model
4. Monitor automation - As noted in the PR, watch for the automation's next run to ensure it adapts properly

📊 Impact Assessment

Performance: ✅ Excellent - Repository size reduced from 100 files to 18 files with 46k+ lines deleted
Maintainability: ✅ Excellent - Each project now has focused ownership and development
Security: ✅ Good - No credentials exposed, proper secret handling maintained
Test Coverage: ⚠️ Unknown - No tests remain in this repo (intentionally)

🎯 Overall Assessment

Score: 9/10 - This is a textbook example of monorepo extraction done right. The use of git subtree split to preserve history, thoughtful project categorization, and clean documentation make this an exemplary restructuring. The few minor issues are easily addressed and don't detract from the overall quality of the work.

The transformation successfully achieves the goal of creating a clean project index while preserving the value of substantial projects in their own dedicated repositories.

---