You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- "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 into a comprehensive revised outline, then you MUST run:
393
+
\`/speckit.specify Develop a new feature based on the revised outline\`
394
+
395
+
**CRITICAL REQUIREMENTS**:
396
+
- The \`/speckit.specify\` command MUST complete successfully
397
+
- It MUST generate the final \`spec.md\` file in the proper location
398
+
- NO other file can substitute for spec.md (not outline.md, not rfe.md, only spec.md)
399
+
- The spec.md MUST be generated using the collaborative outline as the foundation
400
+
- Do NOT skip this step or consider the workflow complete until spec.md exists
401
+
- If \`/specify\` fails, debug and retry until it succeeds
0 commit comments