@dv.nghiem/flowdeck 0.3.4 → 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/README.md +154 -3
  2. package/dist/agents/coder.d.ts +3 -1
  3. package/dist/agents/coder.d.ts.map +1 -1
  4. package/dist/agents/design.d.ts +3 -0
  5. package/dist/agents/design.d.ts.map +1 -0
  6. package/dist/agents/index.d.ts +4 -3
  7. package/dist/agents/index.d.ts.map +1 -1
  8. package/dist/agents/orchestrator.d.ts.map +1 -1
  9. package/dist/agents/reviewer.d.ts.map +1 -1
  10. package/dist/agents/specialist.d.ts +0 -1
  11. package/dist/agents/specialist.d.ts.map +1 -1
  12. package/dist/config/index.d.ts +1 -1
  13. package/dist/config/index.d.ts.map +1 -1
  14. package/dist/config/loader.d.ts +8 -0
  15. package/dist/config/loader.d.ts.map +1 -1
  16. package/dist/config/schema.d.ts +55 -2
  17. package/dist/config/schema.d.ts.map +1 -1
  18. package/dist/dashboard/server.mjs +24 -1
  19. package/dist/dashboard/types.d.ts +72 -0
  20. package/dist/dashboard/types.d.ts.map +1 -1
  21. package/dist/hooks/guard-rails.d.ts.map +1 -1
  22. package/dist/hooks/memory-hook.d.ts +7 -0
  23. package/dist/hooks/memory-hook.d.ts.map +1 -1
  24. package/dist/hooks/orchestrator-guard-hook.d.ts.map +1 -1
  25. package/dist/hooks/tool-guard.d.ts.map +1 -1
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +749 -503
  28. package/dist/services/agent-contract-registry.d.ts +32 -0
  29. package/dist/services/agent-contract-registry.d.ts.map +1 -0
  30. package/dist/services/agent-performance.d.ts +1 -1
  31. package/dist/services/agent-performance.d.ts.map +1 -1
  32. package/dist/services/agent-trace-graph.d.ts +94 -0
  33. package/dist/services/agent-trace-graph.d.ts.map +1 -0
  34. package/dist/services/agent-validator.d.ts +56 -0
  35. package/dist/services/agent-validator.d.ts.map +1 -0
  36. package/dist/services/deadlock-detector.d.ts +34 -0
  37. package/dist/services/deadlock-detector.d.ts.map +1 -0
  38. package/dist/services/delegation-budget.d.ts +54 -0
  39. package/dist/services/delegation-budget.d.ts.map +1 -0
  40. package/dist/services/governance.test.d.ts +11 -0
  41. package/dist/services/governance.test.d.ts.map +1 -0
  42. package/dist/services/index.d.ts +6 -1
  43. package/dist/services/index.d.ts.map +1 -1
  44. package/dist/services/memory-store.d.ts +34 -1
  45. package/dist/services/memory-store.d.ts.map +1 -1
  46. package/dist/services/memory-store.test.d.ts +2 -0
  47. package/dist/services/memory-store.test.d.ts.map +1 -0
  48. package/dist/services/telemetry.d.ts +1 -1
  49. package/dist/services/telemetry.d.ts.map +1 -1
  50. package/dist/services/workflow-scorecard.d.ts +76 -0
  51. package/dist/services/workflow-scorecard.d.ts.map +1 -0
  52. package/dist/tools/delegate.d.ts.map +1 -1
  53. package/dist/tools/dispatch-routing.d.ts +4 -1
  54. package/dist/tools/dispatch-routing.d.ts.map +1 -1
  55. package/dist/tools/dispatch-routing.test.d.ts +2 -0
  56. package/dist/tools/dispatch-routing.test.d.ts.map +1 -0
  57. package/dist/tools/memory-search.d.ts.map +1 -1
  58. package/dist/tools/memory-status.d.ts.map +1 -1
  59. package/dist/tools/planning-state-lib.d.ts +8 -0
  60. package/dist/tools/planning-state-lib.d.ts.map +1 -1
  61. package/dist/tools/planning-state.d.ts.map +1 -1
  62. package/dist/tools/run-pipeline.d.ts.map +1 -1
  63. package/docs/agents.md +104 -74
  64. package/docs/best-practices.md +1 -1
  65. package/docs/commands/fd-ask.md +2 -2
  66. package/docs/commands/fd-fix-bug.md +2 -2
  67. package/docs/commands/fd-new-feature.md +2 -2
  68. package/docs/commands/fd-quick.md +3 -1
  69. package/docs/commands.md +37 -7
  70. package/docs/configuration.md +76 -46
  71. package/docs/design-first-workflow.md +94 -0
  72. package/docs/feature-integration-architecture.md +3 -31
  73. package/docs/index.md +5 -2
  74. package/docs/intelligence.md +92 -1
  75. package/docs/multi-repo.md +1 -1
  76. package/docs/rules.md +1 -1
  77. package/docs/skills.md +24 -15
  78. package/docs/workflows.md +11 -6
  79. package/package.json +1 -1
  80. package/src/commands/fd-ask.md +1 -0
  81. package/src/commands/fd-design.md +64 -0
  82. package/src/commands/fd-discuss.md +2 -0
  83. package/src/commands/fd-execute.md +7 -3
  84. package/src/commands/fd-fix-bug.md +2 -2
  85. package/src/commands/fd-multi-repo.md +3 -3
  86. package/src/commands/fd-plan.md +2 -0
  87. package/src/commands/fd-quick.md +4 -1
  88. package/src/commands/fd-verify.md +6 -0
  89. package/src/rules/common/agent-orchestration.md +6 -6
  90. package/src/skills/app-shell-design/SKILL.md +31 -0
  91. package/src/skills/dashboard-design/SKILL.md +32 -0
  92. package/src/skills/decision-trace/SKILL.md +1 -1
  93. package/src/skills/design-audit/SKILL.md +37 -0
  94. package/src/skills/design-system-definition/SKILL.md +33 -0
  95. package/src/skills/frontend-handoff/SKILL.md +31 -0
  96. package/src/skills/landing-page-design/SKILL.md +32 -0
  97. package/src/skills/multi-repo/SKILL.md +3 -3
  98. package/src/skills/plan-task/SKILL.md +2 -2
  99. package/src/skills/responsive-review/SKILL.md +31 -0
  100. package/src/skills/ui-ux-planning/SKILL.md +32 -0
  101. package/src/skills/wireframe-planning/SKILL.md +30 -0
  102. package/dist/services/model-router.d.ts +0 -35
  103. package/dist/services/model-router.d.ts.map +0 -1
@@ -0,0 +1,64 @@
1
+ ---
2
+ description: Design-first workflow for UI-heavy tasks — draft design artifacts, review implementation fidelity, or define design system rules
3
+ argument-hint: [--mode=draft|review|system] [task-description] [--override]
4
+ ---
5
+
6
+ # Design
7
+
8
+ Run design-first workflow stages for user-facing tasks.
9
+
10
+ **Input:** $ARGUMENTS — supports `--mode=draft|review|system` (default `draft`)
11
+
12
+ ## Mode: draft
13
+
14
+ Use when creating/updating UI before implementation.
15
+
16
+ ### Required Stages
17
+
18
+ 1. discovery
19
+ 2. UX planning
20
+ 3. wireframe/layout planning
21
+ 4. visual system definition
22
+ 5. design approval
23
+ 6. implementation handoff
24
+
25
+ ### Process
26
+
27
+ 1. Classify task as UI-heavy (landing page, dashboard, admin panel, app screen, website/app UX)
28
+ 2. Delegate to `@design` agent for structured artifacts
29
+ 3. Persist outputs in planning state under `design_artifact`
30
+ 4. Mark:
31
+ - `requires_design_first: true`
32
+ - `design_stage: handoff_complete`
33
+ - `design_approved: true` only when approval criteria are met
34
+ 5. Record any bypass with explicit `design_override_reason`
35
+
36
+ ## Mode: review
37
+
38
+ Use to review implemented UI against approved design artifact.
39
+
40
+ ### Process
41
+
42
+ 1. Load approved design artifact and changed UI files
43
+ 2. Delegate to `@design` with `design-audit` + `responsive-review`
44
+ 3. Report:
45
+ - design mismatches
46
+ - hierarchy/spacing issues
47
+ - CTA flow weaknesses
48
+ - responsive/accessibility concerns
49
+ - missing empty/error/loading/success states
50
+
51
+ ## Mode: system
52
+
53
+ Use to generate/update design tokens and component behavior rules.
54
+
55
+ ### Process
56
+
57
+ 1. Delegate to `@design` with `design-system-definition`
58
+ 2. Generate/update token guidance and component rules
59
+ 3. Save summary in planning state `design_artifact.design_tokens_guidance`
60
+
61
+ ## Enforcement Notes
62
+
63
+ - UI-heavy tasks must complete design approval before `/fd-execute`, unless `--override` is explicitly provided and logged.
64
+ - Backend-only/infrastructure-only tasks skip this command.
@@ -50,6 +50,7 @@ Structure the discussion:
50
50
  2. **Constraints** — Technical constraints, deadlines, dependencies?
51
51
  3. **Acceptance criteria** — How will we know it's done?
52
52
  4. **Risks** — What could go wrong? Any known issues?
53
+ 5. **UI classification** — Is this task user-facing and UI-heavy (website/app/dashboard/admin/landing/onboarding)?
53
54
 
54
55
  Ask questions one at a time. Wait for answers before proceeding.
55
56
 
@@ -89,6 +90,7 @@ D-02: [Topic] — [Decision] ([Rationale])
89
90
  ## Completion
90
91
 
91
92
  Report: decisions captured, file path, and suggest running `/fd-plan`.
93
+ If UI-heavy, also suggest running `/fd-design --mode=draft` before `/fd-execute`.
92
94
 
93
95
  ## Error Handling
94
96
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Execute feature implementation from PLAN.md — TDD pipeline with coder, tester, reviewer, and STATE.md update
2
+ description: Execute feature implementation from PLAN.md — TDD pipeline with backend-coder, frontend-coder, devops, tester, reviewer, and STATE.md update
3
3
  argument-hint: [--phase=N] [--override]
4
4
  ---
5
5
 
@@ -35,6 +35,10 @@ Verify prerequisites:
35
35
  - `.codebase/` directory exists
36
36
  - `STATE.md` has `plan_confirmed: true`
37
37
  - `PLAN.md` exists in current phase directory
38
+ - If `requires_design_first: true`, require:
39
+ - `design_stage: handoff_complete`
40
+ - `design_approved: true`
41
+ - OR explicit `--override` with logged reason
38
42
 
39
43
  Initialize TDD state:
40
44
  ```yaml
@@ -79,7 +83,7 @@ Run failing tests:
79
83
 
80
84
  ### Step 7: Implement Minimum (GREEN)
81
85
 
82
- Spawn `@coder` to implement:
86
+ Spawn the implementation agent selected by scope (`@backend-coder`, `@frontend-coder`, or `@devops`) to implement:
83
87
  - **Minimum code** to make failing tests pass
84
88
  - No speculative features
85
89
  - No over-engineering
@@ -160,7 +164,7 @@ User can override with `/fd-execute --override`:
160
164
 
161
165
  D-03: Fail fast with clear error
162
166
  - If guard check fails: abort with clear error and remediation
163
- - If @coder fails: report failure, offer retry or skip
167
+ - If implementation agent fails: report failure, offer retry or skip
164
168
  - If @reviewer finds critical issues: return to Step 7 for fixes
165
169
  - No partial state saved on error
166
170
 
@@ -66,7 +66,7 @@ Confirm test fails. If it passes, the bug may already be fixed or the test is wr
66
66
 
67
67
  ### Step 7: GREEN — Implement Fix
68
68
 
69
- - **@coder**: Implement the minimum code change that makes the regression test pass
69
+ - **Implementation agent (`@backend-coder` / `@frontend-coder` / `@devops`)**: Implement the minimum code change that makes the regression test pass
70
70
  - Do not refactor yet
71
71
 
72
72
  **GUARD: Do NOT proceed if test does not pass GREEN.**
@@ -101,7 +101,7 @@ Append entry to `.codebase/FAILURES.json`:
101
101
 
102
102
  ## Error Handling
103
103
 
104
- - **GUARD VIOLATION**: If coder attempts to skip RED or GREEN phase, block and return to correct phase
104
+ - **GUARD VIOLATION**: If implementation agent attempts to skip RED or GREEN phase, block and return to correct phase
105
105
  - **Override mechanism**: User can override with `/fd-fix-bug --override` but every override is logged in `override_log`
106
106
  - If root cause unclear: spawn `@debug-specialist` for deeper analysis
107
107
  - If fix breaks tests: revert, reassess root cause, never suppress error
@@ -101,13 +101,13 @@ If any circular dependency is detected, the flow stops and reports the cycle. Ci
101
101
 
102
102
  Changes execute in dependency order. For each repo:
103
103
 
104
- 1. `@coder` implements the changes in that repo
104
+ 1. Implementation agent (`@backend-coder`, `@frontend-coder`, or `@devops`) implements the changes in that repo based on scope
105
105
  2. `@tester` writes and runs tests for that repo's changes
106
106
  3. No downstream repo starts until the upstream repo's changes pass tests
107
107
 
108
- For non-breaking changes, `@coder` and `@tester` for a given repo run in parallel. For breaking changes, `@tester` must verify the upstream before `@coder` starts on any downstream.
108
+ For non-breaking changes, implementation agent and `@tester` for a given repo run in parallel. For breaking changes, `@tester` must verify the upstream before downstream implementation starts.
109
109
 
110
- If a repo's `@coder` or `@tester` fails, that repo and all downstream repos in the dependency chain are paused. Upstream repos that completed are not rolled back — they remain deployed. The flow resumes once the failing repo is fixed.
110
+ If a repo's implementation agent or `@tester` fails, that repo and all downstream repos in the dependency chain are paused. Upstream repos that completed are not rolled back — they remain deployed. The flow resumes once the failing repo is fixed.
111
111
 
112
112
  ### Step 5: Verify Integration
113
113
 
@@ -82,6 +82,8 @@ Update STATE.md:
82
82
  - Set plan_file to path of saved PLAN.md
83
83
  - Set plan_confirmed: true
84
84
  - Update last_action to "Plan confirmed"
85
+ - If task is UI-heavy, set `requires_design_first: true` and `design_stage: pending`
86
+ - Suggest running `/fd-design --mode=draft` immediately after plan confirmation
85
87
 
86
88
  ## D-06 Compliance
87
89
 
@@ -21,10 +21,13 @@ Parse `$ARGUMENTS` to determine:
21
21
 
22
22
  | Task Type | Signal Keywords | Agent |
23
23
  |-----------|-----------------|-------|
24
- | Write or edit code | implement, add, create, fix, refactor, update | `@coder` |
24
+ | Backend code implementation | api, server, service, database, migration, endpoint, repository | `@backend-coder` |
25
+ | Frontend code implementation | ui, frontend, component, page, css, style, react, screen | `@frontend-coder` |
26
+ | DevOps and infra implementation | ci, cd, deploy, pipeline, workflow, docker, kubernetes, terraform | `@devops` |
25
27
  | Explore and understand | trace, map, find, explore, understand, what does | `@code-explorer` |
26
28
  | Review code quality | review, check, audit, analyze | `@reviewer` |
27
29
  | Security review | security, auth, vulnerability, injection, OWASP | `@security-auditor` |
30
+ | UI design-first planning | landing page, dashboard, admin panel, onboarding UX, app screen, wireframe, design system | `@design` |
28
31
  | Design or architecture | design, architect, schema, API, structure | `@architect` |
29
32
  | Write tests | test, coverage, regression, TDD | `@tester` |
30
33
  | Documentation | docs, README, document, write | `@writer` |
@@ -42,6 +42,12 @@ Review all changed files:
42
42
  - Quality: critical bugs, missing error handling, TDD discipline
43
43
  - Conventions: naming, patterns, import style
44
44
  - Test coverage >= 80% for changed files — flag as HIGH if below
45
+ - If task is UI-heavy, include design fidelity review against approved design artifact
46
+
47
+ **Check B2: UI Design Review (@design) — UI-heavy only**
48
+ - Compare implemented UI to approved design artifact
49
+ - Report hierarchy, spacing, CTA flow, responsiveness, accessibility, and missing state coverage gaps
50
+ - Fail verification when severe design fidelity mismatch exists
45
51
 
46
52
  **Check C: Security Scan (@security-auditor)**
47
53
  - No hardcoded secrets
@@ -10,14 +10,14 @@ FlowDeck provides 23 specialist agents. Each has a specific role. Using the righ
10
10
  | `@build-error-resolver` | Fix build failures and type errors | Immediately when build fails |
11
11
  | `@build-resolver` | Diagnose and fix build/compile failures | When build breaks and cause is unclear |
12
12
  | `@code-explorer` | Map unfamiliar codebase structure | Before modifying unfamiliar code |
13
- | `@coder` | Implement features and fixes | All code implementation |
13
+ | `@backend-coder` | Implement features and fixes | All code implementation |
14
14
  | `@debug-specialist` | Root cause analysis for bugs | When a bug needs deep investigation |
15
15
  | `@discusser` | Extract requirements via Q&A | Starting a new feature or phase |
16
16
  | `@doc-updater` | Update docs after code changes | After implementation completes |
17
17
  | `@plan-checker` | Review PLAN.md before execution | Before executing any plan |
18
18
  | `@mapper` | Map codebase to .codebase/ docs | Running /fd-map-codebase |
19
19
  | `@orchestrator` | Coordinate multi-agent execution | Managing a full feature delivery |
20
- | `@parallel-coordinator` | Run parallel agent workstreams | When tasks can run simultaneously |
20
+ | `@task-splitter` | Decompose parallel workstreams | When tasks can run simultaneously |
21
21
  | `@performance-optimizer` | Profile and fix performance issues | When app is slow or before release |
22
22
  | `@planner` | Create detailed implementation plans | Any multi-file feature |
23
23
  | `@refactor-guide` | Safe code restructuring | Reducing technical debt |
@@ -34,7 +34,7 @@ These situations should trigger agent use automatically:
34
34
 
35
35
  | Situation | Agent |
36
36
  |-----------|-------|
37
- | Complex feature spanning 3+ files | `@planner` first, then `@coder` |
37
+ | Complex feature spanning 3+ files | `@planner` first, then `@backend-coder` |
38
38
  | Code was just written | `@reviewer` |
39
39
  | Build fails | `@build-error-resolver` |
40
40
  | Bug reported | `@debug-specialist` |
@@ -50,11 +50,11 @@ Independent agents can run simultaneously. Examples:
50
50
  ```
51
51
  Wave 1 (parallel):
52
52
  @researcher — research the library API
53
- @coder — implement the model and types
53
+ @backend-coder — implement the model and types
54
54
  @tester — write test cases
55
55
 
56
56
  Wave 2 (after Wave 1):
57
- @coder — implement service using Wave 1 research
57
+ @backend-coder — implement service using Wave 1 research
58
58
  @reviewer — review Wave 1 implementation
59
59
  ```
60
60
 
@@ -78,7 +78,7 @@ discuss → plan → execute → review
78
78
  |-------|-------|---------|
79
79
  | discuss | `@discusser` | `/fd-discuss` |
80
80
  | plan | `@planner` → `@plan-checker` | `/fd-plan` |
81
- | execute | `@orchestrator` → `@coder`, `@tester`, etc. | `/fd-new-feature` |
81
+ | execute | `@orchestrator` → `@backend-coder`, `@tester`, etc. | `/fd-new-feature` |
82
82
  | review | `@reviewer` + `@security-auditor` | `/fd-review-code` |
83
83
 
84
84
  Do not skip phases. The orchestrator enforces phase gating automatically.
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: app-shell-design
3
+ description: Define app shell structure, navigation model, and reusable surface patterns for web/mobile apps
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # App Shell Design Skill
8
+
9
+ Standardizes navigation and page frame behavior across app surfaces.
10
+
11
+ ## When to Activate
12
+
13
+ - New app or major app redesign
14
+ - Task includes navigation, shell, or global layout work
15
+
16
+ ## Required Inputs
17
+
18
+ - Core product flows
19
+ - Platform targets (web/mobile)
20
+
21
+ ## Output Format
22
+
23
+ - shell_structure
24
+ - navigation_model
25
+ - route_grouping
26
+ - persistent_ui_regions
27
+ - global_state_requirements
28
+
29
+ ## Example
30
+
31
+ Use for: "Design app shell and navigation for a kanban productivity app."
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: dashboard-design
3
+ description: Design dashboard information hierarchy, data density, and interaction patterns for analytics-heavy surfaces
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Dashboard Design Skill
8
+
9
+ Optimizes dashboard UX for scanability and actionability.
10
+
11
+ ## When to Activate
12
+
13
+ - Task is dashboard or analytics UI
14
+ - Dense data requires hierarchy decisions
15
+
16
+ ## Required Inputs
17
+
18
+ - User roles
19
+ - Primary dashboard decisions/actions
20
+ - Key metrics
21
+
22
+ ## Output Format
23
+
24
+ - dashboard_personas
25
+ - information_hierarchy
26
+ - section_structure
27
+ - component_list
28
+ - alert_and_empty_states
29
+
30
+ ## Example
31
+
32
+ Use for: "Redesign SaaS operations dashboard for faster anomaly detection."
@@ -42,7 +42,7 @@ Use the `decision-trace` tool:
42
42
  "Move validation to edge (rejected: adds latency)"
43
43
  ],
44
44
  "risk_level": "medium",
45
- "agent": "coder"
45
+ "agent": "backend-coder"
46
46
  }
47
47
  }
48
48
  ```
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: design-audit
3
+ description: Audit implemented UI against approved design artifacts for hierarchy, consistency, responsiveness, and accessibility fidelity
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Design Audit Skill
8
+
9
+ Use this skill to evaluate UI output against an approved design spec before final verification.
10
+
11
+ ## When to Activate
12
+
13
+ - Post-implementation review for UI-heavy tasks
14
+ - `/fd-design --mode=review`
15
+ - Any feature where design fidelity is a release criterion
16
+
17
+ ## Required Inputs
18
+
19
+ - Approved design artifact
20
+ - Implemented UI scope (screens/pages/components)
21
+ - Review rubric (if available)
22
+
23
+ ## Output Format
24
+
25
+ - mismatches
26
+ - hierarchy_issues
27
+ - spacing_issues
28
+ - cta_flow_issues
29
+ - responsiveness_issues
30
+ - accessibility_issues
31
+ - component_consistency_issues
32
+ - missing_state_coverage
33
+ - verdict (pass/fail)
34
+
35
+ ## Example
36
+
37
+ Use for: "Review dashboard implementation against approved wireframe and token rules."
@@ -0,0 +1,33 @@
1
+ ---
2
+ name: design-system-definition
3
+ description: Define visual tokens and component behavior rules for consistent UI implementation
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Design System Definition Skill
8
+
9
+ Builds implementation-ready visual system guidance.
10
+
11
+ ## When to Activate
12
+
13
+ - New user-facing surface
14
+ - Existing UI has consistency issues
15
+ - `/fd-design --mode=system`
16
+
17
+ ## Required Inputs
18
+
19
+ - Brand direction or existing style baseline
20
+ - Wireframe plan
21
+
22
+ ## Output Format
23
+
24
+ - visual_direction
25
+ - design_tokens_guidance
26
+ - typography_rules
27
+ - spacing_rules
28
+ - component_behavior_rules
29
+ - accessibility_notes
30
+
31
+ ## Example
32
+
33
+ Use for: "Define tokens and component rules for SaaS dashboard redesign."
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: frontend-handoff
3
+ description: Convert approved design outputs into implementation-ready handoff checklists for frontend agents
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Frontend Handoff Skill
8
+
9
+ Ensures coding agents receive mandatory design context.
10
+
11
+ ## When to Activate
12
+
13
+ - Design approval is complete
14
+ - Frontend implementation is next
15
+
16
+ ## Required Inputs
17
+
18
+ - Approved design artifact
19
+ - Target implementation scope
20
+
21
+ ## Output Format
22
+
23
+ - implementation_handoff_checklist
24
+ - required_components
25
+ - required_states
26
+ - responsive_behavior_notes
27
+ - acceptance_criteria
28
+
29
+ ## Example
30
+
31
+ Use for: "Prepare handoff for landing page hero, pricing, and FAQ sections."
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: landing-page-design
3
+ description: Design landing pages with clear value hierarchy, CTA flow, and conversion-oriented structure
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Landing Page Design Skill
8
+
9
+ Builds conversion-focused website structures before implementation.
10
+
11
+ ## When to Activate
12
+
13
+ - Task is landing page or marketing site
14
+ - User goal includes conversion improvement
15
+
16
+ ## Required Inputs
17
+
18
+ - Product value proposition
19
+ - Target audience
20
+ - Primary CTA
21
+
22
+ ## Output Format
23
+
24
+ - section_structure
25
+ - message_hierarchy
26
+ - cta_flow
27
+ - trust_signals
28
+ - responsive_behavior_notes
29
+
30
+ ## Example
31
+
32
+ Use for: "Build a landing page for a new AI workflow product."
@@ -125,11 +125,11 @@ For any cross-repo change involving an API:
125
125
 
126
126
  1. **Write the new contract first** — `@architect` produces the updated interface definition before any code is written
127
127
  2. **Review the contract in isolation** — confirm all affected teams agree before implementation starts
128
- 3. **Implement upstream against the new contract** — `@coder` in the upstream repo
129
- 4. **Implement downstream against the new contract** — `@coder` in each consumer repo, independently
128
+ 3. **Implement upstream against the new contract** — `@backend-coder` in the upstream repo
129
+ 4. **Implement downstream against the new contract** — `@backend-coder` in each consumer repo, independently
130
130
  5. **Integration test** — verify upstream and downstream work together against the contract
131
131
 
132
- This pattern allows Wave 3 parallelism (upstream and downstream `@coder` agents can work simultaneously from the same contract) even across repos.
132
+ This pattern allows Wave 3 parallelism (upstream and downstream `@backend-coder` agents can work simultaneously from the same contract) even across repos.
133
133
 
134
134
  ## Breaking vs Non-Breaking API Changes
135
135
 
@@ -61,7 +61,7 @@ Activate when:
61
61
  ## Wave 1 — Foundation (parallel)
62
62
 
63
63
  ### Task 1.A — [Name]
64
- - **Agent**: @coder
64
+ - **Agent**: @backend-coder
65
65
  - **File**: `src/models/subscription.ts`
66
66
  - **Scope**: Create Subscription model with id, userId, status, expiresAt
67
67
  - **Verify**: `npx tsc --noEmit` passes
@@ -74,7 +74,7 @@ Activate when:
74
74
  ## Wave 2 — Implementation (after Wave 1)
75
75
 
76
76
  ### Task 2.A — [Name]
77
- - **Agent**: @coder
77
+ - **Agent**: @backend-coder
78
78
  - **Depends on**: Task 1.A, Task 1.B
79
79
  - **File**: `src/services/billing-service.ts`
80
80
  - **Scope**: Implement subscribe(), cancel(), handleWebhook()
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: responsive-review
3
+ description: Review responsive behavior and breakpoint fidelity against design intent
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Responsive Review Skill
8
+
9
+ Checks whether layouts and interactions stay usable across viewport sizes.
10
+
11
+ ## When to Activate
12
+
13
+ - UI implementation review
14
+ - Design review for mobile/tablet/desktop behavior
15
+
16
+ ## Required Inputs
17
+
18
+ - Breakpoint strategy
19
+ - Implemented UI
20
+
21
+ ## Output Format
22
+
23
+ - breakpoint_coverage
24
+ - layout_breakpoints_issues
25
+ - interaction_breakpoints_issues
26
+ - mobile_readability_issues
27
+ - responsive_verdict
28
+
29
+ ## Example
30
+
31
+ Use for: "Validate admin panel responsiveness before release."
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: ui-ux-planning
3
+ description: Define UX structure and interaction model before UI implementation
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # UI UX Planning Skill
8
+
9
+ Creates UX-first structure so implementation does not start from raw requirements.
10
+
11
+ ## When to Activate
12
+
13
+ - Feature involves user-facing flows
14
+ - Task mentions UX, onboarding, conversion, or usability
15
+
16
+ ## Required Inputs
17
+
18
+ - Product goal
19
+ - Target users
20
+ - Constraints
21
+
22
+ ## Output Format
23
+
24
+ - user_goals
25
+ - target_audience
26
+ - core_user_flows
27
+ - page_map_or_screen_map
28
+ - interaction_model
29
+
30
+ ## Example
31
+
32
+ Use for: "Improve onboarding UX for first-time users."
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: wireframe-planning
3
+ description: Produce wireframe-level layout plans with section hierarchy and component intent
4
+ origin: FlowDeck
5
+ ---
6
+
7
+ # Wireframe Planning Skill
8
+
9
+ Defines structure and layout intent before visual polish and coding.
10
+
11
+ ## When to Activate
12
+
13
+ - After UX planning and before implementation
14
+ - Task requires new page/screen structure
15
+
16
+ ## Required Inputs
17
+
18
+ - UX flows
19
+ - page/screen map
20
+
21
+ ## Output Format
22
+
23
+ - section_structure
24
+ - layout_plan
25
+ - component_list
26
+ - state_list
27
+
28
+ ## Example
29
+
30
+ Use for: "Create wireframe plan for a settings page and billing screen."
@@ -1,35 +0,0 @@
1
- export type TaskType = "planning" | "implementation" | "debugging" | "review" | "testing" | "documentation" | "analysis" | "security" | "orchestration";
2
- export interface ModelRoute {
3
- primary: string;
4
- fallback?: string;
5
- high_risk_override?: string;
6
- temperature?: number;
7
- reasoning_effort?: "low" | "medium" | "high";
8
- }
9
- export type ModelRouterConfig = Record<TaskType, ModelRoute>;
10
- export declare function getRouterConfig(dir: string): ModelRouterConfig;
11
- export interface RoutedModel {
12
- model: string;
13
- temperature: number;
14
- reasoning_effort?: "low" | "medium" | "high";
15
- task_type: TaskType;
16
- is_high_risk: boolean;
17
- is_override: boolean;
18
- }
19
- export declare function routeModel(dir: string, task_type: TaskType, risk_score?: number): RoutedModel;
20
- /**
21
- * Build agent configuration array for multi-agent orchestration.
22
- * Requires OpenCode runtime integration to be functional.
23
- * @deprecated Stub - requires OpenCode client.session.create() API
24
- */
25
- export declare function buildAgentConfig(dir: string, agents: Array<{
26
- name: string;
27
- task_type: TaskType;
28
- risk_score?: number;
29
- }>): Array<{
30
- name: string;
31
- model: string;
32
- temperature: number;
33
- reasoningEffort?: string;
34
- }>;
35
- //# sourceMappingURL=model-router.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/services/model-router.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,SAAS,GACT,eAAe,GACf,UAAU,GACV,UAAU,GACV,eAAe,CAAA;AAEnB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;CAC7C;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAc5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAS9D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC5C,SAAS,EAAE,QAAQ,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,QAAQ,EACnB,UAAU,SAAM,GACf,WAAW,CAqBb;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACxE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvF"}