@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.
- package/README.md +154 -3
- package/dist/agents/coder.d.ts +3 -1
- package/dist/agents/coder.d.ts.map +1 -1
- package/dist/agents/design.d.ts +3 -0
- package/dist/agents/design.d.ts.map +1 -0
- package/dist/agents/index.d.ts +4 -3
- package/dist/agents/index.d.ts.map +1 -1
- package/dist/agents/orchestrator.d.ts.map +1 -1
- package/dist/agents/reviewer.d.ts.map +1 -1
- package/dist/agents/specialist.d.ts +0 -1
- package/dist/agents/specialist.d.ts.map +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.d.ts.map +1 -1
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.d.ts.map +1 -1
- package/dist/config/schema.d.ts +55 -2
- package/dist/config/schema.d.ts.map +1 -1
- package/dist/dashboard/server.mjs +24 -1
- package/dist/dashboard/types.d.ts +72 -0
- package/dist/dashboard/types.d.ts.map +1 -1
- package/dist/hooks/guard-rails.d.ts.map +1 -1
- package/dist/hooks/memory-hook.d.ts +7 -0
- package/dist/hooks/memory-hook.d.ts.map +1 -1
- package/dist/hooks/orchestrator-guard-hook.d.ts.map +1 -1
- package/dist/hooks/tool-guard.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +749 -503
- package/dist/services/agent-contract-registry.d.ts +32 -0
- package/dist/services/agent-contract-registry.d.ts.map +1 -0
- package/dist/services/agent-performance.d.ts +1 -1
- package/dist/services/agent-performance.d.ts.map +1 -1
- package/dist/services/agent-trace-graph.d.ts +94 -0
- package/dist/services/agent-trace-graph.d.ts.map +1 -0
- package/dist/services/agent-validator.d.ts +56 -0
- package/dist/services/agent-validator.d.ts.map +1 -0
- package/dist/services/deadlock-detector.d.ts +34 -0
- package/dist/services/deadlock-detector.d.ts.map +1 -0
- package/dist/services/delegation-budget.d.ts +54 -0
- package/dist/services/delegation-budget.d.ts.map +1 -0
- package/dist/services/governance.test.d.ts +11 -0
- package/dist/services/governance.test.d.ts.map +1 -0
- package/dist/services/index.d.ts +6 -1
- package/dist/services/index.d.ts.map +1 -1
- package/dist/services/memory-store.d.ts +34 -1
- package/dist/services/memory-store.d.ts.map +1 -1
- package/dist/services/memory-store.test.d.ts +2 -0
- package/dist/services/memory-store.test.d.ts.map +1 -0
- package/dist/services/telemetry.d.ts +1 -1
- package/dist/services/telemetry.d.ts.map +1 -1
- package/dist/services/workflow-scorecard.d.ts +76 -0
- package/dist/services/workflow-scorecard.d.ts.map +1 -0
- package/dist/tools/delegate.d.ts.map +1 -1
- package/dist/tools/dispatch-routing.d.ts +4 -1
- package/dist/tools/dispatch-routing.d.ts.map +1 -1
- package/dist/tools/dispatch-routing.test.d.ts +2 -0
- package/dist/tools/dispatch-routing.test.d.ts.map +1 -0
- package/dist/tools/memory-search.d.ts.map +1 -1
- package/dist/tools/memory-status.d.ts.map +1 -1
- package/dist/tools/planning-state-lib.d.ts +8 -0
- package/dist/tools/planning-state-lib.d.ts.map +1 -1
- package/dist/tools/planning-state.d.ts.map +1 -1
- package/dist/tools/run-pipeline.d.ts.map +1 -1
- package/docs/agents.md +104 -74
- package/docs/best-practices.md +1 -1
- package/docs/commands/fd-ask.md +2 -2
- package/docs/commands/fd-fix-bug.md +2 -2
- package/docs/commands/fd-new-feature.md +2 -2
- package/docs/commands/fd-quick.md +3 -1
- package/docs/commands.md +37 -7
- package/docs/configuration.md +76 -46
- package/docs/design-first-workflow.md +94 -0
- package/docs/feature-integration-architecture.md +3 -31
- package/docs/index.md +5 -2
- package/docs/intelligence.md +92 -1
- package/docs/multi-repo.md +1 -1
- package/docs/rules.md +1 -1
- package/docs/skills.md +24 -15
- package/docs/workflows.md +11 -6
- package/package.json +1 -1
- package/src/commands/fd-ask.md +1 -0
- package/src/commands/fd-design.md +64 -0
- package/src/commands/fd-discuss.md +2 -0
- package/src/commands/fd-execute.md +7 -3
- package/src/commands/fd-fix-bug.md +2 -2
- package/src/commands/fd-multi-repo.md +3 -3
- package/src/commands/fd-plan.md +2 -0
- package/src/commands/fd-quick.md +4 -1
- package/src/commands/fd-verify.md +6 -0
- package/src/rules/common/agent-orchestration.md +6 -6
- package/src/skills/app-shell-design/SKILL.md +31 -0
- package/src/skills/dashboard-design/SKILL.md +32 -0
- package/src/skills/decision-trace/SKILL.md +1 -1
- package/src/skills/design-audit/SKILL.md +37 -0
- package/src/skills/design-system-definition/SKILL.md +33 -0
- package/src/skills/frontend-handoff/SKILL.md +31 -0
- package/src/skills/landing-page-design/SKILL.md +32 -0
- package/src/skills/multi-repo/SKILL.md +3 -3
- package/src/skills/plan-task/SKILL.md +2 -2
- package/src/skills/responsive-review/SKILL.md +31 -0
- package/src/skills/ui-ux-planning/SKILL.md +32 -0
- package/src/skills/wireframe-planning/SKILL.md +30 -0
- package/dist/services/model-router.d.ts +0 -35
- 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
|
|
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
|
-
-
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
package/src/commands/fd-plan.md
CHANGED
|
@@ -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
|
|
package/src/commands/fd-quick.md
CHANGED
|
@@ -21,10 +21,13 @@ Parse `$ARGUMENTS` to determine:
|
|
|
21
21
|
|
|
22
22
|
| Task Type | Signal Keywords | Agent |
|
|
23
23
|
|-----------|-----------------|-------|
|
|
24
|
-
|
|
|
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
|
-
| `@
|
|
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."
|
|
@@ -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"}
|