Skip to content

Add /dstack-feedback with a findings-style gate for toolkit friction - #9

Open
petaltank wants to merge 2 commits into
feat/roadmap-0.4from
feat/feedback
Open

petaltank wants to merge 2 commits into
feat/roadmap-0.4from
feat/feedback

Conversation

@petaltank

Copy link
Copy Markdown
Collaborator

Summary

Roadmap item 3 (meta/roadmap-0.4.md). Based on #6; GitHub retargets to master once #6 merges. Independent of #7 and #8 (if #8 also lands, the spec's principles list needs a one-line renumber — both add an "18.").

  • New command harnesses/claude-code/commands/dstack-feedback.md, two modes:
    • /dstack-feedback <note> — writes one file to repo-level doc/dstack/feedback/<date>-<slug>.md with status: new, kind, the installed dstack: version/commit, and a context: line (project · command · ticket). Asks nothing, touches no network. Stops.
    • /dstack-feedback (no argument) — runs the gate: each new note is filed as a GitHub issue (gh issue create --repo <repo>, only on the user's pick for that note) or dropped with a reason:. "Sitting there" is not an outcome.
  • The gate runs before every ticket pick, right after the findings scan — dstack-ticket Step 3, dstack-yolo Step 2 (the one loop step that needs the human even at full autonomy; it never drops or files on its own), and SKILL.md Step 0 on resume.
  • Agents are told to log friction the moment they hit it — same paragraph in SKILL close-out, dstack-ticket, dstack-yolo Step 7, and dstack-retro Step 4 (which also offers to turn each process observation into a note).
  • install.sh writes repo= into .dstack-version (from the checkout's origin, falling back to the canonical URL) so the command knows where to file; older installs fall back to the canonical repo.
  • Spec: new "Feedback — the fast lane" section + principle. Three tiers stated once: feedback (now, one note, gated) → retro (deliberate, one project) → meta/process-notes.md (curated, cross-project).
  • examples/feedback/ shows a dropped note. README: walkthrough step 11, a Common-mistakes entry, an FAQ.

Verification

  • bash -n install.sh; ./install.sh into a scratch repo — dstack-feedback.md lands, .dstack-version carries repo=https://github.com/dsegovia90/dstack.
  • gh auth status passes here. No real issue was created during verification.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr

petaltank and others added 2 commits September 11, 2026 21:06
A note about dstack itself had nowhere to go except memory or a retro weeks later.
/dstack-feedback <note> writes one file to the repo-level doc/dstack/feedback/ with
status: new, the installed version/commit, and the project/command/ticket in flight — no
question, no network, so logging costs nothing. Every ticket pick then gates pending notes
right after the findings scan: filed as a GitHub issue on the dstack repo via gh (on the
user's say-so, per note) or dropped with a recorded reason. Agents are told in every
command to log friction the moment they hit it and never to file on their own.

install.sh records repo= in .dstack-version so the command knows where to file (a fork
stays a fork). dstack-retro reads feedback notes as a source. examples/feedback/ shows
the shape of a dropped note.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr
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.

1 participant