Skip to content

feat(quick-dev): improve checkpoint 1 UX#2217

Open
alexeyv wants to merge 2 commits intorefactor/eliminate-wip-filefrom
feat/checkpoint-ux
Open

feat(quick-dev): improve checkpoint 1 UX#2217
alexeyv wants to merge 2 commits intorefactor/eliminate-wip-filefrom
feat/checkpoint-ux

Conversation

@alexeyv
Copy link
Copy Markdown
Collaborator

@alexeyv alexeyv commented Apr 5, 2026

Summary

  • Display spec file path as clickable CWD-relative link alongside the checkpoint summary (moved from post-approval to presentation time)
  • Add note informing users they can open the spec externally with any tool (party mode, advanced elicitation, code review, etc.) before approving
  • On approval, re-read spec from disk and acknowledge any external edits before proceeding; HALT if file missing

Test plan

  • Run quick-dev through step-02 and verify the spec path appears clickable in the summary
  • Verify the external editing note is displayed below the options
  • Edit the spec externally during the HALT, approve, and confirm external changes are acknowledged
  • Approve without external edits and confirm no change mention appears

alexeyv and others added 2 commits April 4, 2026 21:05
Write directly to spec-{slug}.md with status: draft instead of using
a shared spec-wip.md file. Use draft status for resume detection in
step-01. Removes wipFile variable from all step frontmatter and
workflow initialization.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…l editing note, and change detection

Display spec file path as clickable CWD-relative link alongside the
summary. Inform users they can open the spec in another session with
any tool before approving. On approval, re-read the spec from disk
and acknowledge any external edits before proceeding.
@alexeyv alexeyv force-pushed the refactor/eliminate-wip-file branch from 6e052c9 to 9a26c0d Compare April 5, 2026 20:14
@augmentcode
Copy link
Copy Markdown

augmentcode bot commented Apr 6, 2026

🤖 Augment PR Summary

Summary: Improves Quick-Dev Step 2 Checkpoint 1 by showing the spec path as a clickable CWD-relative link and adding guidance about externally editing the spec before approval.
Behavior: On approval, re-reads the spec from disk, acknowledges any external edits, and halts if the file is missing before proceeding to implementation.

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

Present summary. Display the spec file path as a CWD-relative path (no leading `/`) so it is clickable in the terminal. If token count exceeded 1600 and user chose [K], include the token count and explain why it may be a problem.

- **A**: Rename `{wipFile}` to `{spec_file}`, set status `ready-for-dev`. Everything inside `<frozen-after-approval>` is now locked — only the human can change it. Display the finalized spec path to the user as a CWD-relative path (no leading `/`) so it is clickable in the terminal. → Step 3.
After presenting the summary and options, add this note:
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After presenting the summary and options, add this note: reads like the note should come after the [A]/[E] menu, but the menu is shown later; this ambiguity could lead to the note being displayed in the wrong order or the options being presented twice.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.


HALT and ask human: `[A] Approve` | `[E] Edit`

- **A**: Re-read `{spec_file}` from disk. Compare the content to what you wrote. If the file has changed since you wrote it, acknowledge the external edits — show a brief summary of what changed — and proceed with the updated version. If the file is missing, HALT and tell the user. Set status `ready-for-dev` in `{spec_file}`. Everything inside `<frozen-after-approval>` is now locked — only the human can change it. → Step 3.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the A flow, If the file is missing, HALT and tell the user. is followed by actions that modify {spec_file}; consider making it unambiguous that nothing (including status updates) should run after the missing-file HALT to avoid accidentally recreating/overwriting the spec.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

@alexeyv alexeyv force-pushed the refactor/eliminate-wip-file branch from 9a26c0d to 100bb2c Compare April 7, 2026 05:26
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