Automated project setup scripts for creating AI agent brain structures with Windows junction links to centralized documentation.
This project provides cross-platform automation for:
- Creating Atlas brain project structures
- Setting up centralized documentation in
docs-projects/ - Creating Windows junctions for convenient access
- Initializing Task-Master integration
- WordPress project pattern setup
✅ Dynamic Path Detection - No hardcoded paths, works from any location
✅ Windows Junction Creation - Uses PowerShell for reliable junction creation
✅ Cross-Platform Support - Both Bash (.sh) and PowerShell (.ps1) versions
✅ Atlas Brain Integration - Complete Software Engineer AI Agent Atlas setup
✅ Documentation Organization - Centralized docs with convenient Atlas access
✅ Task-Master Integration - Automatic task management setup
✅ WordPress Patterns - Automatic WordPress development patterns via parameter
✅ Parameter-based Setup - WordPress projects via wordpress or wp parameter
This automation system streamlines the creation of AI agent brain projects by:
- Auto-cloning required repositories from GitHub
- Creating standardized Atlas brain structures
- Setting up Windows junction links for convenient documentation access
- Integrating task management and WordPress development patterns
- Providing cross-platform compatibility (Bash + PowerShell)
# Clone this repository
git clone https://github.com/evx2/ai-project-setup-automation.git
cd ai-project-setup-automation
# Configure repository URLs in scripts/config.sh
# Then run directly
./scripts/new-project.sh my-project-name# Install to default location (~/.claude/.scripts)
./install.sh
# Or install to custom location
./install.sh /custom/path/.scripts# Regular project
./scripts/new-project.sh my-project-name
# WordPress project (automatically includes WP reference library)
./scripts/new-project.sh my-project-name wordpress
./scripts/new-project.sh my-project-name wp # Short form.\scripts\new-project.ps1 -ProjectName "my-project-name".claude/
├── atlas/
│ └── atlas-{project-name}/ # Atlas brain
│ ├── current/ # → Junction to docs-projects
│ ├── development/ # → Junction to docs-projects
│ ├── sessions/ # → Junction to docs-projects
│ ├── archive/ # → Junction to docs-projects
│ ├── CLAUDE.md # Atlas brain configuration
│ ├── CURRENT_STATE.md # Project status
│ ├── TODOS_ACTIVE.md # Active tasks
│ └── QUICK_RESUME.md # Resume instructions
└── docs-projects/
└── docs-theme-{project-name}/ # Real documentation storage
├── current/ # Current project docs
├── development/ # Development notes
├── sessions/ # Session logs
├── archive/ # Archived materials
├── historical/ # Historical versions
├── backups/ # Backup files
├── specifications/ # Project specs
└── research/ # Research materials
The scripts create Windows junctions that provide:
- Convenient Access: Access docs from Atlas brain location
- Centralized Storage: Real files stored in
docs-projects/ - Cross-Reference: Multiple projects can reference shared docs
- Organization: Clean separation between brain and documentation
- Bash Version: WSL, Linux, or Git Bash
- PowerShell Version: Windows PowerShell 5.0+
- Optional: Node.js + npm (for Task-Master)
- Optional: WordPress patterns repository
scripts/new-project.sh- Bash version with dynamic path detectionscripts/new-project.ps1- PowerShell version with native junction creation
docs/AUTOMATED_SETUP_GUIDE.md- Complete setup documentationdocs/TODAY_SUMMARY.md- Development progress summary
templates/- Template files for project initialization
- Problem:
mklinkcommand syntax issues - Solution: Switched to PowerShell
New-Item -ItemType Junction - Result: 100% reliable junction creation
- Problem: Hardcoded paths in bash script
- Solution: Script-relative path calculation
- Result: Works from any directory structure
./scripts/new-project.sh my-website# Automatically includes WordPress reference patterns
./scripts/new-project.sh wp-project wordpress
./scripts/new-project.sh wp-project wp # Short form# Use the path shown in QUICK_RESUME.md
./.claude/.scripts/session.sh my-project resume- Works with existing Atlas brain repositories
- Compatible with Task-Master AI task management
- Supports WordPress AI Commander patterns
- Integrates with Claude Code documentation system
The scripts have been tested with:
- ✅ Junction creation and functionality
- ✅ Dynamic path detection
- ✅ Cross-platform compatibility
- ✅ Atlas brain template copying
- ✅ Documentation structure creation
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly on your Windows system
- Submit a pull request
When adding features:
- Test both bash and PowerShell versions
- Ensure dynamic path detection works
- Verify junction creation on Windows
- Update documentation
- Test with different project names
Created for the Windows power user community by developers who understand the need for efficient project automation.
GPLv3
⭐ If this utility saved you time, please star the repository!
If this tool has made your Windows experience smoother, consider supporting its continued development!
Buy me a coffee!
Why donate?
- ☕ Fuel more utility development
- 🚀 Support new Windows tools and improvements
- 🐛 Faster bug fixes and updates
- 📚 Better documentation and tutorials
Even small contributions make a big difference! Every coffee helps keep this project actively maintained and growing.
Made with ❤️ for the Windows power user community