Skip to content

#691 - Adopt wayfinder + implement, reshape planning pipeline into spec/plan review#693

Draft
bracyw wants to merge 1 commit into
684-split-grill-with-docsfrom
691-adopt-engineering-flow
Draft

#691 - Adopt wayfinder + implement, reshape planning pipeline into spec/plan review#693
bracyw wants to merge 1 commit into
684-split-grill-with-docsfrom
691-adopt-engineering-flow

Conversation

@bracyw

@bracyw bracyw commented Jul 11, 2026

Copy link
Copy Markdown
Collaborator

Changes

Completes the Matt Pocock engineering-flow adoption.

  • Spine = Matt's main flow: grill-with-docs to to-spec to to-tickets to implement. A clear single feature can skip grill to to-spec; a trivial one-liner goes straight to implement.
  • wayfinder skill added as the exploration on-ramp — charts a map of investigation tickets on the tracker for a too-big-for-one-session effort, then merges at to-spec (one map can feed several specs). Argos-adapted to docs/agents, keeps HITL/AFK.
  • implement skill added — drives tdd to code-review to commit (Argos /commit convention); does not push. Reuses the existing /code-review rather than vendoring Matt's (avoids shadowing the built-in).
  • Spec/plan review — reshapes #668 - Branch-based planning pipeline and ai-workflow label #669's branch pipeline into a narrow requirement: to-spec and to-tickets stage artifacts under docs/spec/ and review them as a PR before publishing, so unreviewed tickets never spam the tracker. Decoupled from grilling and wayfinder. Restores the local-file draft mode dropped in Rename to-prd/to-issues skills to to-spec/to-tickets and refresh from upstream #683.
  • Wayfinding operations + ai-workflow / wayfinder:* labels in the tracker doc, glossary terms, CLAUDE.md flow wiring, ADR-0005.

Notes

Stacked on #686 (needs grilling/domain-modeling + the renamed to-spec/to-tickets). Review order: #685 to #686 to this. research is a parallel PR (#690) that wayfinder references by name. Supersedes #669 — its durable pieces (ai-workflow label, review-before-publish) live on here reshaped.

Test Cases

  • wayfinder, implement skills load; referenced skills (tdd, commit, prototype, grilling, domain-modeling, research) resolve
  • Wayfinding operations documented for GitHub
  • to-spec / to-tickets stage-and-review before publishing per spec-review.md
  • ADR-0005 present; CLAUDE.md flow reflects spine + on-ramps + review gate

Checklist

  • All commits are tagged with the ticket number
  • No merge conflicts
  • Removed non-applicable sections of this template

Closes #691
Closes #692


Generated by Claude Code

…ec/plan review

Take Matt Pocock's main flow as the spine (grill-with-docs -> to-spec ->
to-tickets -> implement) with wayfinder as the exploration on-ramp that
merges at to-spec (one map can feed several specs). Add the implement
skill (drives tdd -> code-review -> commit; Argos /commit convention).
Reuse the existing /code-review rather than vendoring Matt's.

Reshape #669's branch planning pipeline into a narrow spec/plan review
requirement: to-spec and to-tickets stage artifacts as files under
docs/spec/<name>/ and review them as a PR before publishing, keeping
unreviewed tickets off the tracker. Decoupled from grilling and
wayfinder; restores the local-file draft mode dropped in #683.

Add Wayfinding operations + ai-workflow / wayfinder:* labels to the
tracker doc, glossary terms, CLAUDE.md flow wiring, and ADR-0005.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdH2gxRtfjoqUWa5hG8SvF
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants