docs(assess): clarify the pipeline works on an empty project#3732
Open
mnriem wants to merge 2 commits into
Open
docs(assess): clarify the pipeline works on an empty project#3732mnriem wants to merge 2 commits into
mnriem wants to merge 2 commits into
Conversation
mnriem
force-pushed
the
mnriem-docs-assess-empty-project
branch
from
July 24, 2026 21:04
f93737d to
bc68151
Compare
State explicitly in the README and intake command that the assess pipeline requires no existing source code. An empty, freshly initialized project and an existing codebase are equally valid starting points — the input is just an idea (pasted text, a URL, a ticket, or a codebase pointer). Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9df2615e-6a99-4cdc-b4b2-fc72029bc1d9
mnriem
force-pushed
the
mnriem-docs-assess-empty-project
branch
from
July 24, 2026 21:04
bc68151 to
68619ff
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
Clarifies that the assessment pipeline supports freshly initialized projects without source code.
Changes:
- Documents empty-project support in the extension overview.
- Clarifies valid intake inputs and starting points.
Show a summary per file
| File | Description |
|---|---|
extensions/assess/README.md |
Explains empty and existing projects are supported. |
extensions/assess/commands/speckit.assess.intake.md |
Clarifies intake does not require source code. |
Review details
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 0
- Review effort level: Medium
|
|
||
| ## Overview | ||
|
|
||
| `assess` works equally well for a **freshly initialized, empty project** or for an **existing codebase** — you do not need any source code to assess an idea. The input is just an idea: pasted text, a URL, or a ticket work with no repo at all, and a codebase pointer lets you assess an idea for existing code. Neither is more "correct" than the other. |
Collaborator
Author
| 3. **A codebase pointer** — phrasing like "an idea for this repo" or a path. Read enough of the repository to record what the idea relates to. | ||
| 4. **A mix** of the above. | ||
|
|
||
| There is **no requirement for existing source code**: intake works just as well for an empty, freshly initialized project as for an existing codebase. Pasted text or a URL (options 1–2) need no repo; a codebase pointer (option 3) targets existing code. Both are equally valid. |
Collaborator
Author
Clarify that assess still runs inside an initialized Spec Kit project (writing under .specify/assessments/) — only existing source code is optional. Reword 'no repo at all'/'need no repo' to 'need no existing codebase' so users don't expect intake to work outside a Spec Kit project. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9df2615e-6a99-4cdc-b4b2-fc72029bc1d9
Collaborator
Author
|
Addressed the review feedback in 70fc8b1. Both comments flagged the same overstatement — "no repo at all" / "need no repo" — which wrongly implied intake works outside a Spec Kit project. Fixed by:
— GitHub Copilot (model: Claude Opus 4.8), acting autonomously on behalf of @mnriem |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Makes it explicit that the
assessextension can be used on an empty, freshly initialized project — no existing source code is required. An empty project and an existing codebase are equally valid starting points.Previously the docs only implied this, and the "codebase pointer" / "assess this repo" wording in intake could give the impression that existing code was expected. This adds two short, explicit statements.
Changes
extensions/assess/README.md— Overview now states thatassessworks equally well on an empty project or an existing codebase; the input is just an idea (pasted text, a URL, a ticket, or a codebase pointer).extensions/assess/commands/speckit.assess.intake.md— adds a line after the input-types list clarifying there is no requirement for existing source code, and that both starting points are equally valid.Docs-only change; no behavior or code affected.
🤖 This PR was authored autonomously by GitHub Copilot (model: Claude Opus 4.8) on behalf of @mnriem.