@jakkrichm/create-nexus-devflow 2.0.8 → 2.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/package.json +2 -2
  2. package/template/.agents/skills/00-discover/SKILL.md +1 -1
  3. package/template/.agents/skills/10-define/SKILL.md +1 -1
  4. package/template/.agents/skills/20-spec/SKILL.md +1 -1
  5. package/template/.agents/skills/30-plan/SKILL.md +1 -1
  6. package/template/.agents/skills/40-implement/SKILL.md +1 -1
  7. package/template/.agents/skills/50-verify/SKILL.md +1 -1
  8. package/template/.agents/skills/60-report/SKILL.md +1 -1
  9. package/template/.agents/skills/70-release/SKILL.md +1 -1
  10. package/template/.agents/skills/adopt/SKILL.md +1 -1
  11. package/template/.agents/skills/agent/SKILL.md +1 -1
  12. package/template/.agents/skills/api-and-interface-design/SKILL.md +1 -1
  13. package/template/.agents/skills/app-builder/SKILL.md +1 -1
  14. package/template/.agents/skills/architecture/SKILL.md +1 -1
  15. package/template/.agents/skills/autopilot/SKILL.md +175 -0
  16. package/template/.agents/skills/bash-linux/SKILL.md +1 -1
  17. package/template/.agents/skills/behavioral-modes/SKILL.md +1 -1
  18. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  19. package/template/.agents/skills/brief/SKILL.md +77 -0
  20. package/template/.agents/skills/browser-testing-with-devtools/SKILL.md +1 -1
  21. package/template/.agents/skills/changelog/SKILL.md +1 -1
  22. package/template/.agents/skills/ci/SKILL.md +131 -0
  23. package/template/.agents/skills/ci-cd-and-automation/SKILL.md +1 -1
  24. package/template/.agents/skills/code-review-and-quality/SKILL.md +1 -1
  25. package/template/.agents/skills/code-simplification/SKILL.md +1 -1
  26. package/template/.agents/skills/codebase-design/SKILL.md +1 -1
  27. package/template/.agents/skills/commit/SKILL.md +1 -1
  28. package/template/.agents/skills/competitor-analysis/SKILL.md +1 -1
  29. package/template/.agents/skills/context-engineering/SKILL.md +1 -1
  30. package/template/.agents/skills/database-design/SKILL.md +1 -1
  31. package/template/.agents/skills/debug/SKILL.md +1 -1
  32. package/template/.agents/skills/debugging-and-error-recovery/SKILL.md +1 -1
  33. package/template/.agents/skills/deploy/SKILL.md +1 -1
  34. package/template/.agents/skills/deployment-procedures/SKILL.md +1 -1
  35. package/template/.agents/skills/deprecation-and-migration/SKILL.md +1 -1
  36. package/template/.agents/skills/devflow/SKILL.md +11 -1
  37. package/template/.agents/skills/diagnosing-bugs/SKILL.md +1 -1
  38. package/template/.agents/skills/doctor/SKILL.md +1 -1
  39. package/template/.agents/skills/documentation-and-adrs/SKILL.md +1 -1
  40. package/template/.agents/skills/domain-modeling/SKILL.md +1 -1
  41. package/template/.agents/skills/followup/SKILL.md +1 -1
  42. package/template/.agents/skills/frontend-ui-engineering/SKILL.md +1 -1
  43. package/template/.agents/skills/git-workflow-and-versioning/SKILL.md +1 -1
  44. package/template/.agents/skills/goal/SKILL.md +1 -1
  45. package/template/.agents/skills/handoff/SKILL.md +1 -1
  46. package/template/.agents/skills/help/SKILL.md +1 -1
  47. package/template/.agents/skills/human-review-decisions/SKILL.md +1 -1
  48. package/template/.agents/skills/i18n-localization/SKILL.md +1 -1
  49. package/template/.agents/skills/idea-refine/SKILL.md +1 -1
  50. package/template/.agents/skills/incremental-implementation/SKILL.md +1 -1
  51. package/template/.agents/skills/insight/SKILL.md +1 -1
  52. package/template/.agents/skills/insight-capture/SKILL.md +1 -1
  53. package/template/.agents/skills/intelligent-routing/SKILL.md +1 -1
  54. package/template/.agents/skills/issue-triage/SKILL.md +1 -1
  55. package/template/.agents/skills/lint-and-validate/SKILL.md +1 -1
  56. package/template/.agents/skills/mcp-builder/SKILL.md +1 -1
  57. package/template/.agents/skills/md2html/SKILL.md +1 -1
  58. package/template/.agents/skills/merge/SKILL.md +1 -1
  59. package/template/.agents/skills/mobile-design/SKILL.md +1 -1
  60. package/template/.agents/skills/nextjs-react-expert/SKILL.md +1 -1
  61. package/template/.agents/skills/nodejs-best-practices/SKILL.md +1 -1
  62. package/template/.agents/skills/onboard/SKILL.md +1 -1
  63. package/template/.agents/skills/package-json-generator/SKILL.md +1 -1
  64. package/template/.agents/skills/parallel-agents/SKILL.md +1 -1
  65. package/template/.agents/skills/performance-optimization/SKILL.md +1 -1
  66. package/template/.agents/skills/planning-and-task-breakdown/SKILL.md +1 -1
  67. package/template/.agents/skills/powershell-windows/SKILL.md +1 -1
  68. package/template/.agents/skills/pr/SKILL.md +1 -1
  69. package/template/.agents/skills/pr-review/SKILL.md +1 -1
  70. package/template/.agents/skills/pr-review-analysis/SKILL.md +1 -1
  71. package/template/.agents/skills/prd/SKILL.md +1 -1
  72. package/template/.agents/skills/preview/SKILL.md +1 -1
  73. package/template/.agents/skills/preview-local-check/SKILL.md +1 -1
  74. package/template/.agents/skills/prototype/SKILL.md +1 -1
  75. package/template/.agents/skills/python-patterns/SKILL.md +1 -1
  76. package/template/.agents/skills/release-git-operations/SKILL.md +1 -1
  77. package/template/.agents/skills/research/SKILL.md +1 -1
  78. package/template/.agents/skills/review/SKILL.md +1 -1
  79. package/template/.agents/skills/review-followup-routing/SKILL.md +1 -1
  80. package/template/.agents/skills/roadmap-strategy/SKILL.md +1 -1
  81. package/template/.agents/skills/rollback/SKILL.md +108 -0
  82. package/template/.agents/skills/security-and-hardening/SKILL.md +1 -1
  83. package/template/.agents/skills/security-review/SKILL.md +1 -1
  84. package/template/.agents/skills/seo-fundamentals/SKILL.md +1 -1
  85. package/template/.agents/skills/server-management/SKILL.md +1 -1
  86. package/template/.agents/skills/shipping-and-launch/SKILL.md +1 -1
  87. package/template/.agents/skills/silent-failure-audit/SKILL.md +1 -1
  88. package/template/.agents/skills/simplify/SKILL.md +1 -1
  89. package/template/.agents/skills/skill-development/SKILL.md +1 -1
  90. package/template/.agents/skills/spec-driven-development/SKILL.md +1 -1
  91. package/template/.agents/skills/spec-orchestration/SKILL.md +1 -1
  92. package/template/.agents/skills/specialist-agent-routing/SKILL.md +1 -1
  93. package/template/.agents/skills/tailwind-patterns/SKILL.md +1 -1
  94. package/template/.agents/skills/test/SKILL.md +1 -1
  95. package/template/.agents/skills/test-driven-development/SKILL.md +1 -1
  96. package/template/.agents/skills/test-execution-and-coverage/SKILL.md +1 -1
  97. package/template/.agents/skills/try/SKILL.md +108 -0
  98. package/template/.agents/skills/type-design/SKILL.md +1 -1
  99. package/template/.agents/skills/ui-ux-pro-max/SKILL.md +1 -1
  100. package/template/.agents/skills/using-agent-skills/SKILL.md +1 -1
  101. package/template/.agents/skills/verification-orchestration/SKILL.md +1 -1
  102. package/template/.agents/skills/vulnerability-scanner/SKILL.md +1 -1
  103. package/template/.agents/skills/wiki/SKILL.md +1 -1
  104. package/template/.agents/skills/workflow-documentation-sync/SKILL.md +1 -1
  105. package/template/.claude/skills/00-discover/SKILL.md +1 -1
  106. package/template/.claude/skills/10-define/SKILL.md +1 -1
  107. package/template/.claude/skills/20-spec/SKILL.md +1 -1
  108. package/template/.claude/skills/30-plan/SKILL.md +1 -1
  109. package/template/.claude/skills/40-implement/SKILL.md +1 -1
  110. package/template/.claude/skills/50-verify/SKILL.md +1 -1
  111. package/template/.claude/skills/60-report/SKILL.md +1 -1
  112. package/template/.claude/skills/70-release/SKILL.md +1 -1
  113. package/template/.claude/skills/adopt/SKILL.md +1 -1
  114. package/template/.claude/skills/agent/SKILL.md +1 -1
  115. package/template/.claude/skills/api-and-interface-design/SKILL.md +1 -1
  116. package/template/.claude/skills/app-builder/SKILL.md +1 -1
  117. package/template/.claude/skills/architecture/SKILL.md +1 -1
  118. package/template/.claude/skills/autopilot/SKILL.md +175 -0
  119. package/template/.claude/skills/bash-linux/SKILL.md +1 -1
  120. package/template/.claude/skills/behavioral-modes/SKILL.md +1 -1
  121. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  122. package/template/.claude/skills/brief/SKILL.md +77 -0
  123. package/template/.claude/skills/browser-testing-with-devtools/SKILL.md +1 -1
  124. package/template/.claude/skills/changelog/SKILL.md +1 -1
  125. package/template/.claude/skills/ci/SKILL.md +131 -0
  126. package/template/.claude/skills/ci-cd-and-automation/SKILL.md +1 -1
  127. package/template/.claude/skills/code-review-and-quality/SKILL.md +1 -1
  128. package/template/.claude/skills/code-simplification/SKILL.md +1 -1
  129. package/template/.claude/skills/codebase-design/SKILL.md +1 -1
  130. package/template/.claude/skills/commit/SKILL.md +1 -1
  131. package/template/.claude/skills/competitor-analysis/SKILL.md +1 -1
  132. package/template/.claude/skills/context-engineering/SKILL.md +1 -1
  133. package/template/.claude/skills/database-design/SKILL.md +1 -1
  134. package/template/.claude/skills/debug/SKILL.md +1 -1
  135. package/template/.claude/skills/debugging-and-error-recovery/SKILL.md +1 -1
  136. package/template/.claude/skills/deploy/SKILL.md +1 -1
  137. package/template/.claude/skills/deployment-procedures/SKILL.md +1 -1
  138. package/template/.claude/skills/deprecation-and-migration/SKILL.md +1 -1
  139. package/template/.claude/skills/devflow/SKILL.md +11 -1
  140. package/template/.claude/skills/diagnosing-bugs/SKILL.md +1 -1
  141. package/template/.claude/skills/doctor/SKILL.md +1 -1
  142. package/template/.claude/skills/documentation-and-adrs/SKILL.md +1 -1
  143. package/template/.claude/skills/domain-modeling/SKILL.md +1 -1
  144. package/template/.claude/skills/followup/SKILL.md +1 -1
  145. package/template/.claude/skills/frontend-ui-engineering/SKILL.md +1 -1
  146. package/template/.claude/skills/git-workflow-and-versioning/SKILL.md +1 -1
  147. package/template/.claude/skills/goal/SKILL.md +1 -1
  148. package/template/.claude/skills/handoff/SKILL.md +1 -1
  149. package/template/.claude/skills/help/SKILL.md +1 -1
  150. package/template/.claude/skills/human-review-decisions/SKILL.md +1 -1
  151. package/template/.claude/skills/i18n-localization/SKILL.md +1 -1
  152. package/template/.claude/skills/idea-refine/SKILL.md +1 -1
  153. package/template/.claude/skills/incremental-implementation/SKILL.md +1 -1
  154. package/template/.claude/skills/insight/SKILL.md +1 -1
  155. package/template/.claude/skills/insight-capture/SKILL.md +1 -1
  156. package/template/.claude/skills/intelligent-routing/SKILL.md +1 -1
  157. package/template/.claude/skills/issue-triage/SKILL.md +1 -1
  158. package/template/.claude/skills/lint-and-validate/SKILL.md +1 -1
  159. package/template/.claude/skills/mcp-builder/SKILL.md +1 -1
  160. package/template/.claude/skills/md2html/SKILL.md +1 -1
  161. package/template/.claude/skills/merge/SKILL.md +1 -1
  162. package/template/.claude/skills/mobile-design/SKILL.md +1 -1
  163. package/template/.claude/skills/nextjs-react-expert/SKILL.md +1 -1
  164. package/template/.claude/skills/nodejs-best-practices/SKILL.md +1 -1
  165. package/template/.claude/skills/onboard/SKILL.md +1 -1
  166. package/template/.claude/skills/package-json-generator/SKILL.md +1 -1
  167. package/template/.claude/skills/parallel-agents/SKILL.md +1 -1
  168. package/template/.claude/skills/performance-optimization/SKILL.md +1 -1
  169. package/template/.claude/skills/planning-and-task-breakdown/SKILL.md +1 -1
  170. package/template/.claude/skills/powershell-windows/SKILL.md +1 -1
  171. package/template/.claude/skills/pr/SKILL.md +1 -1
  172. package/template/.claude/skills/pr-review/SKILL.md +1 -1
  173. package/template/.claude/skills/pr-review-analysis/SKILL.md +1 -1
  174. package/template/.claude/skills/prd/SKILL.md +1 -1
  175. package/template/.claude/skills/preview/SKILL.md +1 -1
  176. package/template/.claude/skills/preview-local-check/SKILL.md +1 -1
  177. package/template/.claude/skills/prototype/SKILL.md +1 -1
  178. package/template/.claude/skills/python-patterns/SKILL.md +1 -1
  179. package/template/.claude/skills/release-git-operations/SKILL.md +1 -1
  180. package/template/.claude/skills/research/SKILL.md +1 -1
  181. package/template/.claude/skills/review/SKILL.md +1 -1
  182. package/template/.claude/skills/review-followup-routing/SKILL.md +1 -1
  183. package/template/.claude/skills/roadmap-strategy/SKILL.md +1 -1
  184. package/template/.claude/skills/rollback/SKILL.md +108 -0
  185. package/template/.claude/skills/security-and-hardening/SKILL.md +1 -1
  186. package/template/.claude/skills/security-review/SKILL.md +1 -1
  187. package/template/.claude/skills/seo-fundamentals/SKILL.md +1 -1
  188. package/template/.claude/skills/server-management/SKILL.md +1 -1
  189. package/template/.claude/skills/shipping-and-launch/SKILL.md +1 -1
  190. package/template/.claude/skills/silent-failure-audit/SKILL.md +1 -1
  191. package/template/.claude/skills/simplify/SKILL.md +1 -1
  192. package/template/.claude/skills/skill-development/SKILL.md +1 -1
  193. package/template/.claude/skills/spec-driven-development/SKILL.md +1 -1
  194. package/template/.claude/skills/spec-orchestration/SKILL.md +1 -1
  195. package/template/.claude/skills/specialist-agent-routing/SKILL.md +1 -1
  196. package/template/.claude/skills/tailwind-patterns/SKILL.md +1 -1
  197. package/template/.claude/skills/test/SKILL.md +1 -1
  198. package/template/.claude/skills/test-driven-development/SKILL.md +1 -1
  199. package/template/.claude/skills/test-execution-and-coverage/SKILL.md +1 -1
  200. package/template/.claude/skills/try/SKILL.md +108 -0
  201. package/template/.claude/skills/type-design/SKILL.md +1 -1
  202. package/template/.claude/skills/ui-ux-pro-max/SKILL.md +1 -1
  203. package/template/.claude/skills/using-agent-skills/SKILL.md +1 -1
  204. package/template/.claude/skills/verification-orchestration/SKILL.md +1 -1
  205. package/template/.claude/skills/vulnerability-scanner/SKILL.md +1 -1
  206. package/template/.claude/skills/wiki/SKILL.md +1 -1
  207. package/template/.claude/skills/workflow-documentation-sync/SKILL.md +1 -1
  208. package/template/AGENTS.md +11 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: server-management
3
- description: Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands.
3
+ description: "[Devflow] Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands."
4
4
  allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: shipping-and-launch
3
- description: Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.
3
+ description: "[Devflow] Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy."
4
4
  ---
5
5
 
6
6
  # Shipping and Launch
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: silent-failure-audit
3
- description: Audits error handling, logging, fallbacks, and observability for silent failures. Use after adding catch blocks, fallback logic, retry handling, optional chaining, or user-facing failure paths.
3
+ description: "[Devflow] Audits error handling, logging, fallbacks, and observability for silent failures. Use after adding catch blocks, fallback logic, retry handling, optional chaining, or user-facing failure paths."
4
4
  ---
5
5
 
6
6
  # Silent Failure Audit
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: simplify
3
- description: Simplify workflow
3
+ description: "[Devflow] Code simplification and refactoring for clarity and maintainability without altering runtime behavior."
4
4
  ---
5
5
 
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: skill-development
3
- description: Guides the creation and maintenance of agent skills. Use when building new skills or modifying existing ones to ensure they follow the PRP framework standards.
3
+ description: "[Devflow] Guides the creation and maintenance of agent skills. Use when building new skills or modifying existing ones to ensure they follow the PRP framework standards."
4
4
  ---
5
5
 
6
6
  # Skill Development (Skill Anatomy)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: spec-driven-development
3
- description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea.
3
+ description: "[Devflow] Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea."
4
4
  ---
5
5
 
6
6
  # Spec-Driven Development
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: spec-orchestration
3
- description: Coordinate Brainstorm, Research, PRD, competitor context, and spec critique before the work re-enters the numbered mainline. Use when a broad idea needs orchestration rather than a straight pass.
3
+ description: "[Devflow] Coordinate Brainstorm, Research, PRD, competitor context, and spec critique before the work re-enters the numbered mainline. Use when a broad idea needs orchestration rather than a straight pass."
4
4
  ---
5
5
 
6
6
  # Spec Orchestration
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: specialist-agent-routing
3
- description: Route a request to the right specialist agent and preserve the DevFlow 2.0 stage-first contract. Use when the user wants direct specialist judgment on a file, folder, workspace, or concern.
3
+ description: "[Devflow] Route a request to the right specialist agent and preserve the DevFlow 2.0 stage-first contract. Use when the user wants direct specialist judgment on a file, folder, workspace, or concern."
4
4
  ---
5
5
 
6
6
  # Specialist Agent Routing
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tailwind-patterns
3
- description: Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture.
3
+ description: "[Devflow] Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture."
4
4
  allowed-tools: Read, Write, Edit, Glob, Grep
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test
3
- description: Test workflow
3
+ description: "[Devflow] Test execution, missing test generation, and coverage analysis across unit, integration, and smoke test suites."
4
4
  ---
5
5
 
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-driven-development
3
- description: Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.
3
+ description: "[Devflow] Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality."
4
4
  ---
5
5
 
6
6
  # Test-Driven Development
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-execution-and-coverage
3
- description: Generate missing tests, run existing tests, and summarize coverage and failures. Use when implementation or verification needs explicit testing evidence beyond a general TDD reminder.
3
+ description: "[Devflow] Generate missing tests, run existing tests, and summarize coverage and failures. Use when implementation or verification needs explicit testing evidence beyond a general TDD reminder."
4
4
  ---
5
5
 
6
6
  # Test Execution And Coverage
@@ -0,0 +1,108 @@
1
+ ---
2
+ name: try
3
+ description: "[Devflow] Generate human manual QA review walkthrough guide (where to go, what to click, what to expect)."
4
+ ---
5
+
6
+ # try - Manual QA & Review Walkthrough Guide
7
+
8
+ Where this sits in the workflow:
9
+
10
+ ```text
11
+ /40-implement or /50-verify or /60-report -> [try] -> human review & verification
12
+ (work implemented / verified) (manual (where to go,
13
+ steps) what to click)
14
+ ```
15
+
16
+ `/50-verify` proves behavior from automated QA and test runs. `/try` gives the user and testers an actionable, step-by-step manual walkthrough: start this command, open this route, click these controls, expect this result, and watch for these failure signs.
17
+
18
+ It is always **read-only 100%**. It does not edit files, install dependencies, commit, merge, push, or run destructive commands.
19
+
20
+ ## Input
21
+
22
+ Optional scope:
23
+
24
+ - **no argument**: use the active run in `devflow/context/current-stage.md` (or the latest completed run under `devflow/runs/`)
25
+ - `latest`: use the most recent completed run in `devflow/runs/`
26
+ - a run ID or path: e.g. `/try RUN-002-add-onboard-adopt-doctor-skills`
27
+ - a specific route, endpoint, or CLI command: focus the walkthrough on that surface
28
+
29
+ If there is no active run and no run history, ask what change or feature the user wants to test manually.
30
+
31
+ ## Step 1 - Find The Work To Explain
32
+
33
+ Read:
34
+
35
+ - `AGENTS.md` (Commands section)
36
+ - `devflow/context/current-stage.md`
37
+ - `devflow/context/project-overview.md`
38
+ - `devflow/context/coding-standards.md`
39
+ - Active run artifacts: `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md` (or archived run artifacts)
40
+ - Current git branch and status
41
+
42
+ Do not dump the full spec. Extract only the concrete routes, screens, CLI commands, API endpoints, test data, and expected outcomes that a human needs to verify the feature.
43
+
44
+ ## Step 2 - Identify How To Run The App
45
+
46
+ Check the Commands section in `AGENTS.md`. Adapt to the project type:
47
+
48
+ - **Web app**: dev server command (e.g. `npm run dev`), local URL (e.g. `http://localhost:3000`), and specific route/screen.
49
+ - **Server / API**: start command, base URL, endpoint, HTTP method, payload, and expected response shape.
50
+ - **CLI**: exact CLI command, flags, arguments, and expected terminal output.
51
+ - **Library / Module**: sample usage snippet, REPL call, or interactive test command.
52
+ - **Fullstack / Microservices**: minimal combined startup commands (e.g. backend + frontend).
53
+
54
+ If a startup command is missing or unclear in `AGENTS.md`, report that as a configuration gap rather than guessing.
55
+
56
+ ## Step 3 - Produce The Manual Walkthrough Guide
57
+
58
+ Format the guide with these 5 standard sections:
59
+
60
+ 1. **1. Start** - exact command(s) to start the system and where to run them.
61
+ 2. **2. Open** - URL(s), screens, tabs, API endpoints, or terminal locations.
62
+ 3. **3. Do** - specific clicks, form inputs, toggles, selections, or arguments.
63
+ 4. **4. Expect** - expected visible UI change, response payload, state change, output, or absence of errors.
64
+ 5. **5. Watch For** - common failure symptoms, console errors, network 4xx/5xx errors, stale state, layout breakage, or safety warnings.
65
+
66
+ ### Example Walkthrough Style:
67
+
68
+ ```markdown
69
+ ### 1. Start
70
+ Run `npm run dev` in the project root.
71
+
72
+ ### 2. Open
73
+ Navigate to `http://localhost:3000/dashboard/reports`.
74
+
75
+ ### 3. Do
76
+ 1. Click the **"Export Report"** button in the top right.
77
+ 2. Select **"Format: HTML"** from the dropdown.
78
+ 3. Click **"Download"**.
79
+
80
+ ### 4. Expect
81
+ - A new file `report.html` is downloaded.
82
+ - The UI displays a green success toast: *"Report exported successfully"*.
83
+ - The downloaded HTML file opens in the browser with full styling and charts.
84
+
85
+ ### 5. Watch For
86
+ - Spinner hanging indefinitely without downloading.
87
+ - Console error related to `Blob` or `URL.createObjectURL`.
88
+ - Broken styling or unrendered Mermaid charts in the exported HTML.
89
+ ```
90
+
91
+ ## Step 4 - Include Confidence, Best Signal & Gaps
92
+
93
+ Conclude with:
94
+
95
+ - **Best Signal**: the single most critical action the user should try first to confirm functionality.
96
+ - **Edge Cases & Error Flows**: optional secondary checks (e.g. invalid input, empty state, network failure).
97
+ - **Gaps & Assumptions**: anything the guide cannot know for certain (e.g. seed credentials, third-party API keys, required database fixtures).
98
+
99
+ ## Rules
100
+
101
+ - **Strictly Read-Only**: Never edit code, commit, push, install packages, or mutate repository state.
102
+ - **Do Not Run Automatically**: Do not launch the server or run commands unless the user explicitly instructs you to do so in the chat.
103
+ - **Be Concrete & Specific**: Provide exact URLs, button labels, and payloads.
104
+ - **Acknowledge Uncertainty**: If a route or behavior is not specified in the spec, state it clearly as an assumption.
105
+
106
+ ## Output Formatting
107
+
108
+ Follow the project conventions in `devflow/context/ai-interaction.md`: concise, scannable markdown with numbered steps and clear bold headers.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: type-design
3
- description: Analyzes type and interface design for encapsulation, invariant expression, usefulness, and enforcement. Use when introducing new types, reviewing PRs with type changes, or refactoring domain models.
3
+ description: "[Devflow] Analyzes type and interface design for encapsulation, invariant expression, usefulness, and enforcement. Use when introducing new types, reviewing PRs with type changes, or refactoring domain models."
4
4
  ---
5
5
 
6
6
  # Type Design
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ui-ux-pro-max
3
- description: AI-powered design intelligence with 50+ styles, 95+ color palettes, and automated design system generation. Use when designing, building, or reviewing UI/UX.
3
+ description: "[Devflow] AI-powered design intelligence with 50+ styles, 95+ color palettes, and automated design system generation. Use when designing, building, or reviewing UI/UX."
4
4
  ---
5
5
 
6
6
  # UI/UX Pro Max (Design Intelligence)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: using-agent-skills
3
- description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
3
+ description: "[Devflow] Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked."
4
4
  ---
5
5
 
6
6
  # Using Agent Skills
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: verification-orchestration
3
- description: Coordinate multi-lane QA, specialist review, test planning, and verification follow-up. Use when /50-Verify needs more structure than a single pass and the team needs a QA matrix or specialist routing.
3
+ description: "[Devflow] Coordinate multi-lane QA, specialist review, test planning, and verification follow-up. Use when /50-Verify needs more structure than a single pass and the team needs a QA matrix or specialist routing."
4
4
  ---
5
5
 
6
6
  # Verification Orchestration
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: vulnerability-scanner
3
- description: Advanced vulnerability analysis principles. OWASP 2025, Supply Chain Security, attack surface mapping, risk prioritization.
3
+ description: "[Devflow] Advanced vulnerability analysis principles. OWASP 2025, Supply Chain Security, attack surface mapping, risk prioritization."
4
4
  allowed-tools: Read, Glob, Grep, Bash
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: wiki
2
2
 
3
- description: DevFlow Wiki - Ingest, query, lint, and promote compiled project or framework knowledge.
3
+ description: "[Devflow] Knowledge base management, ingestion, linting, and querying under devflow/wiki/."
4
4
  ---
5
5
  # Wiki
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: workflow-documentation-sync
3
- description: Enforces the synchronization and comprehensive update of documentation, manuals, usage guides, and examples whenever a new workflow is introduced or modified in the project. Use when introducing new workflows or changing existing ones.
3
+ description: "[Devflow] Enforces the synchronization and comprehensive update of documentation, manuals, usage guides, and examples whenever a new workflow is introduced or modified in the project. Use when introducing new workflows or changing existing ones."
4
4
  ---
5
5
 
6
6
  # Workflow Documentation Sync
@@ -1,6 +1,6 @@
1
1
  ---name: 00-discover
2
2
 
3
- description: Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID.
3
+ description: "[Devflow] Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID."
4
4
  argument-hint: "{title, request, or discovery-id}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 10-define
2
2
 
3
- description: Define stage in DevFlow 2.0 - turn an approved discovery into one or more bounded delivery runs with stable scope.
3
+ description: "[Devflow] Define stage in DevFlow 2.0 - turn an approved discovery into one or more bounded delivery runs with stable scope."
4
4
  argument-hint: "{approved discovery-id, discovery path, running-id, or run path}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 20-spec
2
2
 
3
- description: Spec stage in DevFlow 2.0 - write the formal markdown-first specification from a stable definition.
3
+ description: "[Devflow] Spec stage in DevFlow 2.0 - write the formal markdown-first specification from a stable definition."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 30-plan
2
2
 
3
- description: Plan implementation in DevFlow 2.0 - transform `20-spec.md` into a markdown-first executable plan.
3
+ description: "[Devflow] Plan stage in DevFlow 2.0 - transform 20-spec.md into an executable task breakdown with test decisions."
4
4
  ---
5
5
  # Phase 30: Plan Implementation
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 40-implement
2
2
 
3
- description: Implement code in DevFlow 2.0 - execute one planned unit at a time with markdown-first implementation evidence.
3
+ description: "[Devflow] Implement stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
4
4
  ---
5
5
  # Phase 40: Implement Code
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 50-verify
2
2
 
3
- description: Verify quality in DevFlow 2.0 - perform senior QA review, record evidence, and decide pass or return-to-implement.
3
+ description: "[Devflow] Verify stage in DevFlow 2.0 - perform senior QA review, record evidence, and decide pass or return-to-implement."
4
4
  ---
5
5
  # Phase 50: Verify Quality
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 60-report
2
2
 
3
- description: Report stage in DevFlow 2.0 - produce the final standardized markdown and HTML summary for the full running flow.
3
+ description: "[Devflow] Report stage in DevFlow 2.0 - produce standardized markdown and HTML summary report for the completed run."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: 70-release
2
2
 
3
- description: Release stage in DevFlow 2.0 - package verified work for delivery, merge, PR, deployment, or handoff.
3
+ description: "[Devflow] Release stage in DevFlow 2.0 - package verified work for delivery, git merge, PR, or deployment."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: adopt
3
- description: Bootstrap Nexus-DevFlow into an existing (brownfield) codebase. Surveys the real repository (read-only), interviews the user for intent, generates project-overview.md and coding-standards.md from existing code, tunes AGENTS.md commands, and seeds the initial Discovery or Run map. Use when the user runs adopt, /adopt, $adopt, is overlaying DevFlow onto an app that already has meaningful code, or asks to adopt DevFlow into an existing project. For freshly scaffolded or early projects, use onboard instead.
3
+ description: "[Devflow] Survey existing brownfield codebase and bootstrap DevFlow context files."
4
4
  ---
5
5
 
6
6
  # adopt - Bootstrap Nexus-DevFlow from an Existing Codebase
@@ -1,6 +1,6 @@
1
1
  ---name: agent
2
2
 
3
- description: Invoke Agent - Run a specialist persona on a file, folder, stage artifact, or codebase concern.
3
+ description: "[Devflow] Invoke specialist persona or role-based agent on a target file, folder, stage artifact, or concern."
4
4
  ---
5
5
  # Phase 90: Invoke Agent
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: api-and-interface-design
3
- description: Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
3
+ description: "[Devflow] Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend."
4
4
  ---
5
5
 
6
6
  # API and Interface Design
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: app-builder
3
- description: Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.
3
+ description: "[Devflow] Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents."
4
4
  allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: architecture
3
- description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
3
+ description: "[Devflow] Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design."
4
4
  allowed-tools: Read, Glob, Grep
5
5
  ---
6
6
 
@@ -0,0 +1,175 @@
1
+ ---
2
+ name: autopilot
3
+ description: "[Devflow] Optional explicit mode for one bounded spec/plan/implement/verify/report pass with checkpoint commits and review packet."
4
+ ---
5
+
6
+ # autopilot - Autonomous Bounded DevFlow Loop
7
+
8
+ Where this sits in the workflow:
9
+
10
+ ```text
11
+ /devflow -> [autopilot] -> review packet -> /70-release
12
+ (where (spec, plan, (human review, (package, PR,
13
+ are we?) build, verify, walkthrough) merge with approval)
14
+ report)
15
+ ```
16
+
17
+ Autopilot is an explicit opt-in execution skill for Nexus-DevFlow 2.0. It runs a single bounded loop across the delivery lifecycle (**`20-spec` -> `30-plan` -> `40-implement` -> `50-verify` -> `60-report`**) without requiring human confirmation between every sub-step.
18
+
19
+ It does **not** replace the normal step-by-step workflow. Mainline commands (`/20-spec`, `/30-plan`, `/40-implement`, `/50-verify`, `/60-report`, `/70-release`) remain the conservative default.
20
+
21
+ Do not suggest Autopilot as the default next action. Use it only when the user explicitly asks for it.
22
+
23
+ The explicit Autopilot request is permission to create checkpoint commits on the feature or fix branch after passing implementation steps. It is **not** permission to merge into `main`, push to remote, deploy, publish, delete data, or run destructive actions.
24
+
25
+ ## Input
26
+
27
+ Common forms:
28
+
29
+ - **No argument**: resume the active run in `devflow/context/current-stage.md`, or target the next planned run/feature in `devflow/context/project-overview.md`.
30
+ - **Running ID or feature name**: target that run, e.g. `/autopilot RUN-004` or `/autopilot "add user authentication"`.
31
+ - **`fix "<issue>"`**: write and execute an ad-hoc fix run.
32
+ - **`resume`**: continue the current active run on its existing branch.
33
+
34
+ If the requested target conflicts with a run already in progress, stop and ask which one should win. Do not overwrite active stage artifacts silently.
35
+
36
+ > [!IMPORTANT]
37
+ > Rollback is intentionally excluded from Autopilot. If the request is a rollback or the stage is marked Rollback, stop and direct the user to `/rollback` and reviewed `/40-implement`. Reversing completed work requires explicit dependency and human review gates.
38
+
39
+ ---
40
+
41
+ ## Step 1 - Preflight & Safety Check
42
+
43
+ Read the project state:
44
+
45
+ - `AGENTS.md` & `CLAUDE.md`
46
+ - `devflow/context/project-overview.md`
47
+ - `devflow/context/current-stage.md`
48
+ - `devflow/context/coding-standards.md`
49
+ - `devflow/context/ai-interaction.md`
50
+ - `devflow/context/findings.md`
51
+ - git branch, status, and recent log
52
+
53
+ Stop before changing files when:
54
+
55
+ 1. The repo is not a git repository.
56
+ 2. The working tree is dirty with uncommitted changes unrelated to this run.
57
+ 3. `current-stage.md` has an active run and the user requested a different target without resolving conflict.
58
+ 4. The task requires architectural, financial, auth, billing, or destructive decisions not documented in the context.
59
+
60
+ ---
61
+
62
+ ## Step 2 - Choose or Write Specification (`20-spec`)
63
+
64
+ 1. If `devflow/runs/{running-id}-{slug}/20-spec.md` already exists, resume it.
65
+ 2. If no spec exists:
66
+ - Ensure `10-define.md` exists with locked scope and allocated Running ID.
67
+ - Write `20-spec.md` following the DevFlow specification schema.
68
+ - Critique and red-team the spec (edge cases, unhappy paths, testable criteria).
69
+ - Apply fixes to the spec.
70
+
71
+ ---
72
+
73
+ ## Step 3 - Branch Setup & Implementation Plan (`30-plan`)
74
+
75
+ 1. **Branch Management**:
76
+ - Feature: `feature/{slug}-{running-id}`
77
+ - Fix: `fix/{slug}-{running-id}`
78
+ - Switch to or create the working branch. Never run Autopilot directly on `main` or `master`.
79
+ 2. **Planning**:
80
+ - Write `devflow/runs/{running-id}-{slug}/30-plan.md`.
81
+ - Seed `checklists/implementation-checklist.md` and `checklists/verification-checklist.md`.
82
+
83
+ ---
84
+
85
+ ## Step 4 - Implement in Small Increments (`40-implement`)
86
+
87
+ Work through the implementation checklist in order. Each step must remain reviewable.
88
+
89
+ For every subtask:
90
+
91
+ 1. Implement only that scoped unit.
92
+ 2. Run relevant verification (unit tests, typecheck, lint, build).
93
+ 3. If UI is involved, inspect behavior, verify console errors and network calls.
94
+ 4. Self-review diff against `coding-standards.md`.
95
+ 5. Fix issues and rerun failed checks.
96
+ 6. Mark the task checked `[x]` in `checklists/implementation-checklist.md`.
97
+ 7. **Create a Checkpoint Commit** on the feature/fix branch for the passing step:
98
+ ```bash
99
+ git add <modified-files> devflow/runs/{running-id}-{slug}/checklists/implementation-checklist.md
100
+ git commit -m "feat({running-id}): checkpoint <concise step description>"
101
+ ```
102
+ 8. Write `devflow/runs/{running-id}-{slug}/40-implement.md`.
103
+
104
+ ---
105
+
106
+ ## Step 5 - Senior QA Verification (`50-verify`)
107
+
108
+ 1. Execute full project verification commands:
109
+ - Framework integrity (`npm run check` or equivalent)
110
+ - Static contracts (`npm run check:static` when applicable)
111
+ - Project test suite (Unit tests, integration tests)
112
+ - Build / Package smoke tests
113
+ 2. Update `checklists/verification-checklist.md` with concrete evidence.
114
+ 3. Write `devflow/runs/{running-id}-{slug}/50-verify.md` with QA verdict (`PASS` / `FAIL`).
115
+
116
+ ---
117
+
118
+ ## Step 6 - Targeted Quality Audit & Repair
119
+
120
+ Review diffs and inspect `devflow/context/findings.md`:
121
+
122
+ 1. **Repair confirmed P0 and P1 findings** within the current run scope.
123
+ 2. Update finding status in `devflow/context/findings.md`.
124
+ 3. Rerun verification tests after repairs.
125
+ 4. Create a checkpoint commit for the fix.
126
+ 5. If a P0/P1 finding cannot be repaired within scope or fails twice consecutively, stop immediately and report.
127
+
128
+ ---
129
+
130
+ ## Step 7 - Delivery Digest & Review Packet (`60-report`)
131
+
132
+ 1. Write `devflow/runs/{running-id}-{slug}/60-report.md`.
133
+ 2. Render standalone HTML dashboard `devflow/runs/{running-id}-{slug}/60-report.html` (via `md2html` or report generator).
134
+ 3. Update `devflow/context/current-stage.md` to indicate ready for `/70-release`.
135
+ 4. Stop with a concise **Review Packet Dashboard** for human approval.
136
+
137
+ ---
138
+
139
+ ## 🛑 Strict Hard Stops (Never Exceed)
140
+
141
+ Stop immediately and report to the user instead of continuing when Autopilot would need to:
142
+
143
+ - Commit directly to `main` or `master`, merge branches, delete branches, or force push.
144
+ - Run `git push` to remote repositories.
145
+ - Deploy to staging/production or publish packages to npm/registries.
146
+ - Delete data, drop databases, or run irreversible destructive migrations.
147
+ - Make product, business, or architecture decisions not specified in the context.
148
+ - Continue after two failed attempts to fix the same issue (Two-attempt hard stop).
149
+
150
+ ---
151
+
152
+ ## Output Review Packet Format
153
+
154
+ When Autopilot finishes successfully, output a scannable review packet:
155
+
156
+ ```markdown
157
+ ### 🛸 Autopilot Execution Summary: [{running-id}]
158
+
159
+ - **Branch**: `{branch-name}`
160
+ - **Target Run**: `{running-id} - {title}`
161
+ - **Artifacts Generated**:
162
+ - Spec: `devflow/runs/{id}/20-spec.md`
163
+ - Plan: `devflow/runs/{id}/30-plan.md`
164
+ - Implement Evidence: `devflow/runs/{id}/40-implement.md`
165
+ - QA Verify Report: `devflow/runs/{id}/50-verify.md`
166
+ - Digest Report: `devflow/runs/{id}/60-report.md`
167
+ - HTML Dashboard: `devflow/runs/{id}/60-report.html`
168
+ - **Validation & Tests**: `All Passed (Green)`
169
+ - **Checkpoint Commits**: `{count} commits created on {branch-name}`
170
+ - **Manual QA Walkthrough**: Run `/try {running-id}` for human review guide
171
+
172
+ ---
173
+ 👉 **Next Recommended Action**:
174
+ Inspect diffs and `/try` walkthrough, then run `/70-release {running-id}` to package, merge, or create PR.
175
+ ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: bash-linux
3
- description: Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.
3
+ description: "[Devflow] Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems."
4
4
  allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: behavioral-modes
3
- description: AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.
3
+ description: "[Devflow] AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type."
4
4
  allowed-tools: Read, Glob, Grep
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---name: brainstorm
2
2
 
3
- description: Structured brainstorming for projects and features. Transitional compatibility path for the Brainstorm companion command in DevFlow 2.0.
3
+ description: "[Devflow] Structured divergent and convergent ideation for features and ideas without allocating running IDs."
4
4
  ---
5
5
 
6
6
  # Brainstorm - Structured Idea Exploration