@dv.nghiem/flowdeck 0.3.3 → 0.3.5

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 (116) hide show
  1. package/README.md +160 -8
  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/orchestrator-guard-hook.d.ts +4 -1
  23. package/dist/hooks/orchestrator-guard-hook.d.ts.map +1 -1
  24. package/dist/hooks/session-idle-hook.d.ts.map +1 -1
  25. package/dist/hooks/telemetry-hook.d.ts +14 -1
  26. package/dist/hooks/telemetry-hook.d.ts.map +1 -1
  27. package/dist/hooks/telemetry-hook.test.d.ts +2 -0
  28. package/dist/hooks/telemetry-hook.test.d.ts.map +1 -0
  29. package/dist/hooks/tool-guard.d.ts.map +1 -1
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +810 -474
  32. package/dist/services/agent-contract-registry.d.ts +32 -0
  33. package/dist/services/agent-contract-registry.d.ts.map +1 -0
  34. package/dist/services/agent-performance.d.ts +1 -1
  35. package/dist/services/agent-performance.d.ts.map +1 -1
  36. package/dist/services/agent-trace-graph.d.ts +94 -0
  37. package/dist/services/agent-trace-graph.d.ts.map +1 -0
  38. package/dist/services/agent-validator.d.ts +56 -0
  39. package/dist/services/agent-validator.d.ts.map +1 -0
  40. package/dist/services/deadlock-detector.d.ts +34 -0
  41. package/dist/services/deadlock-detector.d.ts.map +1 -0
  42. package/dist/services/delegation-budget.d.ts +54 -0
  43. package/dist/services/delegation-budget.d.ts.map +1 -0
  44. package/dist/services/governance.test.d.ts +11 -0
  45. package/dist/services/governance.test.d.ts.map +1 -0
  46. package/dist/services/index.d.ts +6 -1
  47. package/dist/services/index.d.ts.map +1 -1
  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/council.d.ts.map +1 -1
  53. package/dist/tools/delegate.d.ts.map +1 -1
  54. package/dist/tools/dispatch-routing.d.ts +9 -0
  55. package/dist/tools/dispatch-routing.d.ts.map +1 -0
  56. package/dist/tools/dispatch-routing.test.d.ts +2 -0
  57. package/dist/tools/dispatch-routing.test.d.ts.map +1 -0
  58. package/dist/tools/planning-state-lib.d.ts +8 -0
  59. package/dist/tools/planning-state-lib.d.ts.map +1 -1
  60. package/dist/tools/planning-state.d.ts.map +1 -1
  61. package/dist/tools/run-pipeline.d.ts.map +1 -1
  62. package/docs/agents.md +104 -74
  63. package/docs/best-practices.md +1 -1
  64. package/docs/commands/fd-ask.md +2 -2
  65. package/docs/commands/fd-fix-bug.md +2 -2
  66. package/docs/commands/fd-new-feature.md +2 -2
  67. package/docs/commands/fd-quick.md +3 -1
  68. package/docs/commands.md +37 -7
  69. package/docs/configuration.md +76 -46
  70. package/docs/design-first-workflow.md +94 -0
  71. package/docs/feature-integration-architecture.md +3 -31
  72. package/docs/index.md +5 -2
  73. package/docs/installation.md +6 -17
  74. package/docs/intelligence.md +110 -34
  75. package/docs/multi-repo.md +1 -1
  76. package/docs/optimization-baseline.md +21 -0
  77. package/docs/rules.md +10 -37
  78. package/docs/skills.md +24 -15
  79. package/docs/workflows.md +18 -14
  80. package/package.json +4 -2
  81. package/src/commands/fd-ask.md +1 -0
  82. package/src/commands/fd-design.md +64 -0
  83. package/src/commands/fd-discuss.md +2 -0
  84. package/src/commands/fd-execute.md +7 -3
  85. package/src/commands/fd-fix-bug.md +2 -2
  86. package/src/commands/fd-multi-repo.md +3 -3
  87. package/src/commands/fd-plan.md +2 -0
  88. package/src/commands/fd-quick.md +4 -1
  89. package/src/commands/fd-verify.md +6 -0
  90. package/src/rules/README.md +10 -0
  91. package/src/rules/common/agent-orchestration.md +6 -6
  92. package/src/rules/common/coding-style.md +2 -2
  93. package/src/rules/typescript/patterns.md +1 -1
  94. package/src/skills/app-shell-design/SKILL.md +31 -0
  95. package/src/skills/backend-patterns/SKILL.md +6 -0
  96. package/src/skills/clean-architecture/SKILL.md +6 -0
  97. package/src/skills/cqrs/SKILL.md +6 -0
  98. package/src/skills/dashboard-design/SKILL.md +32 -0
  99. package/src/skills/ddd-architecture/SKILL.md +6 -0
  100. package/src/skills/decision-trace/SKILL.md +1 -1
  101. package/src/skills/design-audit/SKILL.md +37 -0
  102. package/src/skills/design-system-definition/SKILL.md +33 -0
  103. package/src/skills/event-driven-architecture/SKILL.md +6 -0
  104. package/src/skills/frontend-handoff/SKILL.md +31 -0
  105. package/src/skills/hexagonal-architecture/SKILL.md +6 -0
  106. package/src/skills/landing-page-design/SKILL.md +32 -0
  107. package/src/skills/layered-architecture/SKILL.md +6 -0
  108. package/src/skills/multi-repo/SKILL.md +3 -3
  109. package/src/skills/plan-task/SKILL.md +2 -2
  110. package/src/skills/postgres-patterns/SKILL.md +6 -0
  111. package/src/skills/responsive-review/SKILL.md +31 -0
  112. package/src/skills/saga-architecture/SKILL.md +6 -0
  113. package/src/skills/ui-ux-planning/SKILL.md +32 -0
  114. package/src/skills/wireframe-planning/SKILL.md +30 -0
  115. package/dist/services/model-router.d.ts +0 -35
  116. package/dist/services/model-router.d.ts.map +0 -1
@@ -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."
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: ddd-architecture
3
+ description: Domain-Driven Design patterns for bounded contexts, aggregates, and ubiquitous language.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # ddd-architecture
2
8
 
3
9
  ## When to Activate
@@ -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."
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: event-driven-architecture
3
+ description: Event-driven architecture patterns for asynchronous workflows and decoupled services.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # Event-Driven Architecture
2
8
 
3
9
  ## When to Activate
@@ -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."
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: hexagonal-architecture
3
+ description: Ports-and-adapters architecture patterns for testable, framework-independent domain logic.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # hexagonal-architecture
2
8
 
3
9
  ## When to Activate
@@ -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."
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: layered-architecture
3
+ description: Layered architecture patterns for separating presentation, application, domain, and data layers.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # layered-architecture
2
8
 
3
9
  ## When to Activate
@@ -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()
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: postgres-patterns
3
+ description: PostgreSQL schema, query, indexing, and performance patterns.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # postgres-patterns
2
8
 
3
9
  ## When to Activate
@@ -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."
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: saga-architecture
3
+ description: Saga coordination patterns for distributed transactions with compensating actions.
4
+ origin: FlowDeck
5
+ ---
6
+
1
7
  # saga-architecture
2
8
 
3
9
  ## When to Activate
@@ -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"}