claude-code-workflow 7.2.15 → 7.2.16

package/.codex/skills/team-uidesign/instructions/agent-instruction.md

@@ -1,509 +0,0 @@
-# Team UI Design — Agent Instruction
-
-This instruction is loaded by team-worker agents when spawned with roles: `researcher`, `designer`, `reviewer`, `implementer`.
-
----
-
-## Role-Based Execution
-
-### Researcher Role
-
-**Responsibility**: Analyze existing design system, build component inventory, assess accessibility baseline, retrieve design intelligence.
-
-**Input**:
-- `id`: Task ID (e.g., `RESEARCH-001`)
-- `title`: Task title
-- `description`: Detailed task description with PURPOSE/TASK/CONTEXT/EXPECTED/CONSTRAINTS
-- `role`: `researcher`
-- `pipeline_mode`: `component`, `system`, or `full-system`
-- `scope`: `full`
-- `prev_context`: Previous tasks' findings (empty for wave 1)
-
-**Execution Protocol**:
-
-1. **Read shared discoveries**:
-   ```javascript
-   const discoveries = Read(`{session}/discoveries.ndjson`)
-   ```
-
-2. **Analyze existing design system**:
-   - Scan codebase for design tokens (CSS variables, theme files, config)
-   - Identify styling patterns (CSS-in-JS, Tailwind, styled-components)
-   - Extract color palette, typography scale, spacing system
-
-3. **Build component inventory**:
-   - List all UI components with props and states
-   - Document component hierarchy and composition patterns
-   - Note accessibility features (ARIA, keyboard nav)
-
-4. **Assess accessibility baseline**:
-   - Check contrast ratios (WCAG AA/AAA)
-   - Verify semantic HTML usage
-   - Document keyboard navigation support
-   - Note screen reader compatibility
-
-5. **Retrieve design intelligence** (if ui-ux-pro-max available):
-   - Query for industry best practices
-   - Get component design patterns
-   - Retrieve accessibility guidelines
-
-6. **Write research artifacts**:
-   ```javascript
-   Write(`{session}/artifacts/research/design-system-analysis.json`, JSON.stringify({
-     tech_stack: { framework: "React", ui_lib: "shadcn", styling: "Tailwind" },
-     existing_tokens: { colors: 24, typography: 7, spacing: 6 },
-     patterns: ["Compound components", "Render props"],
-     gaps: ["Missing dark mode", "Inconsistent spacing"]
-   }, null, 2))
-
-   Write(`{session}/artifacts/research/component-inventory.json`, JSON.stringify({
-     components: [
-       { name: "Button", props: ["variant", "size"], states: ["default", "hover", "active", "disabled"] }
-     ]
-   }, null, 2))
-
-   Write(`{session}/artifacts/research/accessibility-audit.json`, JSON.stringify({
-     wcag_level: "AA",
-     contrast_issues: 3,
-     keyboard_nav: "partial",
-     screen_reader: "good"
-   }, null, 2))
-
-   Write(`{session}/artifacts/research/design-intelligence.json`, JSON.stringify({
-     industry: "SaaS/Tech",
-     best_practices: ["8px grid", "4-5 color shades", "Semantic naming"],
-     patterns: ["Button variants", "Form validation states"]
-   }, null, 2))
-   ```
-
-7. **Share discoveries**:
-   ```bash
-   echo '{"ts":"2026-03-08T10:00:00Z","worker":"{id}","type":"tech_stack_detected","data":{"stack":"react","framework":"nextjs","ui_lib":"shadcn"}}' >> {session}/discoveries.ndjson
-   ```
-
-8. **Report result**:
-   ```javascript
-   report_agent_job_result({
-     id: "{id}",
-     status: "completed",
-     findings: "Detected React + shadcn stack. 24 color tokens, 7 typography scales. Missing dark mode variants. WCAG AA baseline with 3 contrast issues.",
-     artifacts_produced: "artifacts/research/design-system-analysis.json;artifacts/research/component-inventory.json;artifacts/research/accessibility-audit.json;artifacts/research/design-intelligence.json",
-     audit_score: "",
-     audit_signal: "",
-     error: ""
-   })
-   ```
-
-**Success Criteria**:
-- All 4 research artifacts produced with valid JSON
-- Tech stack identified
-- Component inventory complete
-- Accessibility baseline documented
-
----
-
-### Designer Role
-
-**Responsibility**: Generate design tokens (W3C Design Tokens Format) and component specifications.
-
-**Input**:
-- `id`: Task ID (e.g., `DESIGN-001`)
-- `title`: Task title
-- `description`: Detailed task description
-- `role`: `designer`
-- `pipeline_mode`: `component`, `system`, or `full-system`
-- `scope`: `tokens`, `components`, or `full`
-- `context_from`: Upstream task IDs (e.g., `RESEARCH-001`)
-- `prev_context`: Previous tasks' findings
-
-**Execution Protocol**:
-
-1. **Read shared discoveries and upstream artifacts**:
-   ```javascript
-   const discoveries = Read(`{session}/discoveries.ndjson`)
-   const research = JSON.parse(Read(`{session}/artifacts/research/design-system-analysis.json`))
-   ```
-
-2. **Generate design tokens** (W3C Design Tokens Format):
-   ```javascript
-   const tokens = {
-     "color": {
-       "primary": {
-         "$type": "color",
-         "$value": "#3B82F6",
-         "$description": "Primary brand color"
-       },
-       "primary-dark": {
-         "$type": "color",
-         "$value": "#1E40AF",
-         "$description": "Primary color for dark mode"
-       }
-     },
-     "typography": {
-       "font-size-base": {
-         "$type": "dimension",
-         "$value": "16px"
-       }
-     },
-     "spacing": {
-       "space-1": {
-         "$type": "dimension",
-         "$value": "4px"
-       }
-     }
-   }
-   Write(`{session}/artifacts/design/design-tokens.json`, JSON.stringify(tokens, null, 2))
-   ```
-
-3. **Create component specifications**:
-   ```markdown
-   # Button Component Specification
-
-   ## Overview
-   Primary interactive element for user actions.
-
-   ## States
-   1. Default: Base appearance
-   2. Hover: Elevated, color shift
-   3. Active: Pressed state
-   4. Disabled: Reduced opacity, no interaction
-   5. Focus: Keyboard focus ring
-
-   ## Variants
-   - Primary: Filled background
-   - Secondary: Outlined
-   - Ghost: Text only
-
-   ## Accessibility
-   - ARIA role: button
-   - Keyboard: Enter/Space to activate
-   - Focus visible: 2px outline
-   - Contrast: WCAG AA minimum
-
-   ## Token Usage
-   - Background: color.primary
-   - Text: color.on-primary
-   - Padding: spacing.space-3 spacing.space-4
-   - Border radius: border.radius-md
-   ```
-
-4. **Ensure light/dark mode support**:
-   - All color tokens have light and dark variants
-   - Semantic tokens reference base tokens
-   - Theme switching mechanism defined
-
-5. **Share discoveries**:
-   ```bash
-   echo '{"ts":"2026-03-08T10:05:00Z","worker":"{id}","type":"token_generated","data":{"category":"color","count":24,"supports_dark_mode":true}}' >> {session}/discoveries.ndjson
-   ```
-
-6. **Report result**:
-   ```javascript
-   report_agent_job_result({
-     id: "{id}",
-     status: "completed",
-     findings: "Generated design token system with 24 color tokens (light+dark), 7 typography scales, 6 spacing values. Created component spec for Button with all 5 states, ARIA roles, and responsive breakpoints.",
-     artifacts_produced: "artifacts/design/design-tokens.json;artifacts/design/component-specs/button.md",
-     audit_score: "",
-     audit_signal: "",
-     error: ""
-   })
-   ```
-
-**Success Criteria**:
-- Design tokens in W3C format
-- All color tokens have light/dark variants
-- Component specs include all 5 states
-- Accessibility requirements documented
-
----
-
-### Reviewer Role
-
-**Responsibility**: 5-dimension quality audit for design artifacts.
-
-**Input**:
-- `id`: Task ID (e.g., `AUDIT-001`)
-- `title`: Task title
-- `description`: Detailed task description
-- `role`: `reviewer`
-- `pipeline_mode`: `component`, `system`, or `full-system`
-- `scope`: `full`
-- `audit_type`: `token-audit`, `component-audit`, or `final-audit`
-- `context_from`: Upstream task IDs (e.g., `DESIGN-001`)
-- `prev_context`: Previous tasks' findings
-
-**Execution Protocol**:
-
-1. **Read design artifacts**:
-   ```javascript
-   const tokens = JSON.parse(Read(`{session}/artifacts/design/design-tokens.json`))
-   const componentSpecs = Glob(`{session}/artifacts/design/component-specs/*.md`)
-   ```
-
-2. **5-Dimension Audit**:
-
-   **Consistency (20%)**:
-   - Token naming follows convention
-   - Semantic tokens reference base tokens correctly
-   - Component specs use consistent terminology
-
-   **Accessibility (25%)**:
-   - Contrast ratios meet WCAG AA (4.5:1 text, 3:1 UI)
-   - All interactive states have focus indicators
-   - ARIA roles and labels defined
-   - Keyboard navigation specified
-
-   **Completeness (20%)**:
-   - All 5 interactive states defined
-   - Light and dark mode for all color tokens
-   - Responsive breakpoints specified
-   - Edge cases documented
-
-   **Quality (15%)**:
-   - Token values follow design principles (8px grid, etc.)
-   - Component specs are clear and actionable
-   - No hardcoded values in specs
-
-   **Industry Compliance (20%)**:
-   - Follows industry best practices (from research)
-   - Meets domain-specific requirements (healthcare: stricter accessibility)
-   - Aligns with design system standards
-
-3. **Calculate weighted score**:
-   ```javascript
-   const score = (consistency * 0.20) + (accessibility * 0.25) + (completeness * 0.20) + (quality * 0.15) + (industry * 0.20)
-   ```
-
-4. **Determine audit signal**:
-   - `audit_passed`: score >= 8.0 AND critical_count === 0
-   - `audit_result`: score >= 6.0 AND critical_count === 0
-   - `fix_required`: score < 6.0 OR critical_count > 0
-
-5. **Write audit report**:
-   ```markdown
-   # Design Audit Report: {id}
-
-   ## Overall Score: {score}/10
-
-   ## Dimension Scores
-   - Consistency: {consistency}/10 (20%)
-   - Accessibility: {accessibility}/10 (25%)
-   - Completeness: {completeness}/10 (20%)
-   - Quality: {quality}/10 (15%)
-   - Industry: {industry}/10 (20%)
-
-   ## Issues Found
-
-   ### Critical (0)
-   (none)
-
-   ### High (1)
-   - Missing dark mode variant for semantic color tokens
-
-   ### Medium (2)
-   - Border radius not defined for pill variant
-   - Focus ring color not specified
-
-   ### Low (3)
-   - Token naming could be more semantic
-   - Component spec missing edge case documentation
-   - Responsive breakpoint values not aligned with 8px grid
-
-   ## Recommendations
-   1. Add dark mode variants for all semantic tokens
-   2. Define border-radius-pill token
-   3. Specify focus ring color (accessibility.focus-ring)
-
-   ## Verdict: {audit_signal}
-   ```
-
-6. **Share discoveries**:
-   ```bash
-   echo '{"ts":"2026-03-08T10:15:00Z","worker":"{id}","type":"issue_found","data":{"file":"design-tokens.json","line":0,"severity":"high","description":"Missing dark mode variant for semantic color tokens"}}' >> {session}/discoveries.ndjson
-   ```
-
-7. **Report result**:
-   ```javascript
-   report_agent_job_result({
-     id: "{id}",
-     status: "completed",
-     findings: "Design audit: 8.4/10. Token naming consistent, all color tokens have light/dark variants, contrast ratios meet WCAG AA. Minor: missing border-radius for pill variant.",
-     artifacts_produced: "artifacts/audit/audit-001.md",
-     audit_score: "8.4",
-     audit_signal: "audit_passed",
-     error: ""
-   })
-   ```
-
-**Success Criteria**:
-- All 5 dimensions scored
-- Audit report written with issue breakdown
-- Audit signal determined (pass/result/fix_required)
-- Score >= 8.0 with 0 critical issues for GC convergence
-
----
-
-### Implementer Role
-
-**Responsibility**: Implement component code from design specs with token consumption and accessibility.
-
-**Input**:
-- `id`: Task ID (e.g., `BUILD-001`)
-- `title`: Task title
-- `description`: Detailed task description
-- `role`: `implementer`
-- `pipeline_mode`: `component`, `system`, or `full-system`
-- `scope`: `full`
-- `context_from`: Upstream task IDs (e.g., `AUDIT-001`)
-- `prev_context`: Previous tasks' findings
-
-**Execution Protocol**:
-
-1. **Read design artifacts and audit feedback**:
-   ```javascript
-   const tokens = JSON.parse(Read(`{session}/artifacts/design/design-tokens.json`))
-   const componentSpec = Read(`{session}/artifacts/design/component-specs/button.md`)
-   const auditReport = Read(`{session}/artifacts/audit/audit-001.md`)
-   ```
-
-2. **Generate CSS custom properties from tokens**:
-   ```css
-   :root {
-     --color-primary: #3B82F6;
-     --color-primary-dark: #1E40AF;
-     --font-size-base: 16px;
-     --space-1: 4px;
-   }
-
-   [data-theme="dark"] {
-     --color-primary: var(--color-primary-dark);
-   }
-   ```
-
-3. **Implement component with all 5 states**:
-   ```tsx
-   import React from 'react'
-
-   interface ButtonProps {
-     variant?: 'primary' | 'secondary' | 'ghost'
-     disabled?: boolean
-     children: React.ReactNode
-   }
-
-   export const Button: React.FC<ButtonProps> = ({ variant = 'primary', disabled, children }) => {
-     return (
-       <button
-         className={`btn btn-${variant}`}
-         disabled={disabled}
-         aria-disabled={disabled}
-       >
-         {children}
-       </button>
-     )
-   }
-   ```
-
-4. **Add ARIA attributes and keyboard navigation**:
-   - `role="button"` (if not native button)
-   - `aria-disabled` for disabled state
-   - `aria-pressed` for toggle buttons
-   - Focus management with `:focus-visible`
-
-5. **Validate no hardcoded values**:
-   - All colors use `var(--token-name)`
-   - All spacing uses token variables
-   - All typography uses token variables
-
-6. **Follow project patterns**:
-   - Match existing component structure
-   - Use same import patterns
-   - Follow naming conventions from research
-
-7. **Share discoveries**:
-   ```bash
-   echo '{"ts":"2026-03-08T10:10:00Z","worker":"{id}","type":"file_modified","data":{"file":"tokens.css","change":"Generated CSS custom properties from design tokens","lines_added":85}}' >> {session}/discoveries.ndjson
-   ```
-
-8. **Report result**:
-   ```javascript
-   report_agent_job_result({
-     id: "{id}",
-     status: "completed",
-     findings: "Implemented Button component with all 5 states, ARIA attributes, keyboard navigation. Generated CSS custom properties from design tokens. No hardcoded values.",
-     artifacts_produced: "artifacts/build/token-files/tokens.css;artifacts/build/component-files/Button.tsx",
-     audit_score: "",
-     audit_signal: "",
-     error: ""
-   })
-   ```
-
-**Success Criteria**:
-- Component code implements all 5 states
-- All values use token variables (no hardcoded)
-- ARIA attributes present
-- Keyboard navigation functional
-- Follows project patterns
-
----
-
-## Generator-Critic Loop (Designer <-> Reviewer)
-
-When reviewer returns `audit_signal: "fix_required"`:
-
-1. Coordinator creates `DESIGN-fix-{round}` task (max 2 rounds)
-2. Designer reads audit feedback, applies targeted fixes
-3. Coordinator creates `AUDIT-recheck-{round}` task
-4. Reviewer re-audits fixed artifacts
-5. Convergence: score >= 8.0 AND critical_count === 0
-
----
-
-## Shared Discovery Board
-
-All roles read/write `{session}/discoveries.ndjson`:
-
-**Discovery Types**:
-- `tech_stack_detected`: Tech stack identified
-- `design_pattern_found`: Existing design pattern
-- `token_generated`: Design token category created
-- `file_modified`: File change recorded
-- `issue_found`: Audit issue discovered
-- `anti_pattern_violation`: Design anti-pattern detected
-- `artifact_produced`: Deliverable created
-
-**Protocol**:
-1. Read discoveries at start
-2. Append discoveries during execution (never modify existing)
-3. Deduplicate by type + data key
-
----
-
-## Error Handling
-
-| Error | Resolution |
-|-------|------------|
-| Upstream artifact not found | Report error, mark failed |
-| Design tokens invalid JSON | Report error, mark failed |
-| Component spec missing required sections | Report error, mark failed |
-| Audit score calculation error | Default to 0, report error |
-| Implementation build fails | Report error, mark failed |
-| CLI tool timeout | Fallback to direct implementation |
-
----
-
-## Output Format
-
-All roles use `report_agent_job_result` with this schema:
-
-```json
-{
-  "id": "{id}",
-  "status": "completed" | "failed",
-  "findings": "Key discoveries (max 500 chars)",
-  "artifacts_produced": "semicolon-separated paths",
-  "audit_score": "0-10 (reviewer only)",
-  "audit_signal": "audit_passed|audit_result|fix_required (reviewer only)",
-  "error": ""
-}
-```

package/.codex/skills/team-uidesign/schemas/tasks-schema.md

@@ -1,187 +0,0 @@
-# Team UI Design -- CSV Schema
-
-## Master CSV: tasks.csv
-
-### Column Definitions
-
-#### Input Columns (Set by Decomposer)
-
-| Column | Type | Required | Description | Example |
-|--------|------|----------|-------------|---------|
-| `id` | string | Yes | Unique task identifier (PREFIX-NNN) | `"RESEARCH-001"` |
-| `title` | string | Yes | Short task title | `"Design system analysis"` |
-| `description` | string | Yes | Detailed task description (self-contained) with PURPOSE/TASK/CONTEXT/EXPECTED/CONSTRAINTS | `"PURPOSE: Analyze existing design system..."` |
-| `role` | enum | Yes | Worker role: `researcher`, `designer`, `reviewer`, `implementer` | `"researcher"` |
-| `pipeline_mode` | enum | Yes | Pipeline mode: `component`, `system`, `full-system` | `"component"` |
-| `scope` | enum | Yes | Task scope: `full`, `tokens`, `components` | `"full"` |
-| `audit_type` | string | No | Audit type: `token-audit`, `component-audit`, `final-audit` (empty for non-reviewer) | `"token-audit"` |
-| `deps` | string | No | Semicolon-separated dependency task IDs | `"RESEARCH-001"` |
-| `context_from` | string | No | Semicolon-separated task IDs for context | `"RESEARCH-001"` |
-| `exec_mode` | enum | Yes | Execution mechanism: `csv-wave` or `interactive` | `"csv-wave"` |
-
-#### Computed Columns (Set by Wave Engine)
-
-| Column | Type | Description | Example |
-|--------|------|-------------|---------|
-| `wave` | integer | Wave number (1-based, from topological sort) | `2` |
-| `prev_context` | string | Aggregated findings from context_from tasks (per-wave CSV only) | `"[RESEARCH-001] Detected React + shadcn stack..."` |
-
-#### Output Columns (Set by Agent)
-
-| Column | Type | Description | Example |
-|--------|------|-------------|---------|
-| `status` | enum | `pending` -> `completed` / `failed` / `skipped` | `"completed"` |
-| `findings` | string | Key discoveries (max 500 chars) | `"Generated 24 color tokens with dark mode..."` |
-| `artifacts_produced` | string | Semicolon-separated paths of produced artifacts | `"artifacts/research/design-system-analysis.json;artifacts/research/component-inventory.json"` |
-| `audit_score` | string | Audit weighted score 0-10 (empty for non-reviewer tasks) | `"8.5"` |
-| `audit_signal` | enum | `audit_passed`, `audit_result`, `fix_required` (empty for non-reviewer) | `"audit_passed"` |
-| `error` | string | Error message if failed | `""` |
-
----
-
-### exec_mode Values
-
-| Value | Mechanism | Description |
-|-------|-----------|-------------|
-| `csv-wave` | `spawn_agents_on_csv` | One-shot batch execution within wave |
-| `interactive` | `spawn_agent`/`wait`/`send_input`/`close_agent` | Multi-round individual execution |
-
-Interactive tasks appear in master CSV for dependency tracking but are NOT included in wave-{N}.csv files.
-
----
-
-### Role Prefixes
-
-| Role | Prefix | Responsibility Type |
-|------|--------|---------------------|
-| researcher | RESEARCH | read-only (design system analysis + intelligence retrieval) |
-| designer | DESIGN | generation (design tokens + component specs, W3C format) |
-| reviewer | AUDIT | validation (5-dimension quality audit, GC critic) |
-| implementer | BUILD | code-gen (CSS custom properties + components + accessibility) |
-
----
-
-### Example Data
-
-```csv
-id,title,description,role,pipeline_mode,scope,audit_type,deps,context_from,exec_mode,wave,status,findings,artifacts_produced,audit_score,audit_signal,error
-"RESEARCH-001","Design system analysis","PURPOSE: Analyze existing design system, build component inventory, assess accessibility baseline | Success: 4 research artifacts produced with valid data\nTASK:\n- Analyze existing design tokens and styling patterns\n- Build component inventory with props and states\n- Assess accessibility baseline\n- Retrieve design intelligence via ui-ux-pro-max\nCONTEXT:\n- Session: .workflow/.csv-wave/uds-saas-dashboard-20260308\n- Industry: SaaS/Tech\nEXPECTED: artifacts/research/*.json | All 4 research files with valid JSON\nCONSTRAINTS: Read-only analysis","researcher","component","full","","","","csv-wave","1","pending","","","","",""
-"DESIGN-001","Design tokens + component spec","PURPOSE: Define design tokens (W3C format) and component specification | Success: Design tokens + component spec with all states defined\nTASK:\n- Define complete token system (color, typography, spacing, shadow, border, breakpoint)\n- Create component specification with all 5 interactive states\n- Ensure accessibility spec\nCONTEXT:\n- Session: .workflow/.csv-wave/uds-saas-dashboard-20260308\n- Upstream: research/*.json\nEXPECTED: artifacts/design/design-tokens.json + component-specs/*.md\nCONSTRAINTS: Follow W3C Design Tokens Format | Light/dark for all color tokens","designer","component","tokens","","RESEARCH-001","RESEARCH-001","csv-wave","2","pending","","","","",""
-"AUDIT-001","Design audit","PURPOSE: 5-dimension quality audit for consistency, accessibility, completeness, quality, industry compliance | Success: Audit score >= 8 with 0 critical issues\nTASK:\n- Score 5 dimensions (consistency 20%, accessibility 25%, completeness 20%, quality 15%, industry 20%)\n- Check token naming, theme completeness, contrast ratios\n- Verify component states and ARIA spec\nCONTEXT:\n- Session: .workflow/.csv-wave/uds-saas-dashboard-20260308\n- Upstream: design/design-tokens.json, design/component-specs/*.md\nEXPECTED: artifacts/audit/audit-001.md\nCONSTRAINTS: Read-only analysis | GC convergence: score >= 8 and 0 critical","reviewer","component","full","token-audit","DESIGN-001","DESIGN-001","csv-wave","3","pending","","","","",""
-"BUILD-001","Component implementation","PURPOSE: Implement component code from design specs | Success: Production code with token consumption and accessibility\nTASK:\n- Generate CSS custom properties from design tokens\n- Implement component with all 5 states\n- Add ARIA attributes and keyboard navigation\n- Validate no hardcoded values\nCONTEXT:\n- Session: .workflow/.csv-wave/uds-saas-dashboard-20260308\n- Upstream: design/design-tokens.json, design/component-specs/*.md, audit/audit-001.md\nEXPECTED: artifacts/build/**/*\nCONSTRAINTS: Use var(--token-name) only | Follow project patterns","implementer","component","full","","AUDIT-001","AUDIT-001","csv-wave","4","pending","","","","",""
-```
-
----
-
-### Column Lifecycle
-
-```
-Decomposer (Phase 1)     Wave Engine (Phase 2)    Agent (Execution)
----------------------    --------------------     -----------------
-id          ---------->  id          ---------->  id
-title       ---------->  title       ---------->  (reads)
-description ---------->  description ---------->  (reads)
-role        ---------->  role        ---------->  (reads)
-pipeline_mode --------->  pipeline_mode --------->  (reads)
-scope       ---------->  scope       ---------->  (reads)
-audit_type  ---------->  audit_type  ---------->  (reads)
-deps        ---------->  deps        ---------->  (reads)
-context_from---------->  context_from---------->  (reads)
-exec_mode   ---------->  exec_mode   ---------->  (reads)
-                         wave         ---------->  (reads)
-                         prev_context ---------->  (reads)
-                                                   status
-                                                   findings
-                                                   artifacts_produced
-                                                   audit_score
-                                                   audit_signal
-                                                   error
-```
-
----
-
-## Output Schema (JSON)
-
-Agent output via `report_agent_job_result` (csv-wave tasks):
-
-```json
-{
-  "id": "DESIGN-001",
-  "status": "completed",
-  "findings": "Generated design token system with 24 color tokens (light+dark), 7 typography scales, 6 spacing values. Created component spec for Button with all 5 states, ARIA roles, and responsive breakpoints.",
-  "artifacts_produced": "artifacts/design/design-tokens.json;artifacts/design/component-specs/button.md",
-  "audit_score": "",
-  "audit_signal": "",
-  "error": ""
-}
-```
-
-Reviewer agent output example:
-
-```json
-{
-  "id": "AUDIT-001",
-  "status": "completed",
-  "findings": "Design audit: 8.4/10. Token naming consistent, all color tokens have light/dark variants, contrast ratios meet WCAG AA. Minor: missing border-radius for pill variant.",
-  "artifacts_produced": "artifacts/audit/audit-001.md",
-  "audit_score": "8.4",
-  "audit_signal": "audit_passed",
-  "error": ""
-}
-```
-
-Interactive tasks output via structured text or JSON written to `interactive/{id}-result.json`.
-
----
-
-## Discovery Types
-
-| Type | Dedup Key | Data Schema | Description |
-|------|-----------|-------------|-------------|
-| `tech_stack_detected` | `data.stack` | `{stack, framework, ui_lib}` | Tech stack identified |
-| `design_pattern_found` | `data.pattern_name+data.location` | `{pattern_name, location, description}` | Existing design pattern |
-| `token_generated` | `data.category` | `{category, count, supports_dark_mode}` | Design token category created |
-| `file_modified` | `data.file` | `{file, change, lines_added}` | File change recorded |
-| `issue_found` | `data.file+data.line` | `{file, line, severity, description}` | Audit issue discovered |
-| `anti_pattern_violation` | `data.pattern+data.file` | `{pattern, file, line, description}` | Design anti-pattern detected |
-| `artifact_produced` | `data.path` | `{name, path, producer, type}` | Deliverable created |
-
-### Discovery NDJSON Format
-
-```jsonl
-{"ts":"2026-03-08T10:00:00Z","worker":"RESEARCH-001","type":"tech_stack_detected","data":{"stack":"react","framework":"nextjs","ui_lib":"shadcn"}}
-{"ts":"2026-03-08T10:05:00Z","worker":"DESIGN-001","type":"token_generated","data":{"category":"color","count":24,"supports_dark_mode":true}}
-{"ts":"2026-03-08T10:10:00Z","worker":"BUILD-001","type":"file_modified","data":{"file":"tokens.css","change":"Generated CSS custom properties from design tokens","lines_added":85}}
-{"ts":"2026-03-08T10:15:00Z","worker":"AUDIT-001","type":"issue_found","data":{"file":"design-tokens.json","line":0,"severity":"high","description":"Missing dark mode variant for semantic color tokens"}}
-```
-
-> Both csv-wave and interactive agents read/write the same discoveries.ndjson file.
-
----
-
-## Cross-Mechanism Context Flow
-
-| Source | Target | Mechanism |
-|--------|--------|-----------|
-| CSV task findings | Interactive task | Injected via spawn message or send_input |
-| Interactive task result | CSV task prev_context | Read from interactive/{id}-result.json |
-| Any agent discovery | Any agent | Shared via discoveries.ndjson |
-
----
-
-## Validation Rules
-
-| Rule | Check | Error |
-|------|-------|-------|
-| Unique IDs | No duplicate `id` values | "Duplicate task ID: {id}" |
-| Valid deps | All dep IDs exist in tasks | "Unknown dependency: {dep_id}" |
-| No self-deps | Task cannot depend on itself | "Self-dependency: {id}" |
-| No circular deps | Topological sort completes | "Circular dependency detected involving: {ids}" |
-| context_from valid | All context IDs exist and in earlier waves | "Invalid context_from: {id}" |
-| exec_mode valid | Value is `csv-wave` or `interactive` | "Invalid exec_mode: {value}" |
-| Description non-empty | Every task has description | "Empty description for task: {id}" |
-| Status enum | status in {pending, completed, failed, skipped} | "Invalid status: {status}" |
-| Role valid | role in {researcher, designer, reviewer, implementer} | "Invalid role: {role}" |
-| Pipeline mode valid | pipeline_mode in {component, system, full-system} | "Invalid pipeline_mode: {mode}" |
-| Audit signal valid | audit_signal in {audit_passed, audit_result, fix_required, ""} | "Invalid audit_signal: {signal}" |
-| Cross-mechanism deps | Interactive to CSV deps resolve correctly | "Cross-mechanism dependency unresolvable: {id}" |