Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .changeset/soft-walls-reply.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"@fission-ai/openspec": patch
---

feat(schemas): open each proposal with a short review focus

Adds a `## Review Focus` section to the spec-driven proposal template and a matching line in the schema instruction, so reviewers get a two-minute starting point (decisions to confirm, assumptions made without asking, deliberate exclusions) instead of reading or skimming the whole artifact set.
1 change: 1 addition & 0 deletions schemas/spec-driven/schema.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ artifacts:
Sections:
- **Why**: 1-2 sentences on the problem or opportunity. What problem does this solve? Why now?
- **Review Focus**: 3-5 bullets listing only what a reviewer should actually check: decisions a human should confirm, assumptions made without asking, and what is deliberately out of scope. Leave empty rather than pad.
- **What Changes**: Bullet list of changes. Be specific about new capabilities, modifications, or removals. Mark breaking changes with **BREAKING**.
- **Capabilities**: Identify which specs will be created or modified:
- **New Capabilities**: List capabilities being introduced. Each becomes a new `specs/<capability-path>/spec.md`. Use kebab-case for path segments you introduce (e.g., `user-auth` or `identity/user-auth`) and follow the project's existing spec organization.
Expand Down
7 changes: 7 additions & 0 deletions schemas/spec-driven/templates/proposal.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@

<!-- Explain the motivation for this change. What problem does this solve? Why now? -->

## Review Focus

<!-- 3-5 bullets. Leave empty rather than pad. -->
- Decisions a human should confirm
- Assumptions made without asking
- What is deliberately out of scope

## What Changes

<!-- Describe what will change. Be specific about new capabilities, modifications, or removals. -->
Expand Down