star-proj-adopt

Non-destructive project onboarding into the STAR framework maps your existing source code and data directories using symlinks. This approach integrates your current repository without requiring destructive changes, file moves, or renames.

Historical reconciliation into the STAR plan tree reconstructs work history from existing git commits and output directories. This controlled backfill populates the research plan tree with evidence-based work inventory without altering your original files.

Adopting an in-progress repository into STAR requires a read-only survey phase followed by controlled backfilling. This maps current file structures and runtime environments, allowing you to start using STAR workflows seamlessly without breaking your current setup.

STAR project adoption does not modify your current runtime environments or source code. It operates through a read-only survey of your repository and uses symlink-based directory management to map existing assets into the STAR structure.

Symlink-based directory management during STAR onboarding satisfies the requirement for non-destructive integration. By mapping existing file structures instead of copying, it preserves your current setup while enabling evidence-based work inventory reconstruction.

Use the STAR project adoption workflow when you have a partially completed AI research project with existing git history and outputs. It is designed specifically to backfill historical experiment data into the plan tree without disrupting ongoing work.