Work-Item Artifact Directories

Organizing project documentation into per-item directories is handled by automatically creating structured folders under .sweetclaude/work/ for every story, epic, or milestone to co-locate related artifacts. This centralizes design docs, plans, and contracts into a predictable structure.

Backfilling legacy files into the new artifact structure is supported by a scanner that identifies existing project files and links them using symlinks. This connects your current documentation to the newly created per-item directories without duplicating data.

Verifying link integrity for project artifacts is performed through a health check that identifies broken symlinks or missing artifact directories. This status monitoring ensures your documentation structure remains intact across stories, epics, and milestones.

Python 3 is required to execute the backfill scanner and directory management scripts for work-item artifact directories. The scripts rely on Python to automate the organization and linking of project files within the .sweetclaude/work/ path.

Symlink management works by scanning existing project files and creating symbolic links that point legacy artifacts into the centralized directory structure. This allows backfilling without moving original files, maintaining both the new structure and existing file paths.

Project artifacts that should be co-located for epics and stories include design docs, plans, contracts, and decision logs. Co-locating these items in a single directory ensures all documentation related to a specific work item is predictable and accessible.