@xenonbyte/da-vinci-workflow 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenonbyte/da-vinci-workflow",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Requirement-to-design-to-code workflow skill for Codex, Claude, and Gemini",
   "bin": {
     "da-vinci": "bin/da-vinci.js",

package/references/skill-workflow-detail.md

@@ -0,0 +1,66 @@
+# Skill Workflow Detail (Stage-Specific)
+
+This file owns stage-specific operational detail moved out of core `SKILL.md`.
+Core `SKILL.md` remains the invariant contract and routing index.
+
+## Split Non-Goals
+
+- Do not change route truth (`requirements -> design -> tasks -> build -> verify`) by moving prose.
+- Do not weaken autonomous-by-default policy.
+- Do not redefine checkpoints or acceptance semantics implicitly through wording changes.
+- Do not duplicate moved sections back into `SKILL.md`, command assets, and references simultaneously.
+
+## Move Map
+
+The following sections were moved from core `SKILL.md` into owned references:
+
+- `Design Input Collection` -> `references/design-inputs.md`
+- `Default Workflow` -> `references/checkpoints.md` and `references/artifact-templates.md`
+- `Pencil Generation Rules` -> `references/pencil-design-to-code.md` and `references/layout-hygiene.md`
+- `Default Artifacts` -> `references/artifact-templates.md`
+- `Prompt Entry Route Recipes` (detailed variants) -> `references/prompt-recipes.md`
+- `Mode-specific elaboration` -> `references/modes.md`
+- `Platform adapter elaboration` -> `references/platform-adapters.md`
+
+## Stage Detail Ownership
+
+Use this section when the current stage needs tactical instructions beyond core contract.
+
+### 1. Discovery & Planning
+
+- Ensure change root exists and active change id is unambiguous.
+- Keep proposal/spec/design/tasks artifacts synchronized with the selected mode.
+- Treat artifact drift as a blocker for execution confidence.
+
+### 2. Design Inputs & Page Mapping
+
+- Collect/confirm form factor, visual direction, and constraints from existing project truth first.
+- Resolve project page map and implementation-to-design bindings before design expansion.
+- Keep binding records explicit and parseable for downstream verification/scaffold commands.
+
+### 3. Pencil Design Execution
+
+- Keep `.da-vinci/designs/` reserved for project-local `.pen` sources.
+- Use Pencil session wrapper commands for autonomous runs:
+  - `da-vinci pencil-session begin --project <project-path> --pen <path>`
+  - `da-vinci pencil-session persist --project <project-path> --pen <path> --nodes-file <batch-get-json> --variables-file <get-variables-json> --version <version>`
+  - `da-vinci pencil-session end --project <project-path> --pen <path> --nodes-file <batch-get-json> --variables-file <get-variables-json> --version <version>`
+- Keep screenshot review and supervisor review records explicit when required.
+
+### 4. Build & Verification
+
+- `tasks.md` PASS/accepted WARN is the handoff into implementation, not completion.
+- During build, persist task execution and task review evidence with CLI envelopes.
+- Before completion-facing wording, require fresh verification evidence and completion audit pass.
+
+### 5. Scaffold Guidance
+
+- Scaffold output is reviewable TODO skeleton only, never final production code.
+- Keep traversal and output-root safety guarantees intact.
+- Preserve known implementation landing shape when available.
+
+## Maintainer Guidance
+
+- New invariant policy belongs in core `SKILL.md`.
+- New stage-specific procedure belongs in one owned reference file, then linked from core `Load References On Demand`.
+- When moving text, update this move map in the same patch.