Skip to content

Commit b698bfa

Browse files
update specify step to be multi-agent
Signed-off-by: Michael Clifford <mcliffor@redhat.com>
1 parent a353324 commit b698bfa

File tree

1 file changed

+96
-1
lines changed

1 file changed

+96
-1
lines changed

components/frontend/src/app/projects/[name]/rfe/[id]/rfe-phase-cards.tsx

Lines changed: 96 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,102 @@ You can invoke agents by using their name in your prompts. For example: "Let's g
301301
onStartPhase(phase);
302302
const isSpecify = phase === "specify";
303303
const basePrompt = isSpecify
304-
? `/speckit.specify Develop a new feature based on rfe.md or if that does not exist, follow these feature requirements: ${workflow.description}`
304+
? `MULTI-AGENT COLLABORATIVE SPECIFICATION WORKFLOW:
305+
306+
You MUST follow this structured workflow to create a comprehensive feature specification using multiple agent perspectives.
307+
308+
## CRITICAL REQUIREMENT: Citations and Evidence
309+
310+
**ALL facts, statistics, data points, market research, and claims MUST include proper citations with actual links to sources.**
311+
312+
Citation Requirements:
313+
- Citations MUST be links to actual sources that were reviewed (web pages, documents, files)
314+
- Use WebSearch or WebFetch tools to find and verify sources before citing them
315+
- For internal documents: Link to file path or repository location
316+
- For external sources: Full URL to the actual page/document
317+
- If you cannot find a credible source with a link, DO NOT make up a citation
318+
- If you cannot find a credible source, DO NOT include the claim
319+
320+
**FORBIDDEN**: Making up links, citing sources you didn't actually review, or claiming statistics without verified sources.
321+
322+
Citation Format:
323+
- "Claim or data point" [[Source Title](actual-url-or-file-path)]
324+
- For assumptions based on common practice: Clearly label as [Assumption: reasoning] - no citation needed for explicit assumptions
325+
326+
Examples of CORRECT citations:
327+
- "Next.js App Router supports streaming SSR" [[Next.js Documentation](https://nextjs.org/docs/app/building-your-application/routing)]
328+
- "The current authentication flow requires 5 steps" [[Source: specs/001-auth/spec.md](specs/001-auth/spec.md)]
329+
- "Users expect checkout to complete in under 3 minutes" [Assumption: based on standard e-commerce UX practices]
330+
331+
Examples of INCORRECT/FORBIDDEN:
332+
- "87% of developers prefer dark mode [Source: Stack Overflow Survey 2024]" - NO LINK, FORBIDDEN
333+
- "Studies show users prefer this" - NO SOURCE AT ALL, FORBIDDEN
334+
- "Research from MIT indicates..." [[MIT Study](https://fake-url.com)] - MADE UP LINK, FORBIDDEN
335+
336+
**If you need data to support a claim:**
337+
1. Use WebSearch to find actual sources
338+
2. Use WebFetch to verify the content
339+
3. Include the real URL in your citation
340+
4. If you cannot find a source, remove the claim or mark it as an assumption
341+
342+
## Step 1: PM-Led Initial Outline
343+
344+
Invoke Parker (Product Manager) to create an initial RFE outline based on rfe.md (or if that doesn't exist, use these requirements: ${workflow.description}).
345+
346+
**CRITICAL**: When invoking Parker, you MUST include the complete "CRITICAL REQUIREMENT: Citations and Evidence" section above in Parker's prompt. Parker must follow all citation requirements.
347+
348+
Parker should create an outline containing:
349+
- Executive summary with business justification and market analysis (with proper citations)
350+
- Business impact and customer requirements (with proper citations)
351+
- Technical approach (high-level, no implementation details)
352+
- User experience considerations (with proper citations where applicable)
353+
- Implementation scope (in-scope vs out-of-scope)
354+
- Acceptance criteria
355+
- Risks and mitigation strategies
356+
- Success metrics (with proper citations for benchmarks)
357+
358+
## Step 2: Agent Selection
359+
360+
Parker should analyze the feature type and select TWO agents best suited to review the outline:
361+
362+
**Selection criteria by feature type**:
363+
- Infrastructure/Platform features → Archie (Architect) + Stella (Staff Engineer)
364+
- User-facing UI features → Felix (UX Feature Lead) + Stella (Staff Engineer)
365+
- API/Integration features → Archie (Architect) + Taylor (Team Member)
366+
- Documentation features → Terry (Technical Writer) + Casey (Content Strategist)
367+
- Testing/Quality features → Neil (Test Engineer) + Stella (Staff Engineer)
368+
369+
## Step 3: Parallel Agent Reviews
370+
371+
Launch BOTH selected agents in parallel (single message with multiple Task tool calls) to review Parker's outline.
372+
373+
**CRITICAL**: When invoking each review agent, you MUST include the complete "CRITICAL REQUIREMENT: Citations and Evidence" section in their prompts. Each agent must verify that all claims in Parker's outline have proper citations and flag any unsupported claims.
374+
375+
Each agent should:
376+
- Review from their domain expertise perspective
377+
- Verify all citations are actual links to reviewed sources
378+
- Flag any claims without proper citations or with fabricated links
379+
- Provide structured feedback with specific recommendations
380+
- Identify gaps, risks, architectural concerns, and improvement opportunities
381+
382+
## Step 4: Document Versioning
383+
384+
Save all versions during the refinement process:
385+
1. Save Parker's initial outline as \`specs/[feature-dir]/outline-v1-pm-initial.md\`
386+
2. Save Agent 1's feedback as \`specs/[feature-dir]/feedback-agent1.md\`
387+
3. Save Agent 2's feedback as \`specs/[feature-dir]/feedback-agent2.md\`
388+
4. Save Parker's revised outline as \`specs/[feature-dir]/outline-v2-revised.md\`
389+
390+
## Step 5: Final Spec Generation
391+
392+
Have Parker incorporate all feedback and then run:
393+
\`/specify Develop a new feature based on the revised outline\`
394+
395+
This will generate the final spec.md using the collaborative outline as the foundation.
396+
397+
---
398+
399+
BEGIN WORKFLOW NOW.`
305400
: `/speckit.${phase}`;
306401
const prompt = basePrompt + getAgentInstructions();
307402
const payload: CreateAgenticSessionRequest = {

0 commit comments

Comments
 (0)