@dv.nghiem/flowdeck 0.3.7 → 0.3.9
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 +0 -101
- package/dist/dashboard/server.mjs +789 -868
- package/dist/hooks/command-ref-guard.d.ts +21 -0
- package/dist/hooks/command-ref-guard.d.ts.map +1 -0
- package/dist/hooks/compaction-hook.d.ts +2 -1
- package/dist/hooks/compaction-hook.d.ts.map +1 -1
- package/dist/hooks/session-start.d.ts.map +1 -1
- package/dist/index.js +33 -14
- package/dist/lib/impact-radar.d.ts +2 -2
- package/dist/mcp/index.d.ts +3 -2
- package/dist/mcp/index.d.ts.map +1 -1
- package/dist/services/command-validator.d.ts +61 -0
- package/dist/services/command-validator.d.ts.map +1 -0
- package/dist/services/command-validator.test.d.ts +2 -0
- package/dist/services/command-validator.test.d.ts.map +1 -0
- package/dist/services/preflight-explorer.d.ts +130 -0
- package/dist/services/preflight-explorer.d.ts.map +1 -0
- package/dist/services/preflight-explorer.test.d.ts +25 -0
- package/dist/services/preflight-explorer.test.d.ts.map +1 -0
- package/dist/services/question-guard.d.ts +92 -0
- package/dist/services/question-guard.d.ts.map +1 -0
- package/dist/services/quick-router.d.ts +157 -0
- package/dist/services/quick-router.d.ts.map +1 -0
- package/dist/services/quick-router.test.d.ts +13 -0
- package/dist/services/quick-router.test.d.ts.map +1 -0
- package/docs/commands.md +43 -23
- package/docs/quick-start.md +2 -0
- package/docs/workflows.md +1 -1
- package/package.json +8 -8
- package/src/commands/fd-deploy-check.md +2 -2
- package/src/commands/fd-discuss.md +61 -4
- package/src/commands/fd-map-codebase.md +1 -1
- package/src/commands/fd-multi-repo.md +3 -3
- package/src/commands/fd-plan.md +1 -1
- package/src/commands/fd-quick.md +303 -55
- package/src/rules/common/behavioral.md +63 -0
- package/src/skills/blast-radius-preview/SKILL.md +1 -1
- package/src/skills/change-impact-radar/SKILL.md +2 -2
- package/src/skills/codebase-mapping/SKILL.md +1 -1
- package/src/skills/confidence-aware-planning/SKILL.md +1 -1
- package/src/skills/context-load/SKILL.md +1 -1
- package/src/skills/human-review-routing/SKILL.md +3 -3
- package/src/skills/intent-translator/SKILL.md +2 -2
- package/src/skills/multi-repo/SKILL.md +1 -1
- package/src/skills/regression-prediction/SKILL.md +1 -1
- package/src/skills/repo-memory-graph/SKILL.md +1 -1
- package/src/skills/test-gap-detector/SKILL.md +1 -1
- package/src/skills/volatility-map/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -172,104 +172,3 @@ Agents not listed in `agents` inherit the active OpenCode model. See [Configurat
|
|
|
172
172
|
## License
|
|
173
173
|
|
|
174
174
|
MIT
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## Quick Install
|
|
180
|
-
|
|
181
|
-
### Method 1: curl (recommended)
|
|
182
|
-
|
|
183
|
-
```bash
|
|
184
|
-
curl -fsSL https://raw.githubusercontent.com/DVNghiem/flowdeck/main/install.sh | bash
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
### Method 2: npx (no git required)
|
|
188
|
-
|
|
189
|
-
```bash
|
|
190
|
-
npx @dv.nghiem/flowdeck install
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
See [Installation](docs/installation.md) for prerequisites, verification steps, and environment variables.
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
## Core Workflow
|
|
198
|
-
|
|
199
|
-
FlowDeck structures every feature through a six-step cycle:
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
/fd-new-project → /fd-new-feature → /fd-discuss → /fd-plan → /fd-execute → /fd-verify
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
| Step | Command | What happens |
|
|
206
|
-
|------|---------|--------------|
|
|
207
|
-
| **Setup** | `/fd-new-project MyApp` | Creates `.planning/` directory with `PROJECT.md`, `STATE.md`, and `ROADMAP.md` |
|
|
208
|
-
| **Define Feature** | `/fd-new-feature "…"` | Initialize feature context, creates `FEATURE.md` in current phase |
|
|
209
|
-
| **Discuss** | `/fd-discuss` | `@discusser` runs structured Q&A, saves decisions to `DISCUSS.md` |
|
|
210
|
-
| **Plan** | `/fd-plan` | `@planner` builds a wave-structured `PLAN.md`; you type `CONFIRM` to proceed |
|
|
211
|
-
| **Execute** | `/fd-execute` | `@orchestrator` delegates to `@architect`, `@backend-coder`, `@tester`, `@reviewer` via TDD |
|
|
212
|
-
| **Verify** | `/fd-verify` | Full test suite, code review, security scan, and deploy check |
|
|
213
|
-
|
|
214
|
-
State is written to `.planning/STATE.md` after each phase. Use `/fd-checkpoint` to save mid-session and `/fd-resume` to reload context in a new session.
|
|
215
|
-
|
|
216
|
-
---
|
|
217
|
-
|
|
218
|
-
## Command Reference
|
|
219
|
-
|
|
220
|
-
### Workflow commands
|
|
221
|
-
|
|
222
|
-
| Command | Purpose |
|
|
223
|
-
|---------|---------|
|
|
224
|
-
| `/fd-new-project` | Bootstrap a new project with PROJECT.md, ROADMAP.md, STATE.md |
|
|
225
|
-
| `/fd-map-codebase` | Analyse and index the codebase into structured `.codebase/` files |
|
|
226
|
-
| `/fd-new-feature` | Define a new feature and initialize feature context |
|
|
227
|
-
| `/fd-discuss` | Pre-planning structured Q&A to capture decisions |
|
|
228
|
-
| `/fd-plan` | Generate a wave-structured execution plan from decisions |
|
|
229
|
-
| `/fd-execute` | Implement feature with TDD discipline and parallel agents |
|
|
230
|
-
| `/fd-verify` | Full verification pipeline: tests, code review, security scan, deploy check |
|
|
231
|
-
| `/fd-fix-bug` | Diagnose, fix, and verify a bug with regression test |
|
|
232
|
-
| `/fd-write-docs` | Explore APIs and generate accurate documentation |
|
|
233
|
-
| `/fd-deploy-check` | Pre-deploy safety check with test, security, and build verification |
|
|
234
|
-
| `/fd-status` | View project progress, roadmap, and workspace overview |
|
|
235
|
-
| `/fd-checkpoint` | Save a session checkpoint to STATE.md |
|
|
236
|
-
| `/fd-resume` | Reload STATE.md and PLAN.md to continue interrupted session |
|
|
237
|
-
| `/fd-reflect` | Post-session reflection or capture patterns as reusable skills |
|
|
238
|
-
| `/fd-multi-repo` | Multi-repo orchestration — list, add, remove, or status |
|
|
239
|
-
| `/fd-translate-intent` | Convert vague requests into ranked implementation options |
|
|
240
|
-
| `/fd-suggest` | Analyze the codebase and suggest high-value feature opportunities |
|
|
241
|
-
| `/fd-ask` | Smart agent dispatch — routes to specialist by keyword |
|
|
242
|
-
| `/fd-quick` | Focused task with automatic agent selection |
|
|
243
|
-
| `/fd-doctor` | Check FlowDeck installation and environment health |
|
|
244
|
-
|
|
245
|
-
### Analysis commands
|
|
246
|
-
|
|
247
|
-
These umbrella commands consolidate multiple analysis modules into focused entry points:
|
|
248
|
-
|
|
249
|
-
| Command | Purpose |
|
|
250
|
-
|---------|---------|
|
|
251
|
-
| `/fd-translate-intent` | Convert vague requests into ranked implementation options with tradeoffs |
|
|
252
|
-
| `/fd-suggest` | Combined opportunity and risk analysis (impact, volatility, failures, and skill gaps) |
|
|
253
|
-
| `/fd-deploy-check` | Pre-change release safety checks and review routing |
|
|
254
|
-
| `/fd-verify` | Standalone verification for tests, review, and security checks |
|
|
255
|
-
|
|
256
|
-
See [docs/workflows.md](docs/workflows.md) for details on how analysis commands work.
|
|
257
|
-
|
|
258
|
-
---
|
|
259
|
-
|
|
260
|
-
## Documentation
|
|
261
|
-
|
|
262
|
-
| File | Description |
|
|
263
|
-
|------|-------------|
|
|
264
|
-
| [docs/index.md](docs/index.md) | Full documentation table of contents |
|
|
265
|
-
| [docs/installation.md](docs/installation.md) | Prerequisites, install methods, verification, and uninstall |
|
|
266
|
-
| [docs/quick-start.md](docs/quick-start.md) | First 15 minutes — step-by-step walkthrough |
|
|
267
|
-
| [docs/configuration.md](docs/configuration.md) | `opencode.json`, project config, environment variables, plugin tools |
|
|
268
|
-
| [docs/USER_GUIDE.md](docs/USER_GUIDE.md) | Full agent and skill usage reference with examples |
|
|
269
|
-
| [docs/workflows.md](docs/workflows.md) | Command architecture and workflow patterns |
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
## License
|
|
274
|
-
|
|
275
|
-
MIT
|