harness-tools/docs/workflow/archive-workflows-record.md

Archive legacy workflows

Status

• Status: active
• Current phase: implementation
• Next safe action: execute the approved archival plan.

Request and scope

Archive both extensions/workflow and extensions/_workflows under __archived/extensions/. Preserve source and tests as historical reference, not supported runnable packages. Keep develop-workflow, historical documentation, live Pi configuration, existing worktrees, and skill validation evidence intact.

Git identity

• Source branch: main
• Base commit: fee0d44e2d
• Feature branch: feature/archive-workflows
• Worktree: /srv/data/code/jb-pi/harness-tools/.worktrees/archive-workflows
• Omitted source changes: none; source was clean.

Acceptance criteria

• Both implementations and their tests are retained in the archive.
• Active workspace inventory, lockfile, and root test commands no longer reference them.
• Current docs explain the archive and explicit pilot-prerequisite override; skill validation remains open.
• Active checks pass or failures are reported with evidence; independent reviewers approve the pinned diff.

Approved implementation plan and gates

1. Move tracked files for both implementations to __archived/extensions/, preserving historical code unchanged. Add an archive README explaining historical relative imports and how to recover runnable sources from Git. Fix the moved workflow README's repository documentation links.
2. Remove the obsolete workspace exclusion and legacy test globs from package.json; update workspace inventory assertions and only legacy workspace entries in bun.lock. No third-party version or dependency changes. The existing TypeScript include already excludes archives.
3. Update root README, retirement TODO, and ADR 0006 with an explicit pointer to a small retirement ADR. Keep separate scenario/pilot validation TODO open. Preserve historical plans and ADR content rather than mass-rewriting old paths.
4. Verify focused package/link tests, root typecheck, and full bun run test. There are no root lint/build scripts. Check archived file preservation and absence of active imports. No UI change, installation, publishing, host configuration, or production access.
5. Commit verified work; fetch/rebase main, reverify any changed tree, obtain separate standards and specification reviews of the exact binary diff, fast-forward local main, commit closure metadata, and safely remove only this worktree/branch. Rollback is a focused revert of the archival product commit.

• Scope approval: user selected Archive both.
• Retirement gate: user selected Archive now, explicitly overriding the deferred three-pilot prerequisite. This does not claim pilot success.
• Plan approval: user selected Approve after Orca presented the complete plan.

Ownership

Parent agent owns all mutations listed above, including this record and new archival README/ADR. No subagent owns files. Mutating implementation deadline: 15 minutes; stop and checkpoint if exceeded. Reviewers are read-only and distinct from the parent.

Verification matrix

Pending: bun run test:packages, bun run test:links, bun run typecheck, bun run test, git diff --check, archive byte-preservation check.

Review

Pending. Pin base, product HEAD, tree, commit list, exact git diff --binary --full-index --find-renames <base>...<head> -- SHA-256, reviewer identities and verdicts before integration.

Integration and rollback

Pending local fast-forward after review; rollback via focused revert.

Checkpoints and blockers

None. Initial helper invocation rejected noncanonical section names before creating a record; corrected headings and retried successfully. No tool defect observed.