MIGRATION.md

Replacing the current repository

1. Back up or commit the current repository.

2. Extract this archive into a temporary directory.

3. Copy all extracted files—including .claude-plugin/ and .github/—to the repository root.

4. Remove the old nested engineering-baseline/ directory only after confirming its content is represented under the new root skills/ and scripts/ structure.

5. Review the three commit pins in registry.json.

6. Run:

   python3 scripts/validate.py
   python3 tests/test_installer.py
   python3 tests/test_existing_adoption.py
   python3 tests/test_production_validator.py

7. Test installation in a disposable project before publishing:

   temp_project="$(mktemp -d)"
   bash scripts/install.sh --project "$temp_project" --host both --profile full
   python3 scripts/validate.py --project "$temp_project"

8. Commit and push the reviewed result. Create a release tag when changing the marketplace plugin version.

Do not copy .engineering-baseline-lock.json from a target project back into this repository.