mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-10 17:11:04 +08:00

Files

catlog22 29a1fea467 feat: Add templates for epics, product brief, and requirements documentation

- Introduced a comprehensive template for generating epics and stories in Phase 5, including an index and individual epic files.
- Created a product brief template for Phase 2 to summarize product vision, goals, and target users.
- Developed a requirements PRD template for Phase 3, outlining functional and non-functional requirements, along with traceability matrices.

feat: Implement tech debt roles for assessment, execution, planning, scanning, validation, and analysis

- Added roles for tech debt assessment, executor, planner, scanner, validator, and analyst, each with defined phases and processes for managing technical debt.
- Each role includes structured input requirements, processing strategies, and output formats to ensure consistency and clarity in tech debt management.

2026-03-07 13:32:04 +08:00

3.3 KiB

Raw Blame History

role, prefix, inner_loop, message_types

role

prefix

inner_loop

message_types

scanner

SCAN

false

state_update

UI Scanner

Scan UI components to identify interaction issues: unresponsive buttons, missing feedback mechanisms, state not refreshing.

Phase 2: Context Loading

Input	Source	Required
Project path	Task description CONTEXT	Yes
Framework	Task description CONTEXT	Yes
Scan scope	Task description CONSTRAINTS	Yes

Extract session path and project path from task description
Detect framework from project structure:

Signal	Framework
package.json has "react"	React
package.json has "vue"	Vue
*.tsx files present	React
*.vue files present	Vue

Build file pattern list for scanning:
- React: **/*.tsx, **/*.jsx, **/use*.ts
- Vue: **/*.vue, **/composables/*.ts

Wisdom Input

Read <session>/wisdom/anti-patterns/common-ux-pitfalls.md if available
Use anti-patterns to identify known UX issues during scanning
Check <session>/wisdom/patterns/ui-feedback.md for expected feedback patterns

Complex Analysis (use CLI)

For large projects with many components:

Bash(`ccw cli -p "PURPOSE: Discover all UI components with user interactions
CONTEXT: @<project-path>/**/*.tsx @<project-path>/**/*.vue
EXPECTED: Component list with interaction types (click, submit, input, select)
CONSTRAINTS: Focus on interactive components only" --tool gemini --mode analysis`)

Phase 3: Component Scanning

Scan strategy:

Category	Detection Pattern	Severity
Unresponsive actions	onClick/@click without async handling or error catching	High
Missing loading state	Form submit without isLoading/loading ref	High
State not refreshing	Array.splice/push without reactive reassignment	High
Missing error feedback	try/catch without error state or user notification	Medium
Missing success feedback	API call without success confirmation	Medium
No empty state	Data list without empty state placeholder	Low
Input without validation	Form input without validation rules	Low
Missing file selector	Text input for file/folder path without picker	Medium

For each component file:

Read file content
Scan for interaction patterns using Grep
Check for feedback mechanisms (loading, error, success states)
Check state update patterns (mutation vs reactive)
Record issues with file:line references

Phase 4: Issue Report Generation

Classify issues by severity (High/Medium/Low)
Group by category (unresponsive, missing feedback, state issues, input UX)
Generate structured report and write to <session>/artifacts/scan-report.md

Share state via team_msg:

team_msg(operation="log", session_id=<session-id>, from="scanner",
         type="state_update", data={
           total_issues: <count>,
           high: <count>, medium: <count>, low: <count>,
           categories: [<category-list>],
           scanned_files: <count>
         })

Wisdom Contribution

If novel UX issues discovered that aren't in anti-patterns:

Write findings to <session>/wisdom/contributions/scanner-issues-<timestamp>.md
Format: Issue description, detection criteria, affected components

3.3 KiB Raw Blame History