Skip to content

Epic: Finder Integration for Project Lifecycle #6

@BugRoger

Description

@BugRoger

Summary

Add Finder/file system integration to mirror PARA structure for non-markdown project assets. Extends the project lifecycle skills (#2) with file system synchronization.

Stub created: _sub/project-sync-finder/SKILL.md documents the planned interface.


Folder Structure

~/Projects/  (configurable base path)
├── 2026-03-31-quarterly-planning/
│   ├── Assets/
│   └── Documents/
└── _Archive/
    └── 2025-12-31-completed-project/

Configuration

Will read from .claude/config.md:

finder_projects_path: ~/Projects

Integration Points

On /create-project:

  1. Create folder at ~/Projects/{due_date}-{slug}/
  2. Create subfolders (Assets, Documents)
  3. Optionally open folder in Finder

On /archive-project:

  1. Move folder to ~/Projects/_Archive/
  2. Handle missing folders gracefully

Implementation

The project-sync-finder sub-skill stub is already in place. Implementation needs:

  1. Path expansion (~ to full path)
  2. mkdir -p for folder creation
  3. mv for archival
  4. Idempotent operations (handle existing folders)
  5. Error handling for permission issues

Acceptance Criteria

  • Folder created at configured path on project create
  • Subfolders (Assets, Documents) created
  • Folder moved to _Archive/ on project archive
  • Integration gracefully skipped if not configured
  • Works on macOS (primary target)

Metadata

Metadata

Assignees

No one assigned

    Labels

    scope:integrationExternal tool integrationtype:epicLarge initiative spanning multiple stories

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions