test-repo/PROJECT_SETUP.md
Matt Bruce 9cfd7843b8 docs: memory and task CRUD scripts
- Add gantt task CRUD bash and TypeScript utilities
- Update MEMORY.md with CRUD capabilities and rules
- Update daily memory with subagent completions
- Document: full task links, attach-then-delete rule
2026-02-21 16:32:24 -06:00

1.8 KiB

PROJECT_SETUP.md - Project Location Rules

Golden Rule

ALL projects MUST be created in /Users/mattbruce/Documents/Projects/OpenClaw/

Never create projects in:

  • /Users/mattbruce/ (root home directory)
  • /Users/mattbruce/.openclaw/workspace/ (agent workspace)
  • Any other random location

Folder Structure

/Users/mattbruce/Documents/Projects/OpenClaw/
├── Documents/          # Documentation, specs, plans
├── iOS/               # iOS apps (Swift/Xcode)
└── Web/               # Web apps (Next.js/React)
    ├── blog-backup/
    ├── gantt-board/
    ├── heartbeat-monitor/
    ├── mission-control/
    └── [NEW_PROJECT]/   # Always put new web projects here

Project Types

Type Location Example
iOS Apps OpenClaw/iOS/[project]/ OpenClaw/iOS/MyApp/
Web Apps OpenClaw/Web/[project]/ OpenClaw/Web/dashboard/
Documents OpenClaw/Documents/ OpenClaw/Documents/plans/

Before Creating Any Project

  1. Check TOOLS.md for existing projects (avoid duplicates)
  2. Choose correct folder based on project type
  3. Verify location before running npx create-next-app or similar
  4. Update TOOLS.md with new project details immediately

If You Mess Up

If a project is created in the wrong place:

# Move it to correct location
mv ~/wrong-location/project ~/Documents/Projects/OpenClaw/Web/

# Update any hardcoded paths
# Update TOOLS.md

Examples

Correct:

cd /Users/mattbruce/Documents/Projects/OpenClaw/Web
npx create-next-app new-dashboard

Incorrect:

cd /Users/mattbruce          # WRONG!
npx create-next-app new-dashboard

Remember: The OpenClaw folder is the single source of truth for all projects.