NAS Organization Plan: .agent and tmp Directories

Date: 2026-01-26 Status: Ready for Execution Purpose: Organize local .agent and tmp directories into proper NAS structure

---

Current State

Local Directories to Organize

Detailed Inventory

.agent/ Contents:

• rules/ (19 .mdc files): agent-policies, code-standards, critical-prohibitions, git-workflow, separation-of-duties, cursor-integration, mcp-integration, claude-code-patterns, antigravity rules
• workflows/ (2 .md files): agentflow.md, antigravity-audit.md

tmp/ Contents:

• Migration History (6 files): MIGRATION_STATUS, MIGRATION_COMPLETE, NAS_MIGRATION_PLAN, DEPLOYMENT_INSTRUCTIONS, CLEANUP-COMPLETE, synology-claude-code-setup
• Project Documentation (6 files): 01-GITLAB-COMPONENTS, 03-PLATFORM-AGENTS, 04-AGENT-DOCKER, 05-DRUPAL-INTEGRATION, 06-AGENT-BUILDKIT, CONSOLIDATED-ACTION-ITEMS
• Patches (1 file): ai_agents-ossa-0.2.3-compliance.patch

---

Proposed NAS Structure

/Volumes/AgentPlatform/
├── config/
│   └── cursor-rules/                    # NEW: Canonical Cursor IDE rules
│       ├── rules/                       # From .agent/rules/ (19 .mdc files)
│       └── workflows/                   # From .agent/workflows/ (2 .md files)
│
├── archive/
│   └── migration-2026-01/               # NEW: Migration history archive
│       ├── CLEANUP-COMPLETE-20260125.md
│       ├── DEPLOYMENT_INSTRUCTIONS.md
│       ├── MIGRATION_COMPLETE_2026-01-25.md
│       ├── MIGRATION_STATUS_2026-01-25.md
│       ├── NAS_MIGRATION_PLAN.md
│       ├── synology-claude-code-setup.md
│       └── patches/
│           └── ai_agents-ossa-0.2.3-compliance.patch
│
└── docs/
    └── project-notes/                   # NEW: Temporary project documentation
        ├── 01-GITLAB-COMPONENTS.md
        ├── 03-PLATFORM-AGENTS.md
        ├── 04-AGENT-DOCKER.md
        ├── 05-DRUPAL-INTEGRATION.md
        ├── 06-AGENT-BUILDKIT.md
        └── CONSOLIDATED-ACTION-ITEMS.md

---

Migration Commands

Phase 1: Create Directory Structure

# Create new directories on NAS
mkdir -p /Volumes/AgentPlatform/config/cursor-rules/{rules,workflows}
mkdir -p /Volumes/AgentPlatform/archive/migration-2026-01/patches
mkdir -p /Volumes/AgentPlatform/docs/project-notes

Phase 2: Move .agent Directory

# Move Cursor rules (19 .mdc files)
rsync -av --progress \
  ~/Sites/blueflyio/.agent/rules/ \
  /Volumes/AgentPlatform/config/cursor-rules/rules/

# Move workflows (2 .md files)
rsync -av --progress \
  ~/Sites/blueflyio/.agent/workflows/ \
  /Volumes/AgentPlatform/config/cursor-rules/workflows/

# Verify
ls -lR /Volumes/AgentPlatform/config/cursor-rules/

Phase 3: Move tmp Directory

# Move migration history
rsync -av --progress \
  ~/Sites/blueflyio/tmp/CLEANUP-COMPLETE-20260125.md \
  ~/Sites/blueflyio/tmp/DEPLOYMENT_INSTRUCTIONS.md \
  ~/Sites/blueflyio/tmp/MIGRATION_COMPLETE_2026-01-25.md \
  ~/Sites/blueflyio/tmp/MIGRATION_STATUS_2026-01-25.md \
  ~/Sites/blueflyio/tmp/NAS_MIGRATION_PLAN.md \
  ~/Sites/blueflyio/tmp/synology-claude-code-setup.md \
  /Volumes/AgentPlatform/archive/migration-2026-01/

# Move patches
rsync -av --progress \
  ~/Sites/blueflyio/tmp/ai_agents-ossa-0.2.3-compliance.patch \
  /Volumes/AgentPlatform/archive/migration-2026-01/patches/

# Move project documentation
rsync -av --progress \
  ~/Sites/blueflyio/tmp/01-GITLAB-COMPONENTS.md \
  ~/Sites/blueflyio/tmp/03-PLATFORM-AGENTS.md \
  ~/Sites/blueflyio/tmp/04-AGENT-DOCKER.md \
  ~/Sites/blueflyio/tmp/05-DRUPAL-INTEGRATION.md \
  ~/Sites/blueflyio/tmp/06-AGENT-BUILDKIT.md \
  ~/Sites/blueflyio/tmp/CONSOLIDATED-ACTION-ITEMS.md \
  /Volumes/AgentPlatform/docs/project-notes/

# Verify
ls -lR /Volumes/AgentPlatform/archive/migration-2026-01/
ls -l /Volumes/AgentPlatform/docs/project-notes/

Phase 4: Cleanup (AFTER Verification)

# Remove local directories ONLY after verifying NAS copies
# DO NOT run these until you've verified all files copied correctly!

# Verify first
echo "Files on NAS:"
find /Volumes/AgentPlatform/config/cursor-rules -type f | wc -l
find /Volumes/AgentPlatform/archive/migration-2026-01 -type f | wc -l
find /Volumes/AgentPlatform/docs/project-notes -type f | wc -l

# Expected: 21 files in cursor-rules, 7 files in archive, 6 files in project-notes

# Then remove local directories
rm -rf ~/Sites/blueflyio/.agent
rm -rf ~/Sites/blueflyio/tmp

# Or move to _DeleteLater for safety
mkdir -p ~/Sites/blueflyio/_DeleteLater/2026-01-26
mv ~/Sites/blueflyio/.agent ~/Sites/blueflyio/_DeleteLater/2026-01-26/
mv ~/Sites/blueflyio/tmp ~/Sites/blueflyio/_DeleteLater/2026-01-26/

---

Directory Purpose & Access Patterns

/Volumes/AgentPlatform/config/cursor-rules/

Purpose: Canonical Cursor IDE rules for AI assistants

Access Pattern:

• Read: AI assistants (Claude Code, Cursor) reference these rules
• Write: Update when authoritative wiki documentation changes
• Sync: One-way from wikis/technical-docs.wiki/00-for-ai-assistants/ to here

Maintenance:

• These are DERIVATIVES of authoritative wiki documentation
• Primary source: wikis/technical-docs.wiki/00-for-ai-assistants/
• Update these when wiki changes
• Consider: May be redundant with wiki (evaluate after migration)

/Volumes/AgentPlatform/archive/migration-2026-01/

Purpose: Historical migration documentation

Access Pattern:

• Read: Reference only (historical context)
• Write: Never (frozen archive)
• Retention: Permanent (migration history)

Contents:

• Migration status reports
• Deployment instructions (historical)
• Cleanup logs
• NAS migration planning documents
• Synology setup documentation
• Patches applied during migration

/Volumes/AgentPlatform/docs/project-notes/

Purpose: Temporary project documentation awaiting wiki integration

Access Pattern:

• Read: Reference during development
• Write: Add notes, update as needed
• Migrate: These should eventually move to wikis

Contents:

• Project-specific documentation (GitLab, Platform Agents, Agent Docker, Drupal, BuildKit)
• Consolidated action items (should merge into wikis)

Action Items:

• Review each project note file
• Determine if content belongs in wikis
• Migrate valuable content to appropriate wiki pages
• Delete redundant/outdated content

---

Post-Migration Actions

1. Update References

Files that may reference .agent/:

• .cursorrules - May have paths to local .agent directory
• CLAUDE.md - May reference local .agent rules
• Any scripts or configs pointing to ~/Sites/blueflyio/.agent/

Search and update:

# Find references to .agent directory
grep -r "Sites/blueflyio/.agent" /Volumes/AgentPlatform/wikis/blueflyio/ 2>/dev/null
grep -r "\.agent/" ~/Sites/blueflyio/ 2>/dev/null | grep -v node_modules | grep -v .git

# Find references to tmp directory
grep -r "Sites/blueflyio/tmp" /Volumes/AgentPlatform/wikis/blueflyio/ 2>/dev/null

2. Validate Cursor Rules Redundancy

Question: Are /config/cursor-rules/ needed if wikis are authoritative?

Options:

1. Keep: Use as compiled/processed rules for AI assistants
2. Remove: Eliminate redundancy, reference wikis directly
3. Symlink: Create symlink to wiki location

Recommendation: Keep initially, evaluate redundancy after 30 days

3. Integrate Project Notes into Wikis

Target Wikis:

• 01-GITLAB-COMPONENTS.md → wikis/technical-docs.wiki/architecture/gitlab-components.md
• 03-PLATFORM-AGENTS.md → wikis/technical-docs.wiki/action-items/02-agents/README.md
• 04-AGENT-DOCKER.md → wikis/technical-docs.wiki/architecture/agent-docker.md
• 05-DRUPAL-INTEGRATION.md → wikis/technical-docs.wiki/developer-guides/drupal/README.md
• 06-AGENT-BUILDKIT.md → wikis/technical-docs.wiki/action-items/06-execution/BUILDKIT.md
• CONSOLIDATED-ACTION-ITEMS.md → wikis/technical-docs.wiki/action-items/README.md

Process:

1. Read current wiki page
2. Identify valuable content in project note
3. Merge content into wiki (update, don't duplicate)
4. Mark project note as "MIGRATED TO WIKI - DELETE"
5. After 30 days, delete project notes

---

Validation Checklist

After migration, verify:

• All 19 .mdc files in /Volumes/AgentPlatform/config/cursor-rules/rules/
• All 2 .md files in /Volumes/AgentPlatform/config/cursor-rules/workflows/
• All 6 migration docs in /Volumes/AgentPlatform/archive/migration-2026-01/
• Patch file in /Volumes/AgentPlatform/archive/migration-2026-01/patches/
• All 6 project notes in /Volumes/AgentPlatform/docs/project-notes/
• Total file count: 34 files (21 + 7 + 6)
• No files left in ~/Sites/blueflyio/.agent/
• No files left in ~/Sites/blueflyio/tmp/
• Updated references in config files
• AI assistants can access rules on NAS

---

Timeline

Total: ~3-4 hours (including wiki integration)

---

Related Documentation

• Separation of Duties - Code ownership boundaries
• 00-for-ai-assistants/ - Authoritative AI assistant rules
• action-items/README.md - Master action items index

---

Last Updated: 2026-01-26 Status: Ready for user approval and execution