@uipath/skills 1.201.0-preview.604 → 1.201.0-preview.606
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/CODEOWNERS +7 -10
- package/package.json +1 -1
- package/skills/uipath-planner/SKILL.md +9 -6
- package/skills/uipath-planner/assets/templates/{case-sdd-template.md → case/case-sdd-template.md} +2 -2
- package/skills/uipath-planner/references/asdd-crosswalk-guide.md +7 -5
- package/skills/uipath-planner/references/{case-design-lane-guide.md → case/case-design-lane-guide.md} +6 -6
- package/skills/uipath-planner/references/{case-design-layers-guide.md → case/case-design-layers-guide.md} +4 -4
- package/skills/uipath-planner/references/product-selection-guide.md +1 -1
- package/skills/uipath-planner/references/sdd-generation-guide.md +1 -1
- package/skills/uipath-planner/scripts/{audit_sdd.py → case/audit_sdd.py} +1 -1
- package/version-manifest.json +1 -1
- /package/skills/uipath-planner/assets/templates/{sdd-viewer.html → case/sdd-viewer.html} +0 -0
package/CODEOWNERS
CHANGED
|
@@ -79,16 +79,13 @@
|
|
|
79
79
|
/tests/tasks/activation/uipath-functions.jsonl @AlexBizon @UiPath/team-coded-agents
|
|
80
80
|
|
|
81
81
|
# Planner skill (PDD → SDD design + multi-skill task planning)
|
|
82
|
-
/skills/uipath-planner/ @RaduAna-Maria
|
|
83
|
-
/tests/tasks/uipath-planner/ @RaduAna-Maria
|
|
84
|
-
|
|
85
|
-
/
|
|
86
|
-
/
|
|
87
|
-
/tests/tasks/uipath-planner/
|
|
88
|
-
/tests/tasks/uipath-planner/
|
|
89
|
-
/tests/tasks/uipath-planner/case_finalize_draft_loan/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25 @jundayin
|
|
90
|
-
/tests/tasks/uipath-planner/case_finalize_draft_picker/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25 @jundayin
|
|
91
|
-
/tests/tasks/uipath-planner/case_finalize_draft_reject/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25 @jundayin
|
|
82
|
+
/skills/uipath-planner/ @RaduAna-Maria
|
|
83
|
+
/tests/tasks/uipath-planner/ @RaduAna-Maria
|
|
84
|
+
/skills/uipath-planner/references/case/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25
|
|
85
|
+
/skills/uipath-planner/assets/templates/case/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25
|
|
86
|
+
/skills/uipath-planner/scripts/case/ @RaduAna-Maria @abhiram-vad @charlesliu9 @song-zhao-25
|
|
87
|
+
/tests/tasks/uipath-planner/case/ @abhiram-vad @charlesliu9 @song-zhao-25 @jundayin
|
|
88
|
+
/tests/tasks/uipath-planner/_shared/ @abhiram-vad @charlesliu9 @song-zhao-25 @jundayin
|
|
92
89
|
|
|
93
90
|
# Solution skill (uip solution lifecycle)
|
|
94
91
|
/skills/uipath-solution/ @UiPath/team-merlot @UiPath/team-orange
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@uipath/skills",
|
|
3
|
-
"version": "1.201.0-preview.
|
|
3
|
+
"version": "1.201.0-preview.606",
|
|
4
4
|
"description": "UiPath agent skills for Claude Code, Codex, Cursor, Copilot, Gemini and OpenCode — RPA, UI automation, UI testing, coded agents/apps/workflows, and troubleshooting. Distributed as the UiPath Claude Code plugin.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "UiPath"
|
|
@@ -16,7 +16,7 @@ Never execute the work. Outputs are SDD markdown, plan/tasks markdown, and live
|
|
|
16
16
|
|
|
17
17
|
The skill has three paths, decided by the **Entry Guard**:
|
|
18
18
|
|
|
19
|
-
- **Phase D — Design.** Input is a PDD, or an explicit "design / architect this" request. Author the SDD; the SDD write ends the turn, and Lane A continues on the next turn. See [sdd-generation-guide.md](references/sdd-generation-guide.md). **Case Management designs run through Phase D's Case Design Lane** ([case-design-lane-guide.md](references/case-design-lane-guide.md)) — a conversational design ending in ONE Case Review confirmation.
|
|
19
|
+
- **Phase D — Design.** Input is a PDD, or an explicit "design / architect this" request. Author the SDD; the SDD write ends the turn, and Lane A continues on the next turn. See [sdd-generation-guide.md](references/sdd-generation-guide.md). **Case Management designs run through Phase D's Case Design Lane** ([case-design-lane-guide.md](references/case/case-design-lane-guide.md)) — a conversational design ending in ONE Case Review confirmation.
|
|
20
20
|
- **Lane A — PDD-driven.** Input is an SDD with the `## Planner Handoff` marker (written by Phase D, or hand-written). Read it, derive tasks, emit live tasks. Zero to two user prompts. See [pdd-driven-lane-guide.md](references/pdd-driven-lane-guide.md).
|
|
21
21
|
- **Lane B — Non-PDD.** No SDD; a non-PDD multi-project request. Elicit preferences, detect project type, write a plan, emit live tasks. 0–3 prompts (5-call cap). See [non-pdd-lane-guide.md](references/non-pdd-lane-guide.md).
|
|
22
22
|
|
|
@@ -42,9 +42,12 @@ The skill has three paths, decided by the **Entry Guard**:
|
|
|
42
42
|
8. **Route — do not redescribe.** The plan says WHICH skill to load and IN WHAT ORDER. It does NOT describe specialist-internal flows (target configuration, OR registration, XAML pipelines, HITL field/outcome schema, auth, testing procedures). For a HITL step, pass business intent only ("manager approves or rejects an expense; can add a reason if rejected") — never a field-level spec; the HITL specialist chooses the schema shape.
|
|
43
43
|
9. **Per-phase prompt budget.** Phase D runs under its own checkpoint model (see [sdd-generation-guide.md](references/sdd-generation-guide.md)) — no hard numeric cap. Lanes A and B each cap at **5 `AskUserQuestion` calls**. Ask **execution autonomy exactly once** (Phase D entry) and write it into the handoff header; Lane A reads it and never re-asks. Scope/UI answers resolved in Phase D flow forward via the SDD.
|
|
44
44
|
10. **Fill gaps with `[DEFAULT]` or `[SME REVIEW]` — never silently invent business rules.** `[DEFAULT]` for industry-standard patterns (retry counts, timeouts); `[SME REVIEW]` for business-knowledge gaps. Resolve `[SME REVIEW]` items with the user before finalizing (they gate the `Status: ready` flip, not the Phase 3 Step 0 skeleton write). For Agent/Coded App gaps, use `AskUserQuestion` (proceed-with-gap-filling vs different product) — never auto-fallback.
|
|
45
|
+
- **These two tokens are the entire gap vocabulary, and their exact string is load-bearing.** Every downstream consumer — the `Action Required — SME Review Items` block, the gap counts, the `Status: ready` flip, Lane A's assumption carry-over, and any reviewer grepping the file — finds these items by exact match on `[SME REVIEW]` / `[DEFAULT]`.
|
|
46
|
+
- **Write the marker verbatim, with nothing else inside the brackets.** The explanatory note goes *after* the closing bracket: `| UiPath version | [SME REVIEW] not recorded in the PDD |`. Never fold the note inside (`[SME REVIEW — not recorded]`) and never substitute another word (`[PLACEHOLDER]`, `[TBD]`, `[TODO]`, `<fill in>`, `N/A`, prose like "to be confirmed"). A decorated or renamed marker is invisible to every consumer above — the gap silently disappears.
|
|
47
|
+
- **When you map or copy content out of another document** (a source SDD into a client template, a PDD into an SDD, one SDD section into another), **carry its markers through byte-for-byte.** Re-wording a marker you did not author destroys a gap someone else recorded. Add new markers for the gaps *you* find; never edit the ones already there.
|
|
45
48
|
11. **The terminal artefact of a Solution build is a packed `.uipx`.** The SDD's `## Next Steps` section points the user at the `uipath-solution` skill (`uip solution init` → `project add` per project → `resources refresh` → `pack`). A bare project folder is not the deliverable. Exception: when the Constraint Gate blocks Solutions for the delivery model — standalone, Automation Suite older than 2.2510, or a user exclusion — rewrite Next Steps to per-package Orchestrator publish routed via `uipath-platform`.
|
|
46
49
|
12. **Never copy SDD architecture into the plan, and never invent selectors or UI targets.** The plan references SDD section paths in skill prompts; it does not duplicate architecture content. Selectors require application inspection at development time — leave them for the specialist.
|
|
47
|
-
13. **Sole author of Case Management SDDs.** Every case design path — conversational, build handoff from `uipath-maestro-case`, draft finalization, PDD-driven — runs the Case Design Lane ([case-design-lane-guide.md](references/case-design-lane-guide.md)), which owns the conversation, the one confirmation, and the write; the case model and its defaults live in [case-design-layers-guide.md](references/case-design-layers-guide.md) and the render contract in the case SDD template. Design time resolves identities only — never schema discovery, project scaffolding, or create-on-missing; those are build concerns, recorded as gate decisions.
|
|
50
|
+
13. **Sole author of Case Management SDDs.** Every case design path — conversational, build handoff from `uipath-maestro-case`, draft finalization, PDD-driven — runs the Case Design Lane ([case-design-lane-guide.md](references/case/case-design-lane-guide.md)), which owns the conversation, the one confirmation, and the write; the case model and its defaults live in [case-design-layers-guide.md](references/case/case-design-layers-guide.md) and the render contract in the case SDD template. Design time resolves identities only — never schema discovery, project scaffolding, or create-on-missing; those are build concerns, recorded as gate decisions.
|
|
48
51
|
|
|
49
52
|
## Entry Guard
|
|
50
53
|
|
|
@@ -53,7 +56,7 @@ Run this guard before anything else.
|
|
|
53
56
|
```text
|
|
54
57
|
0. Product design-lane signals — checked first. Some products register a
|
|
55
58
|
dedicated Phase D design lane (today: Case Management —
|
|
56
|
-
references/case-design-lane-guide.md). Route to Phase D — Design through
|
|
59
|
+
references/case/case-design-lane-guide.md). Route to Phase D — Design through
|
|
57
60
|
the product's lane when any of these fire (the path taxonomy stays the three
|
|
58
61
|
paths above; a lane is Phase D's product-specific entrance):
|
|
59
62
|
- a build request handed off by that product's build skill because its
|
|
@@ -161,8 +164,8 @@ High-level view of what each specialist owns. **Do not describe internal flows o
|
|
|
161
164
|
| File | Purpose |
|
|
162
165
|
|------|---------|
|
|
163
166
|
| [SDD Generation Guide](references/sdd-generation-guide.md) | Phase orchestrator — Phase 1, 2, 3 step-by-step instructions |
|
|
164
|
-
| [Case Design Lane Guide](references/case-design-lane-guide.md) | The case design conversation — entry, tenant grounding, authoring policy, the one Case Review, and the write |
|
|
165
|
-
| [Case Design Layers Guide](references/case-design-layers-guide.md) | The case model and every design **Default** — skeleton (triggers, stages, the nine task types), gates (lifecycle rules, exits, sequencing, secondary lanes), data (variables, outputs, expressions), time (SLAs, escalations, responses), naming rules, and the closure checklist |
|
|
167
|
+
| [Case Design Lane Guide](references/case/case-design-lane-guide.md) | The case design conversation — entry, tenant grounding, authoring policy, the one Case Review, and the write |
|
|
168
|
+
| [Case Design Layers Guide](references/case/case-design-layers-guide.md) | The case model and every design **Default** — skeleton (triggers, stages, the nine task types), gates (lifecycle rules, exits, sequencing, secondary lanes), data (variables, outputs, expressions), time (SLAs, escalations, responses), naming rules, and the closure checklist |
|
|
166
169
|
| [PDD Analysis Guide](references/pdd-analysis-guide.md) | How to extract structured data from PDDs in any format |
|
|
167
170
|
| [Product Selection Guide](references/product-selection-guide.md) | **Constraint Gate** (delivery model + exclusions filter), **Level 1** (primary scope), **Level 1.75** (Solution composition), **Level 2.5 Part B** (cross-product project list merge), **Level 3** (capability add-ons), template mapping |
|
|
168
171
|
| [Platform Availability Guide](references/platform-availability-guide.md) | Product × delivery-model availability matrix (Cloud / Automation Suite / standalone), alternatives for blocked products, verification rule for uncertain cells. Load whenever the Constraint Gate runs — every delivery model: "Cloud is not uniform", variants (GovCloud / Dedicated / Test Cloud) and per-tenant entitlements can block products inside the Cloud column. |
|
|
@@ -179,7 +182,7 @@ High-level view of what each specialist owns. **Do not describe internal flows o
|
|
|
179
182
|
| [RPA Template](assets/templates/rpa-sdd-template.md) | SDD template for RPA Process / Library / Test Automation |
|
|
180
183
|
| [Flow Template](assets/templates/flow-sdd-template.md) | SDD template for Maestro Flow |
|
|
181
184
|
| [BPMN Template](assets/templates/bpmn-sdd-template.md) | SDD template for Maestro BPMN |
|
|
182
|
-
| [Case Management Template](assets/templates/case-sdd-template.md) | SDD template for Case Management (downstream Case Definition Blueprint shape) |
|
|
185
|
+
| [Case Management Template](assets/templates/case/case-sdd-template.md) | SDD template for Case Management (downstream Case Definition Blueprint shape) |
|
|
183
186
|
| [Agent Template](assets/templates/agent-sdd-template.md) | SDD template for UiPath Agents |
|
|
184
187
|
| [Coded App Template](assets/templates/coded-app-sdd-template.md) | SDD template for Coded Apps (web) |
|
|
185
188
|
| [API Workflow Template](assets/templates/api-workflow-sdd-template.md) | SDD template for API Workflows |
|
package/skills/uipath-planner/assets/templates/{case-sdd-template.md → case/case-sdd-template.md}
RENAMED
|
@@ -212,7 +212,7 @@ Config-as-In: runtime business rules (priority bands, thresholds, taxonomies) ri
|
|
|
212
212
|
**Purpose:** The case plan. Every stage has entry/exit conditions, optional SLA, and complete task detail blocks. Case has no BPMN-style edges; transitions are expressed by stage entry/exit conditions.
|
|
213
213
|
|
|
214
214
|
**Authoring rules** — this template IS the render contract: cell rules live inline at each cell. Design
|
|
215
|
-
semantics (type enum, gates, sequencing, SLA surface): [case-design-layers-guide.md](
|
|
215
|
+
semantics (type enum, gates, sequencing, SLA surface): [case-design-layers-guide.md](../../../references/case/case-design-layers-guide.md).
|
|
216
216
|
During draft finalization, do NOT open that link — the draft is the settled design and this template is
|
|
217
217
|
the complete normalization contract; finalization preserves existing display names verbatim.
|
|
218
218
|
Template-local rules:
|
|
@@ -605,7 +605,7 @@ there. Pass --draft so the gate also checks inventory parity, verbatim `=js:` pr
|
|
|
605
605
|
executable threshold encoding. What the DRAFT specifically needs repaired on the way through is the
|
|
606
606
|
lane guide's § Resumption; the shape is here.
|
|
607
607
|
|
|
608
|
-
Gate: run <py> "<skill folder>/scripts/audit_sdd.py" <sdd path> [--draft <draft path>] on the
|
|
608
|
+
Gate: run <py> "<skill folder>/scripts/case/audit_sdd.py" <sdd path> [--draft <draft path>] on the
|
|
609
609
|
on-disk file BEFORE the Status: ready flip — in every mode. `<py>` = the first of `python3`, `python`,
|
|
610
610
|
`py` that runs (Windows usually has no `python3` alias); only if all three are absent verify manually. RUN it, never open the script source —
|
|
611
611
|
its findings are the interface. Minting charset is ADVISORY — it never gates, and a name the user, the
|
|
@@ -18,7 +18,9 @@ The markdown SDD this skill writes is the **agent-first** artifact: implementati
|
|
|
18
18
|
|
|
19
19
|
3. **Match** each template section to its markdown-SDD source(s) per the crosswalk.
|
|
20
20
|
|
|
21
|
-
4. **Compute missing pieces.** For a template section with no direct SDD source, derive it from SDD data when present; when it needs information the SDD does not hold,
|
|
21
|
+
4. **Compute missing pieces.** For a template section with no direct SDD source, derive it from SDD data when present; when it needs information the SDD does not hold, write the literal marker `[SME REVIEW]` followed by what is needed, and add the item to a list the user must fill. Never fabricate.
|
|
22
|
+
|
|
23
|
+
> **Marker discipline (see SKILL.md Critical Rule 10).** `[SME REVIEW]` and `[DEFAULT]` are the only gap markers, written verbatim with nothing else inside the brackets — the note goes after the closing bracket (`[SME REVIEW] repository not recorded in the source SDD`). Do not invent a second vocabulary (`[PLACEHOLDER]`, `[TBD]`, `<fill in>`) and do not decorate the marker (`[SME REVIEW — …]`); both are invisible to the reviewer grepping the client document for open items. **Markers already in the source SDD copy through byte-for-byte** — this crosswalk relocates content, it never re-words a gap the SDD author recorded.
|
|
22
24
|
|
|
23
25
|
5. **Assemble** the matched + computed content into the template's section order, then convert:
|
|
24
26
|
|
|
@@ -37,17 +39,17 @@ RPA / Master-Project oriented. Left column = the template's sections; fill each
|
|
|
37
39
|
| **2. AUTOMATED PROCESS DETAILS** — Master Project Name, Robot Type, Orchestrator used?, Scalable, UiPath version | §1 (name) + §16 Deployment Environment (Robot type, Orchestrator, UiPath/Studio version, Scalable) | Direct map. `[SME REVIEW]` carries through where §16 is unfilled. |
|
|
38
40
|
| **3.1 Architectural structure** (diagram) | §10 Master Project Architecture data-flow diagram; §2 Process Map for a single project | Place the Mermaid diagram (render separately if images are needed). |
|
|
39
41
|
| **3.2 Master Project Runtime Details** | Production environment→§16; Prerequisites to run→§16 Runtime Prerequisites; Input Data→§5 Data Definitions; Expected output→§1/§5; How to start→§16 Trigger; Reporting→§16/§8; How is Orchestrator used→§16; Password/compliance→§15 Credentials & Assets + constraints; Stored credentials→§15; List of queue names→§12 Queue Architecture; Schedule→§16; Resolutions→§16 | Assemble one table from several SDD sections. |
|
|
40
|
-
| **3.3 Project name N** (per project) — dev environment, prerequisites, repository, configuration method, reused components, new reusable components | §10/§11 per sub-project; prerequisites→§16; configuration method→§15/§11; reused + new reusable components→§14 Packages / §11 (libraries) | One block per project in §10/§11. Dev-environment name and repository are usually `[SME REVIEW]`
|
|
42
|
+
| **3.3 Project name N** (per project) — dev environment, prerequisites, repository, configuration method, reused components, new reusable components | §10/§11 per sub-project; prerequisites→§16; configuration method→§15/§11; reused + new reusable components→§14 Packages / §11 (libraries) | One block per project in §10/§11. Dev-environment name and repository are usually `[SME REVIEW]` in §16 — carry the marker through verbatim. |
|
|
41
43
|
| **3.4 Project(s) workflows** — Workflow Name, Description (I/O params) | §3 Detailed Process Steps + §11 Project Structure (workflow list) | — |
|
|
42
44
|
| **3.5 Packages** — Package name, Description | §14 Packages | Direct map. |
|
|
43
45
|
| **3.6 Architectural structure** (2nd diagram) | §12 Queue Architecture diagram, or an alternate §10 view | May duplicate 3.1 in the template — emit the queue/running-order view here. |
|
|
44
|
-
| **4.1 Future improvements** | Out of Scope items + open `[SME REVIEW]` items | Compute candidates; else
|
|
45
|
-
| **4.2 Other remarks** | Assumptions / `[DEFAULT]` notes |
|
|
46
|
+
| **4.1 Future improvements** | Out of Scope items + open `[SME REVIEW]` items | Compute candidates; else one `[SME REVIEW]` line for the user. |
|
|
47
|
+
| **4.2 Other remarks** | Assumptions / `[DEFAULT]` notes | One `[SME REVIEW]` line if none. |
|
|
46
48
|
| **5. GLOSSARY** | The template's standard term list | Reuse as-is; append process-specific terms only if the SDD defined any. |
|
|
47
49
|
|
|
48
50
|
## Section gaps
|
|
49
51
|
|
|
50
|
-
- **Template section with no SDD source** → compute from SDD data; if it needs engagement info the SDD lacks (dev-environment names, repository paths, commercials, timeline),
|
|
52
|
+
- **Template section with no SDD source** → compute from SDD data; if it needs engagement info the SDD lacks (dev-environment names, repository paths, commercials, timeline), write `[SME REVIEW]` plus what is needed. Every such section ends up carrying the literal `[SME REVIEW]` string — that is how the reviewer finds them.
|
|
51
53
|
- **SDD section with no template home** (e.g. §17 Testing Strategy, §4 Business Rules, §6 Value Mappings when the template omits them) → append under the nearest fit or an appendix; do not silently drop content.
|
|
52
54
|
|
|
53
55
|
## Non-RPA SDDs
|
|
@@ -8,9 +8,9 @@ Case knowledge is split three ways. Read all three to begin, in parallel, **at m
|
|
|
8
8
|
|---|---|
|
|
9
9
|
| this file | the conversation: entry, tenant grounding, authoring policy, the one confirmation, the write |
|
|
10
10
|
| [case-design-layers-guide.md](case-design-layers-guide.md) | the case model and every design **Default** — skeleton, gates, data, SLAs, naming, the closure checklist |
|
|
11
|
-
| [`case-sdd-template.md`](
|
|
11
|
+
| [`case-sdd-template.md`](../../assets/templates/case/case-sdd-template.md) | the render contract — skeleton, cell rules inline, validation footer |
|
|
12
12
|
|
|
13
|
-
That is the COMPLETE design reading set. NEVER read `scripts/audit_sdd.py` — scripts are RUN, and their findings are the interface. Do NOT read the generic Phase D references (pdd-analysis, product-selection beyond the Constraint Gate): scope is already decided. Reference paths resolve against this skill's base directory, given at invocation — never hunt with `find` / global `ls`. Everything after the SDD (tasks.md, caseplan.json, validate, publish) belongs to `uipath-maestro-case`.
|
|
13
|
+
That is the COMPLETE design reading set. NEVER read `scripts/case/audit_sdd.py` — scripts are RUN, and their findings are the interface. Do NOT read the generic Phase D references (pdd-analysis, product-selection beyond the Constraint Gate): scope is already decided. Reference paths resolve against this skill's base directory, given at invocation — never hunt with `find` / global `ls`. Everything after the SDD (tasks.md, caseplan.json, validate, publish) belongs to `uipath-maestro-case`.
|
|
14
14
|
|
|
15
15
|
**Draft finalization reads less (hard):** this file's §Resumption + §Terminal step, `sdd.draft.md`, and the template (its validation footer is the gate) — once each. NOT the layers guide: finalization normalizes structure, it does not redesign. No subagents, no background tasks, no tenant discovery unless identities are needed and a session exists.
|
|
16
16
|
|
|
@@ -106,7 +106,7 @@ When the user mentions `file`, `attachment`, `PDF`, `upload`, `evidence`, `recei
|
|
|
106
106
|
|
|
107
107
|
### Sketch — best assumption, every field
|
|
108
108
|
|
|
109
|
-
Fill the complete SDD shape against [`case-sdd-template.md`](
|
|
109
|
+
Fill the complete SDD shape against [`case-sdd-template.md`](../../assets/templates/case/case-sdd-template.md) from what Listen captured. Every open field takes the **Default** stated in its layer ([case-design-layers-guide.md](case-design-layers-guide.md)) — decided and disclosed, never asked. Platform schema and compliance constraints override user phrasing (§Authoring policy): apply silently, then surface as a decision line.
|
|
110
110
|
|
|
111
111
|
Settle before Confirm: case name, prefix, ≥ 1 trigger, ≥ 1 stage, ≥ 1 typed task per stage, ≥ 1 case exit — by user input or by layer default.
|
|
112
112
|
|
|
@@ -210,7 +210,7 @@ On the accept answer: write the SDD to disk in batches, gate it, flip it. The mo
|
|
|
210
210
|
| Direct design (design/generate a case SDD, greenfield, no PDD) | `<CASE_NAME_KEBAB>-sdd.md` | STOP — the write is a turn boundary; `## Next Steps` points at Lane A or `uipath-maestro-case` for a later, opt-in turn |
|
|
211
211
|
| Draft request (user asked for a reviewable draft and to stop) | `sdd.draft.md`, or `<name>-sdd.draft.md` when the request names the file | STOP. Never promote a draft |
|
|
212
212
|
| Draft finalization (a `sdd.draft.md` exists, user asks to finalize) | the draft's basename minus `.draft` | STOP. §Resumption owns the procedure; the draft stays on disk beside the final |
|
|
213
|
-
| PDD-driven case (a PDD routed to Phase D, scope picked Case Management) | the standard Phase D output path ([sdd-generation-guide.md](sdd-generation-guide.md)) | Standard Phase D flow — the case body still obeys the layers guide and the template |
|
|
213
|
+
| PDD-driven case (a PDD routed to Phase D, scope picked Case Management) | the standard Phase D output path ([sdd-generation-guide.md](../sdd-generation-guide.md)) | Standard Phase D flow — the case body still obeys the layers guide and the template |
|
|
214
214
|
|
|
215
215
|
Never write `sdd.md` AND `<case>-sdd.md` for the same design. Report the path in one line.
|
|
216
216
|
|
|
@@ -243,7 +243,7 @@ user-facing** (Resources and Integrations carries every user-relevant outcome).
|
|
|
243
243
|
|
|
244
244
|
## HTML preview
|
|
245
245
|
|
|
246
|
-
Optional, **on-request only** — never offered proactively. Self-contained local HTML review of the case design (Case Definition, collapsible Stages & Tasks, Personas, Integrations; filters and search). Generation: Read [`assets/templates/sdd-viewer.html`](
|
|
246
|
+
Optional, **on-request only** — never offered proactively. Self-contained local HTML review of the case design (Case Definition, collapsible Stages & Tasks, Personas, Integrations; filters and search). Generation: Read [`assets/templates/case/sdd-viewer.html`](../../assets/templates/case/sdd-viewer.html), replace the `__SDD_DATA__` token in its `<script id="sdd-data">` block with JSON serialized from the in-memory model (schema in the template's header comment — do NOT re-parse the SDD when the model is live), Write `./sdd-viewer.html`, tell the user: `Generated ./sdd-viewer.html — open it in a browser to review.` Failure → one-line notice, continue. Downstream build phases ignore this file.
|
|
247
247
|
|
|
248
248
|
## Resumption
|
|
249
249
|
|
|
@@ -274,7 +274,7 @@ If the user explicitly asks to finalize the existing draft, choose `Use the draf
|
|
|
274
274
|
10. Write, gate, flip per §Terminal step (the draft on disk is also a recovery point, so a compaction means re-finalizing from it), then the audit with the draft comparison:
|
|
275
275
|
|
|
276
276
|
```bash
|
|
277
|
-
python3 "<this skill's folder>/scripts/audit_sdd.py" <final SDD path> --draft <draft path>
|
|
277
|
+
python3 "<this skill's folder>/scripts/case/audit_sdd.py" <final SDD path> --draft <draft path>
|
|
278
278
|
# python3 absent (common on Windows) → retry the same line with `python`, then `py`
|
|
279
279
|
```
|
|
280
280
|
|
|
@@ -41,7 +41,7 @@ Reason the shape from the process — never reach for the template first. Build
|
|
|
41
41
|
|
|
42
42
|
### Task types
|
|
43
43
|
|
|
44
|
-
<!-- parsed at runtime by scripts/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
44
|
+
<!-- parsed at runtime by scripts/case/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
45
45
|
|
|
46
46
|
The enum is closed — exactly these nine literals, used verbatim as the SDD `Type:` value. The `type` says **how the work gets done**, not what it is about — read the verb + the actor:
|
|
47
47
|
|
|
@@ -112,7 +112,7 @@ The case, each stage, and each task move through gates driven by **rules** in di
|
|
|
112
112
|
|
|
113
113
|
### Lifecycle gates
|
|
114
114
|
|
|
115
|
-
<!-- parsed at runtime by scripts/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
115
|
+
<!-- parsed at runtime by scripts/case/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
116
116
|
|
|
117
117
|
| Gate | Marks complete | Legal WHEN rules |
|
|
118
118
|
|---|---|---|
|
|
@@ -400,7 +400,7 @@ Never author `start-task` as a stage-entry row on the breached stage: it validat
|
|
|
400
400
|
|
|
401
401
|
### Naming rules
|
|
402
402
|
|
|
403
|
-
<!-- parsed at runtime by scripts/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
403
|
+
<!-- parsed at runtime by scripts/case/audit_sdd.py — do not rename this heading or reshape this table/fence; a rename disarms the checks and audit_sdd.py will report "model checks disarmed" -->
|
|
404
404
|
|
|
405
405
|
Safe display characters for stage labels, task display names, and condition/SLA/escalation titles:
|
|
406
406
|
|
|
@@ -427,7 +427,7 @@ Comparison exact — case-sensitive, untrimmed. Never normalize external lookup
|
|
|
427
427
|
|
|
428
428
|
## Layer closure — the design checklist
|
|
429
429
|
|
|
430
|
-
ONE checklist. Settle every item by assumption during Sketch; re-walk at Confirm (fix failures silently — authoring defects, not user decisions; unfixable → Review Flags). Mechanical shape/contract checks are NOT here — `scripts/audit_sdd.py` owns them (enforcement list: template § Validation); run it on the written file.
|
|
430
|
+
ONE checklist. Settle every item by assumption during Sketch; re-walk at Confirm (fix failures silently — authoring defects, not user decisions; unfixable → Review Flags). Mechanical shape/contract checks are NOT here — `scripts/case/audit_sdd.py` owns them (enforcement list: template § Validation); run it on the written file.
|
|
431
431
|
|
|
432
432
|
**Blocking — the design is unbuildable or unreviewable until fixed:**
|
|
433
433
|
|
|
@@ -554,7 +554,7 @@ Based on the Level 1 primary, select one template:
|
|
|
554
554
|
| RPA Process, Library, Test Automation | `../assets/templates/rpa-sdd-template.md` |
|
|
555
555
|
| Maestro Flow | `../assets/templates/flow-sdd-template.md` |
|
|
556
556
|
| Maestro BPMN | `../assets/templates/bpmn-sdd-template.md` |
|
|
557
|
-
| Case Management | `../assets/templates/case-sdd-template.md` |
|
|
557
|
+
| Case Management | `../assets/templates/case/case-sdd-template.md` |
|
|
558
558
|
| Agents | `../assets/templates/agent-sdd-template.md` |
|
|
559
559
|
| Coded Apps | `../assets/templates/coded-app-sdd-template.md` |
|
|
560
560
|
| API Workflows | `../assets/templates/api-workflow-sdd-template.md` |
|
|
@@ -304,7 +304,7 @@ The architectural core sections differ per template. For each product, generate
|
|
|
304
304
|
- §3 Personas & App Views
|
|
305
305
|
- §4 Integrations (resource roll-up for connectors, API workflows, agents, processes/RPA, child cases, external agents, IXP models, coded functions)
|
|
306
306
|
- Case section headings render in the template's long form (`## Section 1: Case Definition`, …) — the heading TEXT is load-bearing downstream (`uipath-maestro-case` parses it verbatim); `§N` is the reference notation in planner docs only. Do not emit the legacy planner-only `§3 Stages` / `§4 Tasks Grid` / `§13 Task Type Registry` format.
|
|
307
|
-
- Case body content obeys [case-design-layers-guide.md](case-design-layers-guide.md) (model, authoring method, closure checklist) and the case SDD template's inline render contract (gate: `audit_sdd.py` per its § Validation footer); tenant grounding runs per the lane's §Tenant grounding. For conversational (non-PDD) case requests, delegated case design, and case draft finalization, the whole flow is the Case Design Lane — [case-design-lane-guide.md](case-design-lane-guide.md) — not the generic 3-phase model in this guide.
|
|
307
|
+
- Case body content obeys [case-design-layers-guide.md](case/case-design-layers-guide.md) (model, authoring method, closure checklist) and the case SDD template's inline render contract (gate: `audit_sdd.py` per its § Validation footer); tenant grounding runs per the lane's §Tenant grounding. For conversational (non-PDD) case requests, delegated case design, and case draft finalization, the whole flow is the Case Design Lane — [case-design-lane-guide.md](case/case-design-lane-guide.md) — not the generic 3-phase model in this guide.
|
|
308
308
|
|
|
309
309
|
**Agents:**
|
|
310
310
|
- §2 Agent Framework (LangGraph / LlamaIndex / OpenAI Agents / Simple Function)
|
|
@@ -222,7 +222,7 @@ def lineage_findings(text: str) -> list[str]:
|
|
|
222
222
|
return findings
|
|
223
223
|
|
|
224
224
|
|
|
225
|
-
LAYERS_MD = Path(__file__).resolve().parent.parent / "references" / "case-design-layers-guide.md"
|
|
225
|
+
LAYERS_MD = Path(__file__).resolve().parent.parent.parent / "references" / "case" / "case-design-layers-guide.md"
|
|
226
226
|
|
|
227
227
|
|
|
228
228
|
def load_model_facts() -> tuple[dict, str | None]:
|
package/version-manifest.json
CHANGED
|
File without changes
|