Skip to content

Clarify conflicting persistence instructions in /speckit.clarify#2154

Open
song-chaeyoung wants to merge 1 commit intogithub:mainfrom
song-chaeyoung:codex/docs-clarify-persistence-timing
Open

Clarify conflicting persistence instructions in /speckit.clarify#2154
song-chaeyoung wants to merge 1 commit intogithub:mainfrom
song-chaeyoung:codex/docs-clarify-persistence-timing

Conversation

@song-chaeyoung
Copy link
Copy Markdown

Description

Clarify that accepted answers are first recorded in working memory and then passed to the integration step below for per-integration persistence.

This preserves the intended incremental-save flow while removing the conflict between step 4's earlier "do not yet write to disk" wording and step 5's instruction to save after each integration.

This PR is intentionally scoped to a single wording change in templates/commands/clarify.md.

Testing

  • Tested locally with uv run specify --help
  • Ran existing tests with uv sync --extra test and uv run python -m pytest tests/integrations/test_integration_codex.py tests/integrations/test_integration_generic.py tests/integrations/test_integration_copilot.py -q
  • Tested with a sample project (if applicable)

Sample project check:

  • uv run specify init /tmp/spec-kit-clarify-8TOc7j/project --ai codex --offline --ignore-agent-tools
  • Confirmed the generated .agents/skills/speckit-clarify/SKILL.md includes the updated persistence wording

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

I used AI assistance to review the conflicting wording, compare the repository's contribution and testing guidance, draft the wording update, and prepare the PR text. I reviewed the final change and test results manually.

Clarify that accepted answers are first recorded in working memory and then passed to the integration step below for per-integration persistence.

This preserves the intended incremental-save flow while removing the conflict between step 4's earlier "do not yet write to disk" wording and step 5's instruction to save after each integration.
@song-chaeyoung song-chaeyoung requested a review from mnriem as a code owner April 10, 2026 13:14
@song-chaeyoung song-chaeyoung changed the title resolve conflicting persistence instructions in /speckit.clarify Clarify conflicting persistence instructions in /speckit.clarify Apr 10, 2026
@mnriem mnriem requested a review from Copilot April 10, 2026 13:56
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Clarifies /speckit.clarify persistence guidance so accepted answers are first captured in working memory, then immediately integrated and persisted per the existing “save after each integration” flow.

Changes:

  • Updates step 4 wording to explicitly hand accepted answers to the integration step and persist after each integration, resolving a “do not yet write to disk” vs. “save after each integration” conflict.
Show a summary per file
File Description
templates/commands/clarify.md Adjusts sequential questioning loop wording to align with incremental integration + per-answer disk persistence described in step 5.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 1/1 changed files
  • Comments generated: 0

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.

3 participants