@jakkrichm/create-nexus-devflow 2.2.0 → 2.2.1

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 (38) hide show
  1. package/README.md +1 -1
  2. package/dist/bin/create-nexus-devflow.js +1 -1
  3. package/dist/bin/create-nexus-devflow.js.map +1 -1
  4. package/dist/lib/command-catalog.js +5 -2
  5. package/dist/lib/command-catalog.js.map +1 -1
  6. package/dist/lib/dashboard.js +1 -1
  7. package/dist/lib/discoveries.js +18 -6
  8. package/dist/lib/discoveries.js.map +1 -1
  9. package/dist/lib/ideas.js +2 -2
  10. package/dist/lib/ideas.js.map +1 -1
  11. package/dist/lib/update.js +6 -2
  12. package/dist/lib/update.js.map +1 -1
  13. package/dist/lib/workflow-state.js +9 -6
  14. package/dist/lib/workflow-state.js.map +1 -1
  15. package/dist/scripts/prepare-template.js +10 -2
  16. package/dist/scripts/prepare-template.js.map +1 -1
  17. package/package.json +1 -1
  18. package/template/.agents/skills/10-define/SKILL.md +1 -1
  19. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  20. package/template/.agents/skills/devflow/SKILL.md +9 -7
  21. package/template/.agents/skills/discovery/SKILL.md +75 -150
  22. package/template/.agents/skills/feature/SKILL.md +1 -0
  23. package/template/.agents/skills/grill/SKILL.md +93 -0
  24. package/template/.claude/skills/10-define/SKILL.md +1 -1
  25. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  26. package/template/.claude/skills/devflow/SKILL.md +9 -7
  27. package/template/.claude/skills/discovery/SKILL.md +75 -150
  28. package/template/.claude/skills/feature/SKILL.md +1 -0
  29. package/template/.claude/skills/grill/SKILL.md +93 -0
  30. package/template/AGENTS.md +6 -6
  31. package/template/devflow/context/ai-interaction.md +11 -0
  32. package/template/devflow/context/coding-standards.md +15 -1
  33. package/template/devflow/context/current-stage.md +1 -1
  34. package/template/devflow/decisions/.gitkeep +0 -0
  35. package/template/devflow/decisions/README.md +24 -0
  36. package/template/devflow/history/HISTORY.md +1 -1
  37. package/template/.agents/skills/00-explore/SKILL.md +0 -84
  38. package/template/.claude/skills/00-explore/SKILL.md +0 -84
@@ -1 +1 @@
1
- {"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jakkrichm/create-nexus-devflow",
3
- "version": "2.2.0",
3
+ "version": "2.2.1",
4
4
  "description": "Installer package for Nexus-DevFlow agentic workflow layer.",
5
5
  "license": "MIT",
6
6
  "author": "Jakkrich",
@@ -43,7 +43,7 @@ using:
43
43
  Require:
44
44
  - `Decision: Proceed`
45
45
  - `Approval Status: Approved`
46
- - A resolvable Discovery ID and `00-explore.md`
46
+ - A resolvable Discovery ID and `discovery.md` (or legacy `00-explore.md`)
47
47
 
48
48
  ### 3. Allocate Sequential ID
49
49
  - Inspect `devflow/history/HISTORY.md` and allocate sequential ID without prefix (e.g. `022-{slug}`).
@@ -58,5 +58,5 @@ Construct a structured evaluation table:
58
58
 
59
59
  ## Next Workflow Recommendation
60
60
 
61
- - **Primary**: `00-explore {discovery_id}` (if resuming discovery) or `10-define` / `feature` (if ready to specify)
61
+ - **Primary**: `discovery {discovery_id}` (if resuming discovery) or `10-define` / `feature` (if ready to specify)
62
62
  - **Inbox**: `idea` to record into `devflow/ideas.md`
@@ -23,7 +23,7 @@ Use this skill to guide the user on what to do next, inspect current workspace s
23
23
  Nexus-DevFlow supports two seamless workflow tracks:
24
24
  1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: `/spec` ➔ `/implement` ➔ `/check` ➔ `/complete`
25
25
  *Driven by a **Single Living Spec (`current-feature.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
26
- 2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `00-explore` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-deliver`
26
+ 2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `discovery` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-deliver`
27
27
  *Driven by modular separate stage files for large, high-stakes architectural epics and multi-agent coordination.*
28
28
 
29
29
  ---
@@ -45,14 +45,14 @@ When invoked without an argument (or when determining the next step), inspect:
45
45
  - If at `40-execute.md` with all tasks done -> Recommend `50-verify {RUNNING_ID}`.
46
46
  - If passed `50-verify.md` -> Recommend `60-report {RUNNING_ID}` then `70-deliver {RUNNING_ID}`.
47
47
  3. **Active Discovery**: Check `devflow/discoveries/` for open discovery notes.
48
- 4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx`.
48
+ 4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
49
49
  5. **Audit Findings Ledger**: Check `devflow/context/findings.md` for open high-severity findings.
50
50
 
51
51
  ### Default State Recommendations
52
52
  - if no run is active and user wants to start a feature -> Recommend `/feature <name>`.
53
53
  - If no run is active and user wants to fix a bug -> Recommend `/fix <bug>`.
54
- - If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx`.
55
- - If no run is active and user wants deep architectural exploration -> Recommend `00-explore`.
54
+ - If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
55
+ - If no run is active and user wants deep architectural exploration -> Recommend `discovery`.
56
56
  - If user asks to check system health -> Recommend `doctor`.
57
57
 
58
58
  ---
@@ -71,7 +71,7 @@ When invoked without an argument (or when determining the next step), inspect:
71
71
  | "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/spec` or `10-define` |
72
72
  | "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/spec` or `10-define` |
73
73
  | "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
74
- | "Explore a new request / deep idea" | `00-explore` | `discover` | **Deep-Track**: `00` -> `10` -> `20` -> ... |
74
+ | "Explore a new request / deep idea" | `discovery` | `discovery` / `/discovery` | **Deep-Track**: `discovery` -> `10` -> `20` -> ... |
75
75
  | "Define delivery boundaries and ID" | `10-define` | `define` | **Deep-Track**: `10` -> `20` -> `30` |
76
76
  | "Break down spec into plan (Deep)" | `30-plan` | `plan` | **Deep-Track**: `30` -> `40` -> `50` |
77
77
  | "Deep code implementation" | `40-execute` | `implement` | **Deep-Track**: `40` -> `50` |
@@ -84,6 +84,7 @@ When invoked without an argument (or when determining the next step), inspect:
84
84
  | "Pre-check scope & risks before spec" | `brief` | `brief` | Companion |
85
85
  | "Run autonomous bounded delivery loop"| `autopilot` | `autopilot` | Companion |
86
86
  | "Brainstorm ideas without ID" | `brainstorm` | `brainstorm` | Companion |
87
+ | "Socratic alignment / ADR / glossary" | `grill` | `/grill` / `align` | Companion (pre-spec / domain modeling) |
87
88
  | "Investigate failure or root cause" | `debug` | `debug` | Companion |
88
89
 
89
90
  ---
@@ -97,7 +98,7 @@ When invoked without an argument (or when determining the next step), inspect:
97
98
  - `complete` (`/complete`, `$complete`) - Safety pass, release digest, git merge, close run
98
99
 
99
100
  ### 2. Deep-Track (Architect Mode - 8 Steps)
100
- - `00-explore` - Explore request and decide Proceed/Defer/Reject
101
+ - `discovery` - Project roadmap planning or feature exploration before delivery commitment
101
102
  - `10-define` - Lock delivery boundaries and allocate Running ID
102
103
  - `20-spec` - Formalize markdown delivery contract
103
104
  - `30-plan` - Breakdown spec into phased tasks with test decisions
@@ -109,6 +110,8 @@ When invoked without an argument (or when determining the next step), inspect:
109
110
  ### 3. Public Companion Commands
110
111
  - `devflow` (`status`, `/devflow`) - Interactive guide, state inspector, and router
111
112
  - `idea` (`/idea`) - Quick idea capture and AI feasibility enrichment into `devflow/ideas.md`
113
+ - `grill` (`/grill`, `align`) - Codebase-grounded Socratic alignment, domain glossary, and ADR recorder
114
+ - `brainstorm` - Ideate and compare trade-off options without allocating running IDs
112
115
  - `report-html` (`/report:html`) - Standalone interactive HTML report dashboard generator
113
116
  - `onboard` - Baseline stack setup for freshly scaffolded projects
114
117
  - `adopt` - Bootstrap DevFlow into existing brownfield projects
@@ -118,6 +121,5 @@ When invoked without an argument (or when determining the next step), inspect:
118
121
  - `ci` - Automatic GitHub Actions workflow setup
119
122
  - `brief` - Read-only scope and risk pre-briefing
120
123
  - `autopilot` - Autonomous bounded delivery loop
121
- - `brainstorm` - Ideate without allocating running IDs
122
124
  - `debug` - Root cause investigation before or during implementation
123
125
  - `overview` - Living context synchronization into project-overview.md
@@ -1,166 +1,91 @@
1
1
  ---
2
2
  name: discovery
3
- description: "[devflow][B] Optional deep, multi-turn project discovery that helps the user develop detailed Blueprint project-plan.md and build-plan.md files through an adaptive conversation, then drafts them only after the user says they are ready. Use when the user explicitly runs /discovery or $discovery, asks for a guided planning interview, wants to think through a new product before writing the plans, or wants help deepening existing plans. Do not use merely because planning files are empty, after /onboard, or before /overview; users may always write the plans directly or create them through any conversation they prefer."
3
+ description: "[devflow][D] Unified discovery and exploration stage in DevFlow 2.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level exploration (Stage 00) before delivery commitment."
4
+ argument-hint: "[{title, request, IDEA-xxx, or discovery-id}]"
4
5
  ---
5
6
 
6
- # discovery - develop the plans through a deep conversation
7
+ # discovery - Unified Discovery & Pre-Delivery Exploration
7
8
 
8
- Where this can sit in the workflow:
9
+ $ARGUMENTS
9
10
 
10
- /onboard -> write the plans directly -> /overview
11
- \
12
- -> [discovery] -> review and approve plan drafts -> /overview
11
+ `/discovery` is the central discovery entry point in Nexus-DevFlow. It operates in two adaptive modes based on input scope:
12
+ 1. **🗺️ Macro Project Discovery**: Develops high-level product and build roadmap plans (`devflow/project-plan.md` & `devflow/build-plan.md`) through an adaptive conversation before `/overview`.
13
+ 2. **🔍 Micro Feature Exploration (Stage 00)**: Explores a specific feature, request, or idea before committing to delivery, routes through supporting lenses, and finishes with a visible `Proceed`, `Defer`, or `Reject` decision before `10-define`.
13
14
 
14
- `/discovery` is an optional planning partner, not a required workflow gate and
15
- not a quick questionnaire. It can span as many turns as the project needs. Its
16
- job is to help the user think through the product, preserve the depth and nuance
17
- of that conversation, and draft the two user-owned planning files only when the
18
- user asks for drafts.
15
+ ---
16
+
17
+ ## Invocations & Usage
19
18
 
20
- Running `/onboard` never starts this skill. Empty plans never require it. A user
21
- who writes detailed plans manually, has another AI conversation, or arrives with
22
- finished plans continues directly to `/overview` exactly as before.
19
+ ```text
20
+ # 1. Macro Project Planning Mode (No arguments or project scope)
21
+ /discovery
22
+ /discovery --project
23
23
 
24
- ## Step 1 - establish the starting point
24
+ # 2. Micro Feature Exploration Mode (Stage 00 of Deep-Track)
25
+ /discovery {title or request}
26
+ /discovery IDEA-xxx
27
+ /discovery {discovery-id}
28
+ ```
25
29
 
26
- Read only the planning and project facts needed for the conversation:
30
+ ---
27
31
 
28
- - `devflow/project-plan.md`
29
- - `devflow/build-plan.md`
30
- - the root project manifest, README, and framework configuration when they
31
- already contain relevant facts
32
- - `devflow/context/project-overview.md` only when the user is revisiting an
33
- established project's direction
32
+ ## Mode 1: Macro Project Discovery (Roadmap & System Planning)
34
33
 
35
- Classify each planning file as a template, partial draft, or substantive plan.
36
- Never treat existing user content as disposable. When either plan has real
37
- content, summarize what it already establishes and ask whether the user wants to
38
- deepen it, revise a specific direction, or use it unchanged as conversation
39
- context. Do not replace it with a fresh generic plan.
34
+ Use when:
35
+ - Starting a new product or shaping high-level architecture across the entire repository.
36
+ - Revisiting the overall project vision, major milestones, or tech stack before generating `/overview`.
40
37
 
41
- Start with a short working hypothesis about the project and name the most
42
- important unknown. Then ask one focused question. Do not draft either plan yet.
38
+ ### Process:
39
+ 1. **Establish Baseline**: Read `devflow/project-plan.md` and `devflow/build-plan.md` (if present).
40
+ 2. **Adaptive Conversation**: Ask 1-2 focused questions at a time covering problem space, user workflows, MVP boundaries, non-goals, data models, and stack constraints.
41
+ 3. **Periodic Snapshots**: Provide compact summaries of confirmed decisions, working assumptions, and open TODOs.
42
+ 4. **Draft Plans Behind Approval Gate**: Draft proposed `project-plan.md` and `build-plan.md` only when the user explicitly requests drafts.
43
+ 5. **Write on Approval**: Write approved files and recommend `/overview` as the next step.
43
44
 
44
- ## Step 2 - run adaptive discovery
45
+ ---
46
+
47
+ ## Mode 2: Micro Feature Exploration (Stage 00 of Deep-Track)
48
+
49
+ Use when:
50
+ - Exploring a specific feature, complex architectural change, or pending idea (`/discovery IDEA-xxx`).
51
+ - The team needs to evaluate feasibility, options, domain glossary, or root causes before locking delivery scope.
52
+
53
+ ### Markdown-First Contract:
54
+ Write the primary discovery artifact to:
55
+ ```text
56
+ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
57
+ ```
58
+ *(A Discovery ID uses the namespace `DISC-YYYYMMDD-NNN`. It is not a Running ID and does not reserve a numeric delivery run.)*
59
+
60
+ ### 5 Supporting Routes & Built-in Lenses:
61
+
62
+ 1. **Brainstorming Lens (Divergent & Convergent)**:
63
+ - Formulate 2-3 viable options with trade-offs.
64
+ - Construct a **Trade-off Comparison Table** (Pros, Cons, Recommendation).
65
+ 2. **Research & Empirical Proof Lens**:
66
+ - Inspect existing codebase patterns with search tools (`grep_search`, `rg`).
67
+ - Conduct external web search if library feasibility or API contracts are uncertain.
68
+ 3. **PRD & Scoping Lens**:
69
+ - Problem Statement, Target Persona, Core User Stories, and In-Scope vs. Out-of-Scope boundaries.
70
+ 4. **Issue & Bug Triage Lens**:
71
+ - Classify severity (`Critical/Blocker`, `Major`, `Minor`) and determine whether root-cause analysis (`debug`) is required.
72
+ 5. **Socratic Grilling & Domain Alignment Lens (`grill`)**:
73
+ - Codebase-grounded interactive inquiry to clarify entity boundaries, data flows, and edge cases.
74
+ - Record agreed terminology in `devflow/context/glossary.md` and major architecture decisions in `devflow/decisions/ADR-xxx-{slug}.md`.
75
+
76
+ ### Decision & Approval Gate:
77
+ Set one visible decision:
78
+ - `Proceed`: Enough value and evidence exist to define delivery work:
79
+ - **🏎️ Fast-Track (Recommended for 85% of standard features/fixes)**: Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` (writes `devflow/context/current-feature.md`).
80
+ - **🏗️ Deep-Track (For large architectural epics/migrations)**: Handoff to `10-define {discovery_id}` (writes `devflow/context/current-run/10-define.md`).
81
+ - `Defer`: The idea remains relevant but timing or evidence is not ready.
82
+ - `Reject`: The idea should not proceed under current framing.
83
+
84
+ ---
45
85
 
46
- Ask one meaningful question at a time and let each answer shape the next one.
47
- Prefer a likely interpretation the user can correct over a vague request for
48
- more detail. Explain a tradeoff when the answer would materially change scope,
49
- architecture, cost, or build order.
86
+ ## Next Workflow Recommendations
50
87
 
51
- Cover the areas that matter to this project, not a fixed questionnaire:
52
-
53
- - problem, desired outcome, and why the project should exist
54
- - target users, their context, and their primary workflows
55
- - MVP capabilities, explicit non-goals, and later possibilities
56
- - business rules, data, integrations, permissions, and important edge cases
57
- - stack choices, constraints, dependencies, and technical unknowns
58
- - UI/UX direction, accessibility needs, and useful references
59
- - monetization or business model when relevant
60
- - deployment shape, environments, background work, storage, and operations
61
- - risks, assumptions, unresolved decisions, and how success will be judged
62
- - feature boundaries, dependencies, and a sensible build order
63
-
64
- Depth is the goal. Follow a consequential answer until its implications are
65
- clear instead of racing to the next category. Do not ask the user to repeat facts
66
- already established in the conversation or repository. Do not force irrelevant
67
- topics merely to complete a checklist.
68
-
69
- Periodically return a compact discovery snapshot with:
70
-
71
- - confirmed decisions
72
- - working assumptions that still need confirmation
73
- - open questions or conflicts
74
- - ideas explicitly deferred or excluded
75
-
76
- The snapshot keeps a long conversation coherent. It is not permission to write
77
- the plans.
78
-
79
- ## Step 3 - decide whether the plans are ready
80
-
81
- Do not end discovery because a preset number of questions has been reached. It
82
- is ready to draft when:
83
-
84
- - the problem, users, and core workflows are concrete
85
- - MVP scope and non-goals are distinguishable
86
- - data and technical choices are detailed enough to expose major dependencies
87
- - the build order can be expressed as feature-sized outcomes
88
- - important contradictions are resolved
89
- - remaining unknowns are either safe to defer or explicitly accepted as TODOs
90
- - the user says they are ready for the plans to be drafted
91
-
92
- If the user asks for drafts while a material gap remains, name the gap and ask
93
- whether to continue discovery or preserve it as an explicit TODO. Respect the
94
- choice. The user may also stop at any time and write the plans manually.
95
-
96
- ## Step 4 - draft both planning files
97
-
98
- When the user asks for drafts, produce complete proposed contents for both files
99
- without writing them yet.
100
-
101
- For `devflow/project-plan.md`:
102
-
103
- - keep the template's main subject areas, adding useful sections when the
104
- conversation requires them
105
- - preserve rationale, examples, tradeoffs, constraints, edge cases, and
106
- exclusions that will matter during later feature work
107
- - be as detailed as the project needs; never compress a rich discovery into a
108
- line or two per section
109
- - distinguish confirmed decisions from assumptions and TODOs
110
-
111
- For `devflow/build-plan.md`:
112
-
113
- - use numbered checkboxes and optional milestone headings
114
- - keep each item a high-level, feature-sized outcome with a concise description
115
- - order items by dependency and the earliest useful vertical slice
116
- - keep implementation detail in later `/feature` specs rather than turning the
117
- roadmap into a task dump
118
- - include only agreed scope; place deferred ideas outside the MVP or omit them as
119
- the user directed
120
-
121
- If substantive plans already exist, preserve their information and completed
122
- build-plan numbering. Clearly identify proposed additions, removals, or changed
123
- decisions.
124
-
125
- End by asking the user to review the full drafts. Do not write either file in the
126
- same response that first presents them.
127
-
128
- ## Step 5 - write only after approval
129
-
130
- Write the approved drafts only after the user explicitly approves them. If the
131
- user requests changes, revise the drafts and show the affected sections again
132
- before writing.
133
-
134
- After writing:
135
-
136
- - report which files changed
137
- - list any retained TODOs or unresolved decisions
138
- - remind the user that both files remain theirs to edit and deepen directly
139
- - stop before generating `devflow/context/project-overview.md`
140
- - point to `/overview` or `$overview` as the next optional command when the user
141
- is satisfied with the plans
142
-
143
- ## Rules
144
-
145
- - This skill is always optional. Never make it a prerequisite for `/overview`,
146
- `/feature`, or any other Blueprint command.
147
- - Never start it automatically from `/onboard`, because planning files are
148
- empty, or because a project is new.
149
- - Never imply that plans created manually or through another conversation are
150
- inferior or incomplete merely because this skill was not used.
151
- - Never overwrite substantive planning content without showing the replacement
152
- and receiving explicit approval.
153
- - Never write plans during the interview or after a vague signal such as "looks
154
- good." The user must explicitly approve the proposed file contents.
155
- - Never scaffold the app, edit product code, generate the overview, create a
156
- feature spec, commit, merge, push, or deploy.
157
- - Preserve detailed project reasoning in `project-plan.md`, while keeping
158
- `build-plan.md` high-level and trackable.
159
- - Keep the conversation adaptive. Depth comes from relevant follow-up questions,
160
- not from mechanically asking every possible question.
161
-
162
- ## Formatting
163
-
164
- Follow `devflow/context/ai-interaction.md`. During discovery, ask one focused
165
- question per turn. For snapshots and draft reviews, use concise headings and
166
- lists so confirmed decisions and remaining gaps are easy to inspect.
88
+ - **From Macro Project Mode**: Run `/overview` to compile context into `devflow/context/project-overview.md`.
89
+ - **From Micro Stage 00 (Approved Proceed ➔ Fast-Track)**: Run `/feature {discovery_id}` to start lean living spec.
90
+ - **From Micro Stage 00 (Approved Proceed Deep-Track)**: Run `10-define {discovery_id}` to allocate a Running ID.
91
+ - **From Micro Stage 00 (Defer / Reject)**: No next command needed.
@@ -32,6 +32,7 @@ big item has been split into sub-items, the next unchecked sub-item is the targe
32
32
 
33
33
  ## Step 1 - pick the target
34
34
 
35
+ - Given a Discovery ID or Idea ID (e.g. `/feature DISC-20260824-001` or `/feature IDEA-001`) -> import problem context, research, trade-offs, and ADRs from `devflow/discoveries/{DISC-ID}/discovery.md` or `devflow/ideas.md` into the living spec.
35
36
  - Given a number or name that matches a build-plan item -> use it.
36
37
  - Given a request that clearly describes a new feature with no reasonable match
37
38
  in the build plan -> follow **New-feature intake** below.
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: grill
3
+ description: "[devflow][B] Interactive Socratic alignment & domain modeling - stress-test plans, extract domain glossary, and record architecture decision records (ADRs) before delivery."
4
+ argument-hint: "{topic, plan, or question}"
5
+ ---
6
+
7
+ # grill - Socratic Alignment & Domain Modeling
8
+
9
+ $ARGUMENTS
10
+
11
+ Use this skill to conduct a codebase-grounded, interactive Socratic interview with the user. It clarifies domain vocabulary, resolves architectural ambiguities, and prevents misalignment before writing specifications or code.
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/grill {topic or plan}`: Standard slash command in Claude Code, Google Antigravity, and Gemini CLI
16
+ - `grill {topic or plan}`: Plain text invocation
17
+ - `$grill {topic or plan}`: Codex CLI invocation
18
+ - `/align {topic}`: Alias for domain alignment
19
+
20
+ ## Core Philosophy: Align Before You Build
21
+
22
+ 1. **Codebase-Grounded**: Read existing code and context first. Never ask questions the codebase can already answer.
23
+ 2. **One Round at a Time**: Ask 1-2 focused, high-leverage questions per round with clear recommended defaults. Never dump a wall of 10 questions.
24
+ 3. **Lazy Inline Persistence**:
25
+ - Write agreed domain terminology to `devflow/context/glossary.md` the moment each term resolves.
26
+ - Record significant, hard-to-reverse technical decisions as ADRs in `devflow/decisions/ADR-xxx-{slug}.md`.
27
+ 4. **Zero Assumptions**: Challenge ambiguities, contradictory requirements, and naming inconsistencies upfront.
28
+
29
+ ---
30
+
31
+ ## Process & Execution Loop
32
+
33
+ ### 1. Grounding Phase (Silent Inspection)
34
+ Before asking the first question:
35
+ - Read `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`.
36
+ - Inspect existing domain terms in `devflow/context/glossary.md` (if present).
37
+ - Search codebase patterns (`grep_search` / `rg`) related to the topic to ground technical reality.
38
+
39
+ ### 2. Interactive Socratic Interview Loop
40
+ In each turn:
41
+ - Identify the most critical unresolved branch in the design tree:
42
+ - **Domain Language & Boundaries**: "What exactly is an Entity X versus Entity Y in this context?"
43
+ - **Data Flow & Contracts**: "Who owns state X? Synchronous vs. asynchronous?"
44
+ - **Edge Cases & Failure Modes**: "What happens on network failure, concurrent mutation, or invalid input?"
45
+ - **Irreversible Trade-offs**: "Database schema change vs. application-layer adapter?"
46
+ - Ask **1-2 questions maximum** per turn.
47
+ - Always provide a recommended default with concise technical rationale.
48
+ - Wait for the user's answer.
49
+
50
+ ### 3. Immediate State Persistence
51
+
52
+ #### A. Domain Glossary (`devflow/context/glossary.md`)
53
+ When a domain term or conceptual definition crystallizes, immediately create or append to `devflow/context/glossary.md`:
54
+
55
+ ```markdown
56
+ ### [Term / Concept]
57
+ - **Definition**: Clear, unambiguous definition within this project.
58
+ - **Constraints**: Invariants, boundaries, or lifecycle rules.
59
+ - **Aliases / Related**: Related terms or common misnomers.
60
+ ```
61
+
62
+ #### B. Architecture Decision Records (`devflow/decisions/ADR-xxx-{slug}.md`)
63
+ When a decision meets the 3 ADR criteria:
64
+ 1. **Significant Impact**: Affects architecture, data schema, security, or public API.
65
+ 2. **Hard to Reverse**: Changing it later requires painful migration or refactoring.
66
+ 3. **Multiple Viable Alternatives**: There were real trade-offs between 2+ options.
67
+
68
+ Allocate the next sequential ID (`ADR-001`, `ADR-002`, ...) and create `devflow/decisions/ADR-xxx-{slug}.md`:
69
+
70
+ ```markdown
71
+ # ADR-xxx: {Title}
72
+
73
+ - **Status**: Accepted
74
+ - **Date**: {YYYY-MM-DD}
75
+ - **Context**: {Why was this decision needed? What problem does it solve?}
76
+ - **Decision**: {What did we decide to do?}
77
+ - **Alternatives Considered**:
78
+ - *Option 1*: {Pros / Cons}
79
+ - *Option 2*: {Pros / Cons}
80
+ - **Consequences**:
81
+ - *Positive*: {Benefits gained}
82
+ - *Trade-offs / Risks*: {Costs, constraints, or follow-ups}
83
+ ```
84
+
85
+ ---
86
+
87
+ ## 4. Closing & Handoff
88
+
89
+ When all design branches are resolved:
90
+ 1. Summarize settled domain terms and created ADRs.
91
+ 2. Provide explicit next command recommendations:
92
+ - **Fast-Track (Standard Features/Fixes)**: Run `/feature {topic}` or `/fix {topic}` to immediately start the living spec.
93
+ - **Deep-Track (Large Architectural Epics)**: Run `10-define` or `/discovery` with the discovery context.
@@ -43,7 +43,7 @@ using:
43
43
  Require:
44
44
  - `Decision: Proceed`
45
45
  - `Approval Status: Approved`
46
- - A resolvable Discovery ID and `00-explore.md`
46
+ - A resolvable Discovery ID and `discovery.md` (or legacy `00-explore.md`)
47
47
 
48
48
  ### 3. Allocate Sequential ID
49
49
  - Inspect `devflow/history/HISTORY.md` and allocate sequential ID without prefix (e.g. `022-{slug}`).
@@ -58,5 +58,5 @@ Construct a structured evaluation table:
58
58
 
59
59
  ## Next Workflow Recommendation
60
60
 
61
- - **Primary**: `00-explore {discovery_id}` (if resuming discovery) or `10-define` / `feature` (if ready to specify)
61
+ - **Primary**: `discovery {discovery_id}` (if resuming discovery) or `10-define` / `feature` (if ready to specify)
62
62
  - **Inbox**: `idea` to record into `devflow/ideas.md`
@@ -23,7 +23,7 @@ Use this skill to guide the user on what to do next, inspect current workspace s
23
23
  Nexus-DevFlow supports two seamless workflow tracks:
24
24
  1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: `/spec` ➔ `/implement` ➔ `/check` ➔ `/complete`
25
25
  *Driven by a **Single Living Spec (`current-feature.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
26
- 2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `00-explore` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-deliver`
26
+ 2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `discovery` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-deliver`
27
27
  *Driven by modular separate stage files for large, high-stakes architectural epics and multi-agent coordination.*
28
28
 
29
29
  ---
@@ -45,14 +45,14 @@ When invoked without an argument (or when determining the next step), inspect:
45
45
  - If at `40-execute.md` with all tasks done -> Recommend `50-verify {RUNNING_ID}`.
46
46
  - If passed `50-verify.md` -> Recommend `60-report {RUNNING_ID}` then `70-deliver {RUNNING_ID}`.
47
47
  3. **Active Discovery**: Check `devflow/discoveries/` for open discovery notes.
48
- 4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx`.
48
+ 4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
49
49
  5. **Audit Findings Ledger**: Check `devflow/context/findings.md` for open high-severity findings.
50
50
 
51
51
  ### Default State Recommendations
52
52
  - if no run is active and user wants to start a feature -> Recommend `/feature <name>`.
53
53
  - If no run is active and user wants to fix a bug -> Recommend `/fix <bug>`.
54
- - If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx`.
55
- - If no run is active and user wants deep architectural exploration -> Recommend `00-explore`.
54
+ - If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
55
+ - If no run is active and user wants deep architectural exploration -> Recommend `discovery`.
56
56
  - If user asks to check system health -> Recommend `doctor`.
57
57
 
58
58
  ---
@@ -71,7 +71,7 @@ When invoked without an argument (or when determining the next step), inspect:
71
71
  | "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/spec` or `10-define` |
72
72
  | "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/spec` or `10-define` |
73
73
  | "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
74
- | "Explore a new request / deep idea" | `00-explore` | `discover` | **Deep-Track**: `00` -> `10` -> `20` -> ... |
74
+ | "Explore a new request / deep idea" | `discovery` | `discovery` / `/discovery` | **Deep-Track**: `discovery` -> `10` -> `20` -> ... |
75
75
  | "Define delivery boundaries and ID" | `10-define` | `define` | **Deep-Track**: `10` -> `20` -> `30` |
76
76
  | "Break down spec into plan (Deep)" | `30-plan` | `plan` | **Deep-Track**: `30` -> `40` -> `50` |
77
77
  | "Deep code implementation" | `40-execute` | `implement` | **Deep-Track**: `40` -> `50` |
@@ -84,6 +84,7 @@ When invoked without an argument (or when determining the next step), inspect:
84
84
  | "Pre-check scope & risks before spec" | `brief` | `brief` | Companion |
85
85
  | "Run autonomous bounded delivery loop"| `autopilot` | `autopilot` | Companion |
86
86
  | "Brainstorm ideas without ID" | `brainstorm` | `brainstorm` | Companion |
87
+ | "Socratic alignment / ADR / glossary" | `grill` | `/grill` / `align` | Companion (pre-spec / domain modeling) |
87
88
  | "Investigate failure or root cause" | `debug` | `debug` | Companion |
88
89
 
89
90
  ---
@@ -97,7 +98,7 @@ When invoked without an argument (or when determining the next step), inspect:
97
98
  - `complete` (`/complete`, `$complete`) - Safety pass, release digest, git merge, close run
98
99
 
99
100
  ### 2. Deep-Track (Architect Mode - 8 Steps)
100
- - `00-explore` - Explore request and decide Proceed/Defer/Reject
101
+ - `discovery` - Project roadmap planning or feature exploration before delivery commitment
101
102
  - `10-define` - Lock delivery boundaries and allocate Running ID
102
103
  - `20-spec` - Formalize markdown delivery contract
103
104
  - `30-plan` - Breakdown spec into phased tasks with test decisions
@@ -109,6 +110,8 @@ When invoked without an argument (or when determining the next step), inspect:
109
110
  ### 3. Public Companion Commands
110
111
  - `devflow` (`status`, `/devflow`) - Interactive guide, state inspector, and router
111
112
  - `idea` (`/idea`) - Quick idea capture and AI feasibility enrichment into `devflow/ideas.md`
113
+ - `grill` (`/grill`, `align`) - Codebase-grounded Socratic alignment, domain glossary, and ADR recorder
114
+ - `brainstorm` - Ideate and compare trade-off options without allocating running IDs
112
115
  - `report-html` (`/report:html`) - Standalone interactive HTML report dashboard generator
113
116
  - `onboard` - Baseline stack setup for freshly scaffolded projects
114
117
  - `adopt` - Bootstrap DevFlow into existing brownfield projects
@@ -118,6 +121,5 @@ When invoked without an argument (or when determining the next step), inspect:
118
121
  - `ci` - Automatic GitHub Actions workflow setup
119
122
  - `brief` - Read-only scope and risk pre-briefing
120
123
  - `autopilot` - Autonomous bounded delivery loop
121
- - `brainstorm` - Ideate without allocating running IDs
122
124
  - `debug` - Root cause investigation before or during implementation
123
125
  - `overview` - Living context synchronization into project-overview.md