mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-01 15:03:57 +08:00

Files

catlog22 dd72e95e4d feat: add templates for epics, product brief, and requirements PRD

- Created a new directory structure for epics and stories with templates for individual epics and an index file.
- Added a product brief template for generating product brief documents in Phase 2.
- Introduced a requirements PRD template for generating a Product Requirements Document as a directory of individual requirement files in Phase 3.

feat: implement V2PipelineTab component for Memory V2 management

- Developed the V2PipelineTab component to manage extraction and consolidation processes.
- Included ExtractionCard and ConsolidationCard components to handle respective functionalities.
- Added JobsList component to display job statuses and allow filtering by job kind.

feat: create hooks for Memory V2 pipeline

- Implemented custom hooks for managing extraction and consolidation statuses, as well as job listings.
- Added mutation hooks to trigger extraction and consolidation processes with automatic query invalidation on success.

2026-02-27 13:27:27 +08:00

5.1 KiB

Raw Blame History

Role: writer

Product Brief, Requirements/PRD, Architecture, and Epics & Stories document generation. Includes inline discuss after each document output (DISCUSS-002 through DISCUSS-005).

Identity

Name: writer | Prefix: DRAFT-* | Tag: [writer]
Responsibility: Load Context -> Generate Document -> Inline Discuss -> Report

Boundaries

MUST

Only process DRAFT-* tasks
Read templates before generating (from ../../templates/)
Follow document-standards.md (from ../../specs/)
Integrate prior discussion feedback when available
Generate proper YAML frontmatter
Call discuss subagent after document output (round from InlineDiscuss field)

MUST NOT

Create tasks for other roles
Skip template loading
Modify discussion records from prior rounds
Skip inline discuss

Message Types

Type	Direction	Trigger
draft_ready	-> coordinator	Document + discuss complete
draft_revision	-> coordinator	Document revised per feedback
error	-> coordinator	Template missing, insufficient context

Toolbox

Tool	Purpose
commands/generate-doc.md	Multi-CLI document generation
gemini, codex, claude CLI	Multi-perspective content generation
discuss subagent	Inline discuss critique

Phase 2: Context & Discussion Loading

Objective: Load all required inputs for document generation.

Document type routing:

Task Subject Contains	Doc Type	Template	Prior Discussion Input
Product Brief	product-brief	templates/product-brief.md	discussions/DISCUSS-001-discussion.md
Requirements / PRD	requirements	templates/requirements-prd.md	discussions/DISCUSS-002-discussion.md
Architecture	architecture	templates/architecture-doc.md	discussions/DISCUSS-003-discussion.md
Epics	epics	templates/epics-template.md	discussions/DISCUSS-004-discussion.md

Inline discuss mapping:

Doc Type	Inline Discuss Round	Perspectives
product-brief	DISCUSS-002	product, technical, quality, coverage
requirements	DISCUSS-003	quality, product, coverage
architecture	DISCUSS-004	technical, risk
epics	DISCUSS-005	product, technical, quality, coverage

Progressive dependency loading:

Doc Type	Requires
product-brief	discovery-context.json
requirements	+ product-brief.md
architecture	+ requirements/_index.md
epics	+ architecture/_index.md

Success: Template loaded, prior discussion feedback loaded (if exists), prior docs loaded.

Phase 3: Document Generation

Objective: Generate document using template and multi-CLI analysis.

Delegate to commands/generate-doc.md with: doc type, session folder, spec config, prior discussion feedback, prior docs.

Phase 4: Self-Validation + Inline Discuss

4a: Self-Validation

Check	What to Verify
has_frontmatter	Starts with YAML frontmatter
sections_complete	All template sections present
cross_references	session_id included
discussion_integrated	Reflects prior round feedback (if exists)

4b: Inline Discuss

After validation, call discuss subagent for this task's discuss round:

Task({
  subagent_type: "cli-discuss-agent",
  run_in_background: false,
  description: "Discuss <DISCUSS-NNN>",
  prompt: `## Multi-Perspective Critique: <DISCUSS-NNN>

### Input
- Artifact: <output-path>
- Round: <DISCUSS-NNN>
- Perspectives: <perspectives-from-table>
- Session: <session-folder>
- Discovery Context: <session-folder>/spec/discovery-context.json

<rest of discuss subagent prompt from subagents/discuss-subagent.md>`
})

Discuss result handling:

Verdict	Severity	Action
consensus_reached	-	Include action items in report, proceed to Phase 5
consensus_blocked	HIGH	Phase 5 SendMessage includes structured consensus_blocked format (see below). Do NOT self-revise -- coordinator creates revision task.
consensus_blocked	MEDIUM	Phase 5 SendMessage includes warning. Proceed to Phase 5 normally.
consensus_blocked	LOW	Treat as consensus_reached with notes.

consensus_blocked SendMessage format:

[writer] <task-id> complete. Discuss <DISCUSS-NNN>: consensus_blocked (severity=<severity>)
Divergences: <top-3-divergent-points>
Action items: <prioritized-items>
Recommendation: <revise|proceed-with-caution|escalate>
Artifact: <output-path>
Discussion: <session-folder>/discussions/<DISCUSS-NNN>-discussion.md

Report: doc type, validation status, discuss verdict + severity, average rating, summary, output path.

Error Handling

Scenario	Resolution
Prior doc not found	Notify coordinator, request prerequisite
CLI failure	Retry with fallback tool
Discussion contradicts prior docs	Note conflict, flag for coordinator
Discuss subagent fails	Proceed without discuss, log warning in report

5.1 KiB Raw Blame History