@dv.nghiem/flowdeck 0.3.7 → 0.3.8

package/dist/hooks/command-ref-guard.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HOOK: Command Reference Guard
+ * Post-response hook that scans agent output for /fd-* slash command references
+ * and warns when an invalid (unregistered) command is found.
+ *
+ * This is a lightweight advisory guardrail — it emits a warning comment
+ * at the top of the response rather than blocking it, preserving usability
+ * while surfacing drift for developers to fix.
+ */
+/**
+ * Scan an agent response string and return a warning prefix if any invalid
+ * command references are detected. Returns null if response is clean.
+ */
+export declare function buildCommandRefWarning(response: string): string | null;
+/**
+ * Apply the command reference guardrail to an agent response.
+ * If invalid command references are found, prepend a warning block.
+ * If clean, return the response unchanged.
+ */
+export declare function applyCommandRefGuard(response: string): string;
+//# sourceMappingURL=command-ref-guard.d.ts.map

package/dist/hooks/command-ref-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-ref-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/command-ref-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBtE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI7D"}

package/dist/index.js

@@ -2480,7 +2480,7 @@ async function guardRailsHook(ctx, input, _output) {
     for (const pattern of BUILD_DEPLOY_PATTERNS) {
       if (cmd.includes(pattern)) {
         if (!getPlanConfirmed(statePath2)) {
-          throw new Error(`[flowdeck] WARNING: Build/deploy command detected but plan is not confirmed. Run /plan first.`);
+          throw new Error(`[flowdeck] WARNING: Build/deploy command detected but plan is not confirmed. Run /fd-plan first.`);
         }
         break;
       }
@@ -2543,15 +2543,15 @@ function getPlanConfirmed(statePath2) {
 }
 function getWarningMessage(planningDir2) {
   if (!existsSync18(join18(planningDir2, STATE_FILE2))) {
-    return "No .planning/ found. Run /new-project first.";
+    return "No .planning/ found. Run /fd-new-project first.";
   }
-  return "Plan not confirmed. Run /plan and confirm to enable execution.";
+  return "Plan not confirmed. Run /fd-plan and confirm to enable execution.";
 }
 function getBlockMessage(planningDir2) {
   if (!existsSync18(join18(planningDir2, STATE_FILE2))) {
-    return "No .planning/ found. Run /new-project first.";
+    return "No .planning/ found. Run /fd-new-project first.";
   }
-  return "Plan not confirmed. Run /plan and confirm to enable execution.";
+  return "Plan not confirmed. Run /fd-plan and confirm to enable execution.";
 }
 
 // src/hooks/tool-guard.ts
@@ -2689,7 +2689,7 @@ async function sessionStartHook(ctx) {
     return {
       flowdeck_phase: null,
       flowdeck_status: "no_plan",
-      flowdeck_warning: "Run /new-project or /map-codebase to initialize.",
+      flowdeck_warning: "Run /fd-new-project or /fd-map-codebase to initialize.",
       flowdeck_has_codebase: existsSync20(codebaseDirectory),
       ...workspaceRoot && config?.sub_repos ? {
         flowdeck_workspace_root: workspaceRoot,
@@ -3605,16 +3605,16 @@ MUST execute at session start:
 3. Check which steps are marked complete
 4. Begin execution from the first incomplete step
 
-If STATE.md does not exist, tell the user: "No STATE.md found. Run \`/new-project\` to initialize."
+If STATE.md does not exist, tell the user: "No STATE.md found. Run \`/fd-new-project\` to initialize."
 
 ## Phase Gating
 
 Only orchestrate in the **execute** phase.
 
 If the project is in another phase:
-- **discuss** phase: "Run \`/discuss\` to complete requirements gathering first."
-- **plan** phase: "Run \`/plan\` to create the implementation plan first."
-- **review** phase: "Run \`/review-code\` to complete the review phase."
+- **discuss** phase: "Run \`/fd-discuss\` to complete requirements gathering first."
+- **plan** phase: "Run \`/fd-plan\` to create the implementation plan first."
+- **review** phase: "Run \`/fd-verify\` to complete the review phase."
 
 ## Step Execution
 
@@ -5539,7 +5539,7 @@ Discussion is complete when:
 - All decisions recorded in DISCUSS.md
 - No open questions remain
 
-Report: "Requirements gathering complete. N decisions recorded. Ready for /plan."`;
+Report: "Requirements gathering complete. N decisions recorded. Ready for /fd-plan."`;
 var createTaskSplitterAgent = (model, customPrompt, customAppendPrompt) => {
   const prompt = resolvePrompt(TASK_SPLITTER_PROMPT, customPrompt, customAppendPrompt);
   return {

package/dist/lib/impact-radar.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared Impact Radar utility.
  * Scans .codebase/ data stores for risk signals relevant to a change description.
- * Used by /discuss, /plan, /new-feature, and /fix-bug.
+ * Used by /fd-discuss, /fd-plan, /fd-new-feature, and /fd-fix-bug.
  */
 import type { FailureEntry } from "../tools/failure-replay";
 export interface ImpactRadarResult {
@@ -29,7 +29,7 @@ export declare function impactRadarSummaryLines(radar: ImpactRadarResult): strin
 /**
  * Look up prior failures from FAILURES.json that match by path prefix or keyword.
  * Returns full FailureEntry objects (including root_cause and fix_applied) sorted by recurrence desc.
- * Used by /fix-bug to surface lessons learned before the fix begins.
+ * Used by /fd-fix-bug to surface lessons learned before the fix begins.
  */
 export declare function lookupPriorFailures(dir: string, scope: string, bugText: string, limit?: number): FailureEntry[];
 //# sourceMappingURL=impact-radar.d.ts.map

package/dist/services/command-validator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Command reference validator.
+ * Source of truth: REGISTERED_COMMANDS from supervisor-binding.
+ * Used at startup, in tests, and by the response guardrail to prevent
+ * agents from suggesting slash commands that don't exist.
+ */
+export interface CommandValidationResult {
+    valid: boolean;
+    command: string;
+    reason?: string;
+}
+export interface AuditResult {
+    text: string;
+    references: string[];
+    invalid: CommandValidationResult[];
+    valid: CommandValidationResult[];
+    hasInvalid: boolean;
+}
+/**
+ * Returns true if the given slash command (with or without leading slash) is registered.
+ */
+export declare function isValidCommand(ref: string): boolean;
+/**
+ * Validate a single command reference string (e.g. "/fd-plan" or "fd-plan").
+ */
+export declare function validateCommandReference(ref: string): CommandValidationResult;
+/**
+ * Extract all /fd-* slash command references from a text string.
+ */
+export declare function extractCommandReferences(text: string): string[];
+/**
+ * Extract bare /word references that are missing the fd- prefix.
+ * Returns only those that would be valid if prefixed with fd-.
+ */
+export declare function extractBarePrefixErrors(text: string): string[];
+/**
+ * Audit a text string for invalid command references.
+ * Checks all /fd-* patterns against the registered command set.
+ */
+export declare function auditTextForInvalidCommands(text: string): AuditResult;
+/**
+ * Rewrite a text string by replacing invalid /fd-* command references with
+ * a note that the command is unavailable. Leaves valid commands untouched.
+ */
+export declare function rewriteInvalidCommandRefs(text: string): string;
+/**
+ * Return the full canonical command inventory for inspection/testing.
+ */
+export declare function getCommandInventory(): readonly string[];
+//# sourceMappingURL=command-validator.d.ts.map

package/dist/services/command-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.d.ts","sourceRoot":"","sources":["../../src/services/command-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,UAAU,EAAE,OAAO,CAAA;CACpB;AAQD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAmB7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAqBrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD"}

package/dist/services/command-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-validator.test.d.ts.map

package/dist/services/command-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.test.d.ts","sourceRoot":"","sources":["../../src/services/command-validator.test.ts"],"names":[],"mappings":""}

package/dist/services/quick-router.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Quick Router Service
+ *
+ * Provides task classification and stage-sequence routing for the /fd-quick
+ * autonomous workflow launcher.
+ *
+ * This module is the single source of truth for:
+ *   - Classifying user task descriptions into task types
+ *   - Mapping task types to the correct existing stage sequence
+ *   - Computing the next stage given what has already completed
+ *   - Determining whether supervisor clarification is required before proceeding
+ *
+ * It does NOT create new workflows. It routes to the existing commands:
+ *   fd-discuss, fd-design, fd-plan, fd-execute, fd-fix-bug, fd-write-docs, fd-verify
+ */
+export type TaskType = "feature" | "ui-feature" | "bugfix" | "docs" | "simple" | "ambiguous";
+/** A single stage in a workflow sequence, mapping to an existing fd-* command. */
+export interface WorkflowStage {
+    /** Human-readable stage name */
+    name: string;
+    /** The registered fd-* command that implements this stage */
+    command: string;
+    /** Arguments to pass to the command (if any) */
+    args?: string;
+    /** Whether this stage requires human approval before proceeding */
+    requiresApproval: boolean;
+    /** Whether this stage can be skipped if prerequisites are absent and --override is set */
+    skippable: boolean;
+}
+export interface ClassificationResult {
+    taskType: TaskType;
+    /** 0.0–1.0 confidence in the classification */
+    confidence: number;
+    /** Which signal patterns triggered the classification */
+    signals: string[];
+    /** True when the task is explicitly UI/UX-heavy, requiring design-first */
+    requiresDesign: boolean;
+    /** True when TDD enforcement applies (always true except for docs-only) */
+    requiresTDD: boolean;
+    /** Ordered sequence of stages to execute */
+    stageSequence: WorkflowStage[];
+    /** True when the description is too vague to classify without asking a question */
+    clarificationNeeded: boolean;
+    /** The single clarifying question to ask via supervisor (when clarificationNeeded=true) */
+    clarificationPrompt?: string;
+}
+/**
+ * Classify a free-text task description into a TaskType with a confidence score.
+ *
+ * Signal matching is case-insensitive substring search. Multiple signal hits
+ * increase confidence. The highest-confidence match wins; ties break toward
+ * the more structured workflow type (feature > simple > ambiguous).
+ */
+export declare function classifyTask(description: string): ClassificationResult;
+/**
+ * Build the ordered WorkflowStage array for a given TaskType.
+ * Each stage maps 1:1 to an existing registered fd-* command.
+ */
+export declare function buildStageSequence(taskType: TaskType): WorkflowStage[];
+export interface StageProgress {
+    completedStageNames: string[];
+    blockedAtStage?: string;
+    blockedReason?: string;
+}
+export interface NextStageResult {
+    /** The stage to execute next, or null if all stages are complete */
+    stage: WorkflowStage | null;
+    /** True when all stages have been completed */
+    allComplete: boolean;
+    /** True when execution is blocked at a stage */
+    blocked: boolean;
+    blockedReason?: string;
+    /** Remaining stage names (not counting the returned stage) */
+    remaining: string[];
+}
+/**
+ * Given a stage sequence and the current progress, determine the next
+ * stage to execute.
+ *
+ * Returns null stage when all stages are complete.
+ */
+export declare function getNextStage(sequence: WorkflowStage[], progress: StageProgress): NextStageResult;
+/** The structure written to STATE.md under the `quick_run` key by /fd-quick. */
+export interface QuickRunState {
+    /** Original task description from $ARGUMENTS */
+    taskDescription: string;
+    /** Classification result */
+    taskType: TaskType;
+    confidence: number;
+    requiresDesign: boolean;
+    requiresTDD: boolean;
+    /** Ordered stage names for this run */
+    stageSequence: string[];
+    /** Stages that have been completed */
+    completedStages: string[];
+    /** Current stage being executed, if any */
+    currentStage: string | null;
+    /** Whether the run has been halted */
+    blocked: boolean;
+    blockedReason?: string;
+    /** Supervisor decisions keyed by stage name */
+    supervisorDecisions: Record<string, {
+        decision: string;
+        reasons: string[];
+        timestamp: string;
+    }>;
+    /** ISO timestamp when the run started */
+    startedAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Final run outcome */
+    outcome: "running" | "complete" | "blocked" | "failed";
+}
+/**
+ * Create a fresh QuickRunState record for a new /fd-quick run.
+ */
+export declare function createQuickRunState(taskDescription: string, classification: ClassificationResult): QuickRunState;
+//# sourceMappingURL=quick-router.d.ts.map

package/dist/services/quick-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-router.d.ts","sourceRoot":"","sources":["../../src/services/quick-router.ts"],"names":[],"mappings":"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"}

package/dist/services/quick-router.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Quick Router Tests
+ *
+ * Covers:
+ * - classifyTask: correctly classifies feature, bugfix, ui-feature, docs, simple, ambiguous
+ * - buildStageSequence: returns correct ordered stages for each task type
+ * - getNextStage: returns correct next stage and handles completed / blocked states
+ * - createQuickRunState: initialises state correctly
+ * - /fd-quick routing contracts (supervisor integration points are tested as
+ *   integration-level expectations on the returned stage sequences)
+ */
+export {};
+//# sourceMappingURL=quick-router.test.d.ts.map

package/dist/services/quick-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-router.test.d.ts","sourceRoot":"","sources":["../../src/services/quick-router.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/docs/commands.md

@@ -24,7 +24,7 @@ Commands are slash commands registered in OpenCode. Run them by typing `/command
 | `/fd-multi-repo` | `[list \| add <path> [name] \| remove <name> \| status]` | Multi-repo orchestration |
 | `/fd-translate-intent` | `[vague intent]` | Convert vague request into ranked implementation options |
 | `/fd-ask` | `[question]` | Route question to specialist agent (architect, security, etc.) |
-| `/fd-quick` | `[task description]` | Quick focused task with automatic agent selection |
+| `/fd-quick` | `[task description]` | Autonomous workflow launcher — classifies task, selects correct workflow, runs all stages end-to-end |
 | `/fd-doctor` | — | Check FlowDeck installation and environment health |
 
 ---
@@ -483,34 +483,54 @@ Comprehensive pre-change analysis: impact radar, blast radius, regression predic
 
 ## /fd-quick
 
-**Description:** Execute a focused task without the full workflow. Selects best specialist agent automatically.
+**Description:** Autonomous workflow launcher. Classifies the task, selects the correct existing FlowDeck workflow, and runs all stages end-to-end with minimal user input. Routes all clarifying questions through `@supervisor`.
 
 **Arguments:**
-- `[task description]` — what you need done
-
-**Agent Selection Matrix:**
-
-| Task Type | Agent |
-|-----------|-------|
-| Backend code | @backend-coder |
-| Frontend code | @frontend-coder |
-| DevOps/infra code | @devops |
-| Explore/understand | @code-explorer |
-| Review code | @reviewer |
-| Security review | @security-auditor |
-| Design/architecture | @architect |
-| Write tests | @tester |
-| Documentation | @doc-updater |
-| Research | @researcher |
-| Debug | @debug-specialist |
-| Performance | @performance-optimizer |
-| Build error | @build-error-resolver |
+- `[task description]` — what you need done (any phrasing — the command classifies it)
+
+**Task Classification:**
+
+| Classification | Trigger Signals | Stage Sequence |
+|----------------|-----------------|----------------|
+| `feature` | Substantive description, no specific signals | `discuss → plan → execute → verify` |
+| `ui-feature` | landing page, dashboard, admin panel, app screen, ux flow | `discuss → design → plan → execute → verify` |
+| `bugfix` | fix, bug, error, crash, regression, broken, exception | `discuss → fix-bug → verify` |
+| `docs` | docs, documentation, readme, api docs, write docs | `discuss → write-docs → verify` |
+| `simple` | rename, typo, minor, move file | `execute → verify` |
+| `ambiguous` | vague or too short | *supervisor asks one clarifying question* |
+
+**What it does:**
+1. Classifies the task from `$ARGUMENTS` using signal patterns
+2. Routes ambiguous tasks through `@supervisor` for a single focused clarifying question
+3. Presents the selected stage sequence to the user
+4. Executes each stage in order using the existing registered commands (`/fd-discuss`, `/fd-plan`, etc.)
+5. Gates each stage through `@supervisor` preflight review (approve / revise / block / escalate)
+6. Respects all workflow discipline: TDD gates, design-first gate for UI tasks, plan CONFIRM gate
+7. Pauses only when a supervisor gate requires user approval, or when blocked
+8. Records all routing decisions, stage transitions, and supervisor decisions in STATE.md
+9. On block: explains exactly what stopped execution and what is needed to resume
+
+**What it preserves:**
+- All existing commands (`/fd-discuss`, `/fd-plan`, `/fd-execute`, etc.) remain independently usable
+- TDD enforcement is never bypassed
+- Design-first gate for UI-heavy tasks is enforced
+- Plan CONFIRM gate is always presented to the user
+- Verify pipeline always runs at end
 
 **Example:**
 ```
-/fd-quick find where the session token is validated
-/fd-quick add rate limiting to the API
+/fd-quick add two-factor authentication to the login system
+/fd-quick fix the checkout crash when cart is empty
+/fd-quick build a new analytics dashboard for admin users
+/fd-quick write API documentation for the user service
+/fd-quick rename MAX_RETRIES constant to RETRY_LIMIT
+```
+
+**Resume after a block:**
+```
+/fd-quick <original task description>
 ```
+`/fd-quick` resumes from the last completed stage automatically.
 
 ---
 

package/docs/quick-start.md

@@ -190,6 +190,8 @@ This writes the current execution state to `.planning/STATE.md`. To reload conte
 
 > **Skip to execute for small tasks** — for a quick bug fix, you do not need to run `/fd-discuss` and `/fd-plan`. Use `/fd-fix-bug` directly and let `@debug-specialist` handle the full cycle.
 
+> **Let `/fd-quick` drive the whole workflow** — instead of manually calling each command in sequence, run `/fd-quick <your task>` and the system classifies the task, selects the correct workflow (feature, bug fix, UI-heavy, docs), and runs all stages autonomously. It pauses only when your explicit input is needed (e.g., plan CONFIRM, approval gates). Existing commands remain fully usable standalone.
+
 ---
 
 ← [Back to Index](index.md)

package/docs/workflows.md

@@ -56,7 +56,7 @@ Each step gates the next. `/fd-discuss` requires a defined feature. `/fd-plan` r
 | `/fd-multi-repo` | Multi-repo orchestration | @multi-repo-coordinator, @architect |
 | `/fd-translate-intent` | Convert vague requests to ranked implementation options | @architect, @researcher |
 | `/fd-suggest` | Suggest high-value feature opportunities from codebase signals | @researcher, @architect |
-| `/fd-quick` | Fast focused task execution | @backend-coder/@frontend-coder/@devops or selected specialist |
+| `/fd-quick` | Autonomous workflow launcher — classifies task, runs correct stage sequence end-to-end | @supervisor, @orchestrator, and all workflow agents |
 | `/fd-reflect` | Post-session reflection and skill capture | @auto-learner |
 | `/fd-doctor` | Installation and environment diagnostics | @orchestrator |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dv.nghiem/flowdeck",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "FlowDeck — structured planning and execution workflows for OpenCode",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,16 +45,16 @@
   },
   "homepage": "https://github.com/DVNghiem/FlowDeck#readme",
   "dependencies": {
-    "@opencode-ai/plugin": "^1.4.0"
+    "@opencode-ai/plugin": "^1.14.49"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "bun-types": "^1.3.13",
-    "ejs": "^3.1.9",
-    "typescript": "^5.7.0",
-    "vitest": "^2.0.0"
+    "@types/node": "^25.7.0",
+    "bun-types": "^1.3.14",
+    "ejs": "^5.0.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
   },
   "peerDependencies": {
-    "@opencode-ai/sdk": "^1.4.0"
+    "@opencode-ai/sdk": "^1.14.49"
   }
 }

package/src/commands/fd-discuss.md

@@ -95,7 +95,7 @@ If UI-heavy, also suggest running `/fd-design --mode=draft` before `/fd-execute`
 ## Error Handling
 
 D-03: Fail fast with clear error
-- If PROJECT.md not found: error with "Run /new-project first"
+- If PROJECT.md not found: error with "Run /fd-new-project first"
 - If STATE.md not found: error with "Project not initialized"
 - If @discusser fails: error with "Discusser agent unavailable"
 - No partial state saved on error

package/src/commands/fd-multi-repo.md

@@ -16,14 +16,14 @@ Orchestrates a feature or fix that spans multiple repositories in a microservice
 - A shared library is being upgraded with a breaking change
 - You need a coordinated rollout across services
 
-Do not use for single-repo work. Use `/new-feature` instead.
+Do not use for single-repo work. Use `/fd-new-feature` instead.
 
 ## Prerequisites
 
 Before running this flow:
 1. `.planning/config.json` has a `sub_repos` array with the relevant repos registered
 2. All `path` values in the registry resolve to actual directories on disk
-3. A description of the intended change is available (from `/discuss` or passed directly)
+3. A description of the intended change is available (from `/fd-discuss` or passed directly)
 
 If the registry is empty or not set up, run `/multi-repo --add` first.
 

package/src/commands/fd-plan.md

@@ -17,7 +17,7 @@ D-06: Verify DISCUSS.md exists and is confirmed.
 
 If no DISCUSS.md found:
 ```
-Error: DISCUSS.md not found. Run /discuss [topic] first.
+Error: DISCUSS.md not found. Run /fd-discuss [topic] first.
 ```
 
 If DISCUSS.md exists but not confirmed: