@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.
- package/README.md +1 -1
- package/dist/bin/create-nexus-devflow.js +1 -1
- package/dist/bin/create-nexus-devflow.js.map +1 -1
- package/dist/lib/command-catalog.js +5 -2
- package/dist/lib/command-catalog.js.map +1 -1
- package/dist/lib/dashboard.js +1 -1
- package/dist/lib/discoveries.js +18 -6
- package/dist/lib/discoveries.js.map +1 -1
- package/dist/lib/ideas.js +2 -2
- package/dist/lib/ideas.js.map +1 -1
- package/dist/lib/update.js +6 -2
- package/dist/lib/update.js.map +1 -1
- package/dist/lib/workflow-state.js +9 -6
- package/dist/lib/workflow-state.js.map +1 -1
- package/dist/scripts/prepare-template.js +10 -2
- package/dist/scripts/prepare-template.js.map +1 -1
- package/package.json +1 -1
- package/template/.agents/skills/10-define/SKILL.md +1 -1
- package/template/.agents/skills/brainstorm/SKILL.md +1 -1
- package/template/.agents/skills/devflow/SKILL.md +9 -7
- package/template/.agents/skills/discovery/SKILL.md +75 -150
- package/template/.agents/skills/feature/SKILL.md +1 -0
- package/template/.agents/skills/grill/SKILL.md +93 -0
- package/template/.claude/skills/10-define/SKILL.md +1 -1
- package/template/.claude/skills/brainstorm/SKILL.md +1 -1
- package/template/.claude/skills/devflow/SKILL.md +9 -7
- package/template/.claude/skills/discovery/SKILL.md +75 -150
- package/template/.claude/skills/feature/SKILL.md +1 -0
- package/template/.claude/skills/grill/SKILL.md +93 -0
- package/template/AGENTS.md +6 -6
- package/template/devflow/context/ai-interaction.md +11 -0
- package/template/devflow/context/coding-standards.md +15 -1
- package/template/devflow/context/current-stage.md +1 -1
- package/template/devflow/decisions/.gitkeep +0 -0
- package/template/devflow/decisions/README.md +24 -0
- package/template/devflow/history/HISTORY.md +1 -1
- package/template/.agents/skills/00-explore/SKILL.md +0 -84
- 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
|
@@ -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**: `
|
|
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)**: `
|
|
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 `
|
|
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" | `
|
|
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
|
-
- `
|
|
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][
|
|
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 -
|
|
7
|
+
# discovery - Unified Discovery & Pre-Delivery Exploration
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
$ARGUMENTS
|
|
9
10
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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
|
-
|
|
21
|
-
|
|
22
|
-
|
|
19
|
+
```text
|
|
20
|
+
# 1. Macro Project Planning Mode (No arguments or project scope)
|
|
21
|
+
/discovery
|
|
22
|
+
/discovery --project
|
|
23
23
|
|
|
24
|
-
|
|
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
|
-
|
|
30
|
+
---
|
|
27
31
|
|
|
28
|
-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
-
|
|
42
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
52
|
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
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**: `
|
|
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)**: `
|
|
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 `
|
|
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" | `
|
|
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
|
-
- `
|
|
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
|