Plan: Finder Phase Wayfinder Skill Workflow

Generated: 2026-07-03

Initial Situation

Closed grill artifacts define the finder-phase and wayfinder backlog-native model. No matching implementation existed before this run. The source skill repository is clean and must be edited first:

/Users/stefan/Desktop/repos/wearedevpunks-skills

Harness mirrors and catalog wiring then live in:

/Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills
/Users/stefan/Desktop/repos/harness-intelligence/.agents/skills
/Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog

Known existing Harness wiki/grill edits are intentional and unrelated to implementation correctness.

Problem Statement

Generated and local Harness agents need a route before requirements/delivery for loose, oversized, foggy work. The route must express uncertainty as first-class backlog items, use a lean wayfinder primitive for route selection, and delegate provider materialization to write-backlog.

Solution Shape

Implement this as shared skill content plus Harness distribution wiring:

Add a lean wayfinder primitive under shared planning skills.
Add a model-invoked finder-phase phase wrapper under shared phase skills.
Reshape write-backlog references so they own kind taxonomy and provider materialization for fog, grilling, research, prototype, epic, and story.
Wire finder-phase and wayfinder into the planning pack and catalog.
Update root/generated routing docs so foggy oversized work goes to finder-phase before requirements-phase.

Resolved Decision Ledger

finder-phase is the Harness workflow entrypoint.
wayfinder remains lean and owns route selection.
write-backlog owns backlog taxonomy and provider payload materialization.
Backlog root is the living map; wiki artifacts are evidence.
No separate map item.
fog is root-level only and not delivery-eligible.
Concrete non-fog items live under a module/milestone.
Stories remain children of epics.
grilling, research, and prototype close into accepted decisions before implementation epic/story updates.
No legacy epic/story migration in v1.
No provider backlog writes in this delivery.

Assumptions And Constraints

writing-great-skills governs all skill text.
finder-phase/SKILL.md must stay lean and use progressive-disclosure references.
Provider docs from the grill are sufficient for this implementation; no live provider mutation is needed.
bun run sync:skills fetches the public shared skills repo, so local shared-skill edits must be committed and pushed before sync can prove the mirror.
Baseline publish is out of scope unless explicitly requested after implementation.
The user's in-progress finder-phase theory page under apps/wiki/content/docs/project/public-docs/finder-phase/ must not be overwritten.

Codebase Findings

Current write-backlog source only documents module -> epic -> story.
Existing provider assets only encode epic/story-oriented payloads.
Planning pack wiring is in apps/cli/src/data/catalog/packs.ts.
Skill catalog wiring is in apps/cli/src/data/catalog/skills.ts.
Focused catalog/content coverage is in apps/cli/src/content/content.test.ts.
Root generated prompt criteria are in apps/cli/src/content/scaffold-copy.ts.
Current repo root routing is in /Users/stefan/Desktop/repos/harness-intelligence/AGENTS.md.
docs/README.md still says write-backlog formats EPIC plus child stories only.

External Research Used

No new external research during planning. The closed grill already captured official provider sources for Linear, GitHub Projects V2, monday.com, and Azure DevOps.

Mode Choice

parallel: false

Sequential implementation is required because shared skill source changes, sync, catalog wiring, root guidance, and validation are tightly coupled. Use exactly one implementation worker for source and Harness edits, then parent validation. Worker guard has a dedicated preflight task before source edits.

Dependency Graph

T0 -> T1 -> T2 -> T3 -> T4 -> T5 -> T6

Tasks

T0: Verify Sequential Worker Guard

depends_on: []
location: /Users/stefan/Desktop/repos/harness-intelligence/.agents/subagents/manifest.mjs, /Users/stefan/Desktop/repos/harness-intelligence/.devpunks/settings.json
description: Verify subagent execution is available, the manifest exists, and the selected implementation worker can own the cross-repo implementation with parent-expanded scope.
validation: Parent confirms .agents/subagents/manifest.mjs exists and includes apps-cli; parent uses exactly one implementation worker for source edits.
status: Complete
log: .agents/subagents/manifest.mjs exists and includes an apps-cli specialist for CLI surfaces; implementation worker will receive parent-expanded cross-repo scope for shared skill source plus Harness sync/docs.
files edited/created:
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [delivery-phase, implement-spec]
tdd_status: not_applicable
tdd_target: Worker routing preflight.
red_command:
expected_red_failure:
green_command: test -f .agents/subagents/manifest.mjs && rg -n "\"name\": \"apps-cli\"" .agents/subagents/manifest.mjs
reason_not_testable: Guard is validated by manifest inspection and actual worker spawn.
red_evidence:
green_evidence: .agents/subagents/manifest.mjs present; rg found apps-cli.
codebase_design_notes: Parent remains orchestrator; one worker owns implementation edits.
review_mode: cli

T1: Add Source `wayfinder` And `finder-phase`

depends_on: [T0]
location: /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/planning/wayfinder, /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/phases/finder-phase
description: Create lean wayfinder and model-invoked finder-phase skills. Keep wayfinder route-selection focused. Keep finder-phase/SKILL.md lean with references such as frontier-lifecycle.md and root-routing.md.
validation: Read skill bodies and verify trigger, core loop, route selection, completion criteria, and reference pointers match the spec.
status: Complete
log: Added lean source wayfinder and model-invoked source finder-phase with progressive-disclosure frontier-lifecycle.md and root-routing.md references. finder-phase delegates provider materialization to write-backlog.
files edited/created:
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/planning/wayfinder/SKILL.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/phases/finder-phase/SKILL.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/phases/finder-phase/references/frontier-lifecycle.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/phases/finder-phase/references/root-routing.md
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [writing-great-skills, codebase-design]
tdd_status: not_applicable
tdd_target: Skill content artifact shape, validated by direct source inspection and later catalog tests.
red_command:
expected_red_failure:
green_command: git -C /Users/stefan/Desktop/repos/wearedevpunks-skills diff --check
reason_not_testable: Markdown skill authoring has no runtime behavior before distribution wiring.
red_evidence:
green_evidence: git -C /Users/stefan/Desktop/repos/wearedevpunks-skills diff --check passed. Direct source inspection verified trigger, core loop, route selection, completion criteria, and reference pointers.
codebase_design_notes: Keep route selection, phase orchestration, and provider materialization in separate skill seams.
review_mode: cli

T2: Reshape Source `write-backlog`

depends_on: [T1]
location: /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog
description: Update write-backlog to own backlog kind taxonomy and provider materialization for fog, grilling, research, prototype, epic, and story; preserve strict epic/story delivery semantics and provider-specific kind storage.
validation: Source docs state first-class item invariant, root-level fog, module/milestone placement, accepted-decision closure, and provider kind storage for Linear, GitHub Projects V2, monday.com, and Azure DevOps; each provider asset names its concrete kind storage rule.
status: Complete
log: Expanded source write-backlog from epic/story-only shaping to canonical backlog kind materialization for fog, grilling, research, prototype, epic, and story. Preserved epic/story delivery semantics and added provider-native kind storage rules for Linear, GitHub Projects V2, monday.com, and Azure DevOps.
files edited/created:
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/SKILL.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/REFERENCE.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/EXAMPLES.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/concepts/backlog-model.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/concepts/story-shape.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/azure-devops-create-payload.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/github-projects-create-payload.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/linear-create-payload.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/monday-create-payload.md
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [writing-great-skills, write-backlog, codebase-design]
tdd_status: not_applicable
tdd_target: Documentation contract for backlog materialization, validated by source inspection and downstream mirror checks.
red_command:
expected_red_failure:
green_command: rg -n "fog|grilling|research|prototype|Kind|first-class|visible, assignable, searchable, linkable, and closeable" /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog && rg -n "Kind/fog|Kind/grilling|Kind/research|Kind/prototype|Kind/epic|Kind/story" /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/linear-create-payload.md && rg -n "Project custom single-select field named Kind|fog|grilling|research|prototype|epic|story" /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/github-projects-create-payload.md && rg -n "Status or Dropdown column named Kind|fog|grilling|research|prototype|epic|story" /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/monday-create-payload.md && rg -n "Custom.DevpunksKind|fog|grilling|research|prototype|epic|story" /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/assets/providers/azure-devops-create-payload.md
reason_not_testable: Skill reference docs have no runtime behavior until consumed by agents.
red_evidence:
green_evidence: Planned rg assertions passed for taxonomy, first-class item invariant, Linear Kind/... labels, GitHub Project Kind field, monday.com Kind Status/Dropdown column, and Azure Custom.DevpunksKind; git -C /Users/stefan/Desktop/repos/wearedevpunks-skills diff --check passed.
codebase_design_notes: write-backlog is the provider-materialization adapter; finder-phase must link here instead of copying payload rules.
review_mode: cli

T3: Add Catalog RED And Generated Routing Expectations

depends_on: [T2]
location: /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/skills.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/packs.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/content.test.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/scaffold-copy.ts
description: Extend focused content tests so they expect finder-phase and wayfinder in the planning pack and expect generated root-routing criteria to route foggy oversized work to finder-phase before requirements-phase.
validation: Focused content tests fail before catalog wiring and sync because the new skills are not yet registered and mirrored.
status: Complete
log: Added focused RED expectations in content.test.ts for planning pack membership and root prompt routing. Test failed before catalog/prompt wiring as expected.
files edited/created:
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/content.test.ts
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [tdd, codebase-design, quality-types, turborepo]
tdd_status: required
tdd_target: skillsForPack("planning") includes finder-phase and wayfinder, registered source directories exist, and root prompt criteria mention finder-phase before requirements-phase.
red_command: bun run --cwd apps/cli test src/content/content.test.ts
expected_red_failure: Planning pack and/or root prompt expectations fail because finder-phase and wayfinder are not registered yet.
green_command: Deferred to T4 after source sync makes catalog source directories exist.
reason_not_testable:
red_evidence: bun run --cwd apps/cli test src/content/content.test.ts failed with 2 expected failures: skillsForPack("planning") missing finder-phase and wayfinder, and rendered root prompt spec missing finder-phase before requirements-phase.
green_evidence: Deferred to T4 after source sync; T4 GREEN evidence records the focused content test passing.
codebase_design_notes: Catalog is the public distribution seam; tests should prove behavior through skillsForPack, source-directory existence, and rendered prompt text rather than implementation details.
review_mode: cli

T4: Wire Catalog, Commit/Push Source, And Sync Harness Mirrors

depends_on: [T3]
location: /Users/stefan/Desktop/repos/wearedevpunks-skills, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/skills.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/packs.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/scaffold-copy.ts, /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills, /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills
description: Add catalog entries and planning-pack entries, add generated root-routing prompt guidance, commit and push shared-skill source, run Harness bun run sync:skills, then align affected active .agents/skills mirrors from the synced CLI bundle.
validation: Sync metadata records the pushed shared-skills commit; affected CLI and .agents skill mirrors compare cleanly against source; focused content tests pass.
status: Complete
log: Wired finder-phase and wayfinder into the CLI skill catalog and planning pack, updated generated root prompt routing, committed and pushed shared skills at 2ce74433d3e8664c784bb5dc30c9b31ca2ffb0be, ran bun run sync:skills, and aligned affected active .agents/skills mirrors.
files edited/created:
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/skills.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/packs.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/scaffold-copy.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/prompts.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/content.test.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/phases/finder-phase/**
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/agnostic/planning/wayfinder/**
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/agnostic/requirements/write-backlog/**
- /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/finder-phase/**
- /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/wayfinder/**
- /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/write-backlog/**
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [writing-great-skills]
tdd_status: not_applicable
tdd_target: Distribution and mirror state, not runtime behavior.
red_command:
expected_red_failure:
green_command: bun run sync:skills && bun run --cwd apps/cli test src/content/content.test.ts && node -e "const fs=require('fs'); const s=JSON.parse(fs.readFileSync('apps/cli/.devpunks-cache/skills-sync.json','utf8')); if(!s.commit) process.exit(1); console.log(s.commit)" && diff -qr /Users/stefan/Desktop/repos/wearedevpunks-skills/skills /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills && diff -qr /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/phases/finder-phase /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/finder-phase && diff -qr /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/agnostic/planning/wayfinder /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/wayfinder && diff -qr /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/agnostic/requirements/write-backlog /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/write-backlog
reason_not_testable: Sync is validated through command output, metadata, and file comparison rather than RED/GREEN behavior.
red_evidence:
green_evidence: bun run sync:skills passed and fetched 2ce74433d3e8664c784bb5dc30c9b31ca2ffb0be; bun run --cwd apps/cli test src/content/content.test.ts passed 19 tests; sync metadata printed 2ce74433d3e8664c784bb5dc30c9b31ca2ffb0be; full source vs apps/cli/skills diff -qr passed after removing two empty untracked local source dirs; active mirror diffs for finder-phase, wayfinder, and write-backlog passed.
codebase_design_notes: Shared repo remains source; Harness mirrors remain distribution copies.
review_mode: cli

T5: Align Current Repo Guidance And Durable Docs

depends_on: [T4]
location: /Users/stefan/Desktop/repos/harness-intelligence/AGENTS.md, /Users/stefan/Desktop/repos/harness-intelligence/docs/README.md, /Users/stefan/Desktop/repos/harness-intelligence/docs/runbooks/dp-cli-scaffolding.md, /Users/stefan/Desktop/repos/harness-intelligence/apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/IMPLEMENTATION-NOTES.md
description: Update current root workflow routing, root docs summary, and scaffold runbook to mention finder-phase, expanded backlog kinds, and source/sync evidence. Do not edit the user's concurrent finder-phase theory page unless docs-ingest later finds a direct mismatch.
validation: Root guidance routes foggy oversized work to finder-phase before requirements-phase; docs README and scaffolding runbook no longer describe write-backlog as only EPIC plus child stories; implementation notes capture proof.
status: Complete
log: Updated current root routing and durable CLI scaffolding docs to include finder-phase before bounded requirements-phase, expanded backlog kinds, and provider-native Kind storage. Did not edit the concurrent public-docs finder-phase theory page.
files edited/created:
- /Users/stefan/Desktop/repos/harness-intelligence/AGENTS.md
- /Users/stefan/Desktop/repos/harness-intelligence/docs/README.md
- /Users/stefan/Desktop/repos/harness-intelligence/docs/runbooks/dp-cli-scaffolding.md
- /Users/stefan/Desktop/repos/harness-intelligence/apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/IMPLEMENTATION-NOTES.md
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [docs-ingest-phase, writing-great-skills]
tdd_status: not_applicable
tdd_target: Documentation and repo guidance alignment.
red_command:
expected_red_failure:
green_command: rg -n "finder-phase|fog|grilling|research|prototype|first-class" AGENTS.md docs/README.md docs/runbooks/dp-cli-scaffolding.md apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/IMPLEMENTATION-NOTES.md
reason_not_testable: Docs/guidance update validated by content assertions.
red_evidence:
green_evidence: rg -n "finder-phase|fog|grilling|research|prototype|first-class" AGENTS.md docs/README.md docs/runbooks/dp-cli-scaffolding.md apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/IMPLEMENTATION-NOTES.md passed.
codebase_design_notes: Keep workflow routing in prompts/root guidance; keep theory/docs separate from skill execution contracts.
review_mode: cli

T6: Final Validation And Review

depends_on: [T5]
location: /Users/stefan/Desktop/repos/harness-intelligence, /Users/stefan/Desktop/repos/wearedevpunks-skills
description: Run focused validation, inspect diffs, handle actionable review findings, and record final evidence.
validation: All focused checks pass or have explicit blocker notes.
status: Complete
log: Final validation passed. Follow-up review fixes were applied and the source repo is clean at pushed commit acc2702; Harness focused tests, whitespace checks, sync metadata, source-to-CLI finder-phase diff, active mirror diff, provider assertions, and docs/root assertions all passed.
files edited/created:
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/planning/wayfinder/SKILL.md
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/phases/finder-phase/**
- /Users/stefan/Desktop/repos/wearedevpunks-skills/skills/agnostic/requirements/write-backlog/**
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/content.test.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/prompts.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/content/scaffold-copy.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/packs.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/src/data/catalog/skills.ts
- /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills/**
- /Users/stefan/Desktop/repos/harness-intelligence/.agents/skills/**
- /Users/stefan/Desktop/repos/harness-intelligence/AGENTS.md
- /Users/stefan/Desktop/repos/harness-intelligence/docs/README.md
- /Users/stefan/Desktop/repos/harness-intelligence/docs/runbooks/dp-cli-scaffolding.md
- /Users/stefan/Desktop/repos/harness-intelligence/apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/PLAN.md
- /Users/stefan/Desktop/repos/harness-intelligence/apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/IMPLEMENTATION-NOTES.md
- /Users/stefan/Desktop/repos/harness-intelligence/apps/wiki/content/docs/project/specs/cli/finder-phase-wayfinder-skill-workflow/meta.json
backlog_item_id:
backlog_item_url:
relation_mode: none
assigned_skills: [review-phase, review, autoreview, simplify, codebase-design, improve-codebase-architecture]
tdd_status: not_applicable
tdd_target: Aggregate validation and review.
red_command:
expected_red_failure:
green_command: git -C /Users/stefan/Desktop/repos/wearedevpunks-skills diff --check && git diff --check && bun run --cwd apps/cli test src/content/content.test.ts && diff -qr /Users/stefan/Desktop/repos/wearedevpunks-skills/skills /Users/stefan/Desktop/repos/harness-intelligence/apps/cli/skills
reason_not_testable: Final review aggregates prior task tests and static checks.
red_evidence:
green_evidence: git -C /Users/stefan/Desktop/repos/wearedevpunks-skills diff --check passed; git diff --check passed; bun run --cwd apps/cli test src/content/content.test.ts passed 19 tests; finder-phase source vs CLI and CLI vs active diff -qr passed; active mirror diffs passed; sync metadata check printed acc27022bbe5af8c6eb1b3aede3917844a49b801; provider and docs/root rg assertions passed; broken ../../agnostic/requirements/write-backlog/SKILL.md link is absent from source, CLI, and active finder-phase copies; spec meta.json includes SPEC, PLAN, and IMPLEMENTATION-NOTES.
codebase_design_notes: Review should focus on source-of-truth separation, prompt routing, and provider taxonomy duplication.
review_mode: cli

Parallel Execution Waves

Wave	Tasks	Can Start When
0	T0	Immediately
1	T1	T0 complete
2	T2	T1 complete
3	T3	T2 complete
4	T4	T3 complete
5	T5	T4 complete
6	T6	T5 complete

Testing Strategy

Use bun run --cwd apps/cli test src/content/content.test.ts as the behavior seam for catalog, pack, and prompt routing; RED occurs in T3, GREEN occurs in T4 after sync.
Use git diff --check in both repos for whitespace regressions.
Use rg assertions for skill taxonomy, per-provider kind materialization, and docs/root guidance invariants.
Use sync metadata and file comparisons after sync to verify Harness mirrors reflect source.

Risks And Mitigations

Risk: bun run sync:skills ignores local shared-skill edits. Mitigation: Commit and push /Users/stefan/Desktop/repos/wearedevpunks-skills before sync.
Risk: finder-phase duplicates provider rules already owned by write-backlog. Mitigation: Keep finder-phase references focused on lifecycle/root routing and link to write-backlog for materialization.
Risk: Expanded backlog kinds weaken epic/story delivery semantics. Mitigation: Keep epic as the SPEC.md anchor and story as product-facing child scope in write-backlog.
Risk: Root prompt guidance becomes too large. Mitigation: Add only a short routing criterion before existing requirements routing.
Risk: User-authored finder-phase theory page changes concurrently. Mitigation: Do not edit that folder unless a docs-ingest phase finds a direct mismatch after implementation.

Unresolved Questions

None blocking. Baseline publication is intentionally deferred until the user asks for a release.

Finder Phase Wayfinder Skill Workflow Plan