Skip to content

feat(protocol): design-baseline Phase 2 — multi-persona sub-agent design review#6

Open
d-wwei wants to merge 2 commits into
masterfrom
feat/design-baseline-phase2
Open

feat(protocol): design-baseline Phase 2 — multi-persona sub-agent design review#6
d-wwei wants to merge 2 commits into
masterfrom
feat/design-baseline-phase2

Conversation

@d-wwei

@d-wwei d-wwei commented Apr 15, 2026

Copy link
Copy Markdown
Owner

Summary

  • Implement Phase 2 of design-baseline gate: 5 expert persona sub-agents (UX Designer, Accessibility Specialist, Brand Guardian, Performance Analyst, End User) for independent parallel design review
  • Conflict detection (action + severity conflicts) with verdict aggregation via confidence voting
  • Phase 2 subsumes tasteful-frontend in Review layer; TF retained in Execute for design spec generation
  • Includes quick compound for previous iteration (memory write enforcement)

Changed Files

  • skill/gates/design-baseline.md — Core Phase 2 implementation (+370 lines)
  • skill/bindings.yaml — Remove tasteful-frontend from review layers
  • skill/stages/review.md — Update Skill Dispatch description
  • skill/aliases/design-review.md — Update alias to Phase 1 + Phase 2 flow
  • docs/ — Requirements, plan, review, solution doc, roadmap snapshot

Test plan

  • Cross-file consistency verified by sub-agent (all 5 files consistent)
  • Multi-persona review: P0 aggregation precedence fixed, CONCERN classified, min 3 personas guardrail added
  • No stale tasteful-frontend references in review context
  • Pre-existing test failures (timeouts) unrelated to documentation changes
  • CI triggered on PR creation (push-to-master and PR triggers)

🤖 Generated with Claude Code

d-wwei and others added 2 commits April 14, 2026 22:23
Reviewed 13-section spec for Plan Agent orchestration architecture.
Fixed 3 blocking issues (P0) and 4 important issues (P1):

- P0-1: Rename orchestration daemon CLI to `apex orch` (avoid collision
  with existing `apex daemon` for Dashboard launchd)
- P0-2: Define spawnUnblockedTasks — daemon spawns via `apex worker spawn`
  CLI, reads meta.json for WindowHandle tracking
- P0-3: Clarify Section 6.2 (agentStartCommand) is in-scope, narrow
  Section 13 未覆盖 list accordingly
- P1-1: Replace broken autoIntegrate shell script with temporary worktree
- P1-2: Add autoMerge definition (git merge --ff after integrate passes)
- P1-3: Fix lock file TOCTOU with atomic writeFileSync({flag:'wx'})
- P1-4: Specify daemon as M&C exit condition detector

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ign review

Implement Phase 2 of the design-baseline gate: 5 expert persona sub-agents
(UX Designer, Accessibility Specialist, Brand Guardian, Performance Analyst,
End User) dispatched in parallel for independent design review.

Key additions:
- Persona prompt templates with evaluation questions and anti-rubber-stamping rules
- Conflict detection (action conflicts + severity conflicts) with surfacing protocol
- Verdict aggregation via confidence voting with explicit precedence (BLOCK > ESCALATE > PASS_WITH_NOTE > PASS)
- CONCERN verdict classification, minimum 3-persona guardrail, all-disabled guard clause
- Output transformation mapping persona findings to canonical review format
- Artifact integration section for per-persona findings in review doc

Architecture change: Phase 2 subsumes tasteful-frontend in Review layer.
tasteful-frontend retained in Execute stage for design spec generation.

Also includes: quick compound for previous iteration (compound memory write enforcement).

Requirements: docs/brainstorms/design-baseline-phase2-requirements.md
Plan: docs/plans/design-baseline-phase2-plan.md
Review: docs/reviews/design-baseline-phase2-review.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant