Skip to content

docs(skills): restructure spec-start qna.md as flat Q-NN log#875

Merged
ifireball merged 1 commit into
fullsend-ai:mainfrom
ifireball:cursor/spec-start-qna-format
May 14, 2026
Merged

docs(skills): restructure spec-start qna.md as flat Q-NN log#875
ifireball merged 1 commit into
fullsend-ai:mainfrom
ifireball:cursor/spec-start-qna-format

Conversation

@ifireball
Copy link
Copy Markdown
Contributor

@ifireball ifireball commented May 13, 2026

Summary

  • Replace the old three-part qna.md layout (Assumptions / Open questions / Scope) with a flat stream of ## Q-NN entries and Kind: bullets (assumption | open | scope | decomposition).
  • Answers are optional sibling ### headings under a question; exactly one example ### is seeded only under Q-01 so the file stays easy to scan before review.
  • spec.md now calls for a Q&A index pointing at Q-NN anchors; checklist, process diagram, self-review, and aftercare are aligned.

Setting a structure for the qna.md file that can facilitate including answers is necessary for implementing #802

Notes

Local main was fast-forwarded from upstream/main; this branch was rebased onto that main and force-pushed.

Made with Cursor

Teach unified ## Q-NN entries with Kind bullets, optional ### answers,
Q&A index in spec.md, and a single example ### under Q-01 only.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions
Copy link
Copy Markdown

fullsend review is working on this — view logs

@github-actions
Copy link
Copy Markdown

Site preview

Preview: https://6a0b8ebb-site.fullsend-ai.workers.dev

Commit: aba5d43d35c977a8e8d8b735daa46fcce84b72d0

@ifireball ifireball self-assigned this May 13, 2026
@fullsend-ai-review
Copy link
Copy Markdown

Review: #875

Head SHA: aba5d43
Timestamp: 2026-05-13T00:00:00Z
Outcome: approve

Summary

Clean documentation restructure of the spec-start skill's qna.md format specification. The change replaces the old three-section layout (Assumptions / Open questions / Scope) with a flat ## Q-NN log using Kind bullets and optional ### answer headings, with one seeded example under Q-01. All references throughout the skill document — checklist steps, process flow diagram, understanding/exploring guidance, spec.md required sections, self-review checklist, and aftercare — are updated consistently to use the new Q-NN terminology. The minimal example is well-formed and matches the described rules. No correctness, security, or injection concerns; no scope creep beyond the stated intent.

Findings

No findings.

Footer

Outcome: approve
This review applies to SHA aba5d43d35c977a8e8d8b735daa46fcce84b72d0. Any push to the PR head clears this review and requires a new evaluation.

@ifireball ifireball added this pull request to the merge queue May 14, 2026
Merged via the queue into fullsend-ai:main with commit d7395db May 14, 2026
25 checks passed
@ifireball ifireball deleted the cursor/spec-start-qna-format branch May 14, 2026 05:52
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