mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-05 16:13:08 +08:00

Files

catlog22 bbdd1840de Add document standards, quality gates, and templates for team lifecycle phases

- Introduced `document-standards.md` to define YAML frontmatter schema, naming conventions, and content structure for spec-generator outputs.
- Created `quality-gates.md` outlining per-phase quality gate criteria and scoring dimensions for spec-generator outputs.
- Added templates for architecture documents, epics and stories, product briefs, and requirements PRD to streamline documentation in respective phases.

2026-03-04 23:54:20 +08:00

2.2 KiB

Raw Blame History

role, prefix, inner_loop, discuss_rounds, cli_tools, message_types

role

prefix

inner_loop

discuss_rounds

cli_tools

message_types

fe-qa

QA-FE

false

success	result	fix	error
qa_fe_passed	qa_fe_result	fix_required	error

FE QA — Phase 2-4

Review Dimensions

Dimension	Weight	Focus
Code Quality	25%	TypeScript types, component structure, error handling
Accessibility	25%	Semantic HTML, ARIA, keyboard nav, contrast, focus-visible
Design Compliance	20%	Token usage, no hardcoded colors, no emoji icons
UX Best Practices	15%	Loading/error/empty states, cursor-pointer, responsive
Pre-Delivery	15%	No console.log, dark mode, i18n readiness

Phase 2: Context Loading

Inputs: design tokens, design intelligence, shared memory, previous QA results (for GC round tracking), changed frontend files via git diff.

Determine GC round from previous QA results count. Max 2 rounds.

Phase 3: 5-Dimension Review

For each changed frontend file, check against all 5 dimensions. Score each dimension 0-10, deducting for issues found.

Scoring deductions:

Severity	Deduction
High	-2 to -3
Medium	-1 to -1.5
Low	-0.5

Overall score = weighted sum of dimension scores.

Verdict routing:

Condition	Verdict
Score >= 8 AND no critical issues	PASS
GC round >= max AND score >= 6	PASS_WITH_WARNINGS
GC round >= max AND score < 6	FAIL
Otherwise	NEEDS_FIX

Phase 4: Report

Write audit to <session-folder>/qa/audit-fe-<task>-r<round>.json. Update wisdom and shared memory.

Report: round, verdict, overall score, dimension scores, critical issues with Do/Don't format, action required (if NEEDS_FIX).

Generator-Critic Loop

Orchestrated by coordinator:

Round 1: DEV-FE-001 → QA-FE-001
  if NEEDS_FIX → coordinator creates DEV-FE-002 + QA-FE-002
Round 2: DEV-FE-002 → QA-FE-002
  if still NEEDS_FIX → PASS_WITH_WARNINGS or FAIL (max 2)

Convergence: score >= 8 AND critical_count = 0

Error Handling

Scenario	Resolution
No changed files	Report empty, score N/A
Design tokens not found	Skip design compliance, adjust weights
Max GC rounds exceeded	Force verdict

2.2 KiB Raw Blame History