Implementation Notes: Pre-existing Skills Scaffold Policy

Summary

Delivered agent-owned pre-existing skill reconciliation guidance across dp scaffold init, dp scaffold setup, dp update, $dp-cli, and operator docs. Commands provide clear handoff guidance and blind evidence snapshots, but do not detect, classify, report, archive, or decide skill overlap.

Source Push Sync

• Verified upstream shared skill source in /Users/stefan/Desktop/repos/wearedevpunks-skills.
• Synced upstream commit: a889421 docs: mention skill snapshot evidence.
• Ran bun run sync:skills in Harness to refresh apps/cli/skills/agnostic/cli/dp-cli.
• Refreshed the active global $dp-cli install with skills add https://github.com/wearedevpunks/skills/tree/main/skills/agnostic/cli/dp-cli --skill dp-cli --global --yes.

Changed Surfaces

• Init prompt: apps/cli/src/content/stage-scaffold.ts
• Setup handoff: apps/cli/src/content/scaffold-copy.ts
• Update summary: apps/cli/src/update/run.ts
• Blind skill snapshot helper: apps/cli/src/scaffold/skill-snapshot.ts
• Tests: apps/cli/src/content/content.test.ts, apps/cli/src/scaffold/run.test.ts, apps/cli/src/scaffold/stage.test.ts, apps/cli/src/update/run.test.ts
• Shared skill: apps/cli/skills/agnostic/cli/dp-cli/**
• Docs/runbooks: docs/README.md, docs/runbooks/dp-cli-scaffolding.md, docs/reference/dp-requirements.md, routed wiki mirrors under apps/wiki/content/docs

Validation

• PASS: bun run --cwd apps/cli test -- src/scaffold/run.test.ts src/scaffold/stage.test.ts src/update/run.test.ts src/content/content.test.ts
• PASS: bun run --cwd apps/cli check-types
• PASS: bun run --cwd apps/cli check
• PASS: git diff --check
• PASS: diff -u shared source, Harness apps/cli/skills, and global $dp-cli files.

Notes

• Historical grill/spec artifacts mention superseded command-owned behavior as explicit context; current status/log and implementation notes record the accepted agent-owned policy.
• Several docs files were already dirty before implementation; edits stayed scoped to the accepted skill-policy paragraphs and related metadata.