You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 6e77d70
Browse filesBrowse the repository at this point in the historyBrowse files
Align the planner's genome writing with main and close the edit verb's read gaps
Ports main's extraction rules the split missed: code that substitutes for an
activity package is a wrapper, not a component (#4403); the run's log goes to the
Orchestrator job log by default (#4403); parts run at most two at once (#4441);
an unused technology-only action stays out of the genome (#4506).
The edit verb now reads the guides its "SDD was revised" and build-findings rows
redo, takes design changes on a designed genome back to the SDD, and rewrites a
pre-split preamble. Templates carry the SDD fingerprint and the Requested change
row; complexity ties go lower again.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: skills/uipath-planner/assets/templates/component-genome-template.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@
11
11
12
12
> Part of: {Process name} — {one line on this component's role in the process}. *(Write the process name as a markdown link to `../{process-slug}-genome.md`. Omit this line for a standalone automation.)*
13
13
14
-
> Designed in: [{SDD title}]({relative path to the SDD}) *(Only when the genome is authored from an agreed SDD; omit otherwise.)*
14
+
> Designed in: [{SDD title}]({relative path to the SDD}) · sdd-sha256 {SDD_FINGERPRINT} *(Only when the genome is authored from an agreed SDD; omit otherwise.)*
15
15
16
16
## Overview
17
17
@@ -153,10 +153,11 @@ Outcomes — these rows, whatever the source calls its per-item results (approve
153
153
| Row | Source artifact | Notes |
154
154
|-----|-----------------|-------|
155
155
| {Dead code / Unresolved invocation / Inferred / a finding} | {Source framework}: `{Name}` ({id}) | {what it is, the lines that show it} |
156
+
| Requested change | {only when the request asks for a change: the user's words} | {each decision by builder topic — `Target: <component> → <product>`, `Retire: <entry point>`, `Fold: <reader> into <writer>`; a split decision is that flow's `Decided:` line alone} |
156
157
| Related resources | {path or link} — {kind} | {what it settled, or "not read" and why} |
157
158
| Resource discrepancies | {resource}: {what it says} | {what the source does} |
158
159
159
-
*A component of a process genome inherits the Source framework, Source export, Inventory, Not covered, Unused and Related resources rows from the process genome; a standalone component genome carries them itself.*
160
+
*A component of a process genome inherits the Source framework, Source export, Requested change, Inventory, Not covered, Unused and Related resources rows from the process genome; a standalone component genome carries them itself.*
Copy file name to clipboardExpand all lines: skills/uipath-planner/assets/templates/process-genome-template.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@
10
10
11
11
> **This is a UiPath automation blueprint.** Do not execute these steps directly. Build it with the **uipath-genome** skill, which builds each component with the skill named in **Components**, then wires them per **Handoffs** and **Deployment**.
12
12
13
-
> Designed in: [{SDD title}]({relative path to the SDD}) *(Only when the genome is authored from an agreed SDD; omit otherwise.)*
13
+
> Designed in: [{SDD title}]({relative path to the SDD}) · sdd-sha256 {SDD_FINGERPRINT} *(Only when the genome is authored from an agreed SDD; omit otherwise.)*
14
14
15
15
## Overview
16
16
@@ -174,9 +174,10 @@ Outcomes — these rows, whatever the source calls its per-item results (approve
174
174
|-----------|-----------------|-------|
175
175
| Source framework | {`UiPath` for a UiPath source, else the framework name as the migration pack's README spells it} {version the source states} ||
176
176
| Source export | {root path as read at extraction} | {identity: database or tenant, export date, process count — what recognises a moved copy} |
177
+
| Requested change | {only when the request asks for a change: the user's words} | {each decision by builder topic — `Target: <component> → <product>`, `Retire: <entry point>`, `Fold: <reader> into <writer>`; a split decision is that flow's `Decided:` line alone} |
177
178
| {Component} | {Source framework}: {project / solution / object} — `{Name}` ({id}) per object where names repeat | {ambiguity or unresolved reference} |
178
-
| Not covered | {live entry points, public workflows or test cases of the extracted projects that no step is built from — `{Name}` ({id})} | {what each does; left out because nothing reaches it and the Unused parts answer kept to what runs, or the request named others} |
179
-
| Unused | {workflows, pages and helpers no caller invokes that the Unused parts answer left out — `{Name}` ({id})} | {what each does} |
179
+
| Not covered | {live entry points, public workflows or test cases of the extracted projects that no step is built from — `{Name}` ({id})} | {what each does; left out because nothing reaches it and the Unused parts answer kept to what runs or it only works a technology UiPath's activities cover, or the request named others} |
180
+
| Unused | {workflows, pages and helpers no caller invokes that extraction left out — `{Name}` ({id})} | {what each does} |
180
181
| Excluded / unreachable | {objects the source guide excludes; dead code, superseded copies, objects reached only through disabled calls — by name} | {why} |
181
182
| Inventory | {processes, windows, controls (n without a locator), recordsets, rows, credential accounts} | {counts the inventory script reported; execution re-derives the catalogs from the export} |
182
183
| Related resources | {path or link} — {kind} | {what it settled, or "not read" and why} |
Copy file name to clipboardExpand all lines: skills/uipath-planner/references/edit/edit-guide.md
+7-1Lines changed: 7 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,17 +10,23 @@ The writing rules of [genome-format-guide.md § Writing Rules](../shared/genome-
10
10
|---|---|---|
11
11
| start | — | this guide whole; [genome-format-guide.md](../shared/genome-format-guide.md) every section before § Design Links for a process genome and every section before § Process Genome Sections for a component genome (the level in the genome's first-line marker), plus § Design Links when the genome has a `Designed in:` line; [extracted-genome-guide.md](../shared/extracted-genome-guide.md) when the genome has a Source Map with a step table; [transactional-shape-guide.md](../shared/transactional-shape-guide.md) when the edit touches the Transactional Shape, or a step, rule or handler of a genome whose Transactional Shape is not the stub |
12
12
| a related resource is given | the genome is extracted and the user hands over a PDD, SOP, runbook or other resource beside the source |[extract-guide.md](../extract/extract-guide.md) Step 1 (the related-resources question) and Step 3's **Related resources** paragraph |
13
+
| "The SDD was revised: update the genome" | — |[genome-from-sdd-guide.md](../author/genome-from-sdd-guide.md) whole, plus the rows of its own Read Plan; [skill-mapping-guide.md](../shared/skill-mapping-guide.md); [transactional-shape-guide.md](../shared/transactional-shape-guide.md) § Layout (the `Decided:` line) and § Split options and evidence when the SDD records a split |
14
+
| "Findings from `uipath-genome`" | a finding names a Build With skill (a retired name) |[skill-mapping-guide.md](../shared/skill-mapping-guide.md)|
13
15
| partial re-extraction | — |[extract-guide.md](../extract/extract-guide.md), [defect-verification-guide.md](../shared/defect-verification-guide.md) and the source guide, as for `extract`; [extraction-parts-guide.md](../shared/extraction-parts-guide.md) when the list runs in parts |
14
16
15
17
Each phase's reads go out in at most three turns: turn 1 every file read whole and the heading list of every file read by section; turn 2 the sections chosen; turn 3 only what turn 2 routed to.
16
18
17
19
## Edits
18
20
21
+
Every edit rewrites a legacy preamble (one naming `uipath-genome`) to the template's preamble ([genome-format-guide.md § Two Levels](../shared/genome-format-guide.md) rule 5).
22
+
19
23
### Any genome
20
24
25
+
On a genome with a `Designed in:` line only the first two rows are edits. Any other change — products, projects, components, a skill, a step's design — goes to `design` to revise the linked SDD; the fingerprint then drives "The SDD was revised" to update the genome.
26
+
21
27
| Request | Update |
22
28
|---|---|
23
-
| "The SDD was revised: update the genome" (from `uipath-genome`, or the user) | Read the SDD the `Designed in:` line links whole and redo [genome-from-sdd-guide.md](../author/genome-from-sdd-guide.md) items 3–6 against it: every section whose SDD content changed is rewritten, nothing else is. Then take the SDD's fingerprint again and rewrite the `Designed in:` line ([genome-format-guide.md § Design Links](../shared/genome-format-guide.md)). An unattended build's request applies the edit without offering it; the closing summary names the sections changed |
29
+
| "The SDD was revised: update the genome" (from `uipath-genome`, or the user) | Read the SDD the `Designed in:` line links whole and redo [genome-from-sdd-guide.md](../author/genome-from-sdd-guide.md) items 3–6 against it: every section whose SDD content changed is rewritten, nothing else is. Then take the fingerprint again, over the root and every child SDD it lists for a solution, and rewrite the `Designed in:` line ([genome-format-guide.md § Design Links](../shared/genome-format-guide.md)). An unattended build's request applies the edit without offering it; the closing summary names the sections changed |
24
30
| "Findings from `uipath-genome`" (from the build, or the user forwarding its report) | Apply each finding where it points: a checker `FAIL` → the section and rule it names ([genome-format-guide.md § Writing Rules](../shared/genome-format-guide.md)); a genome deviation → the step the source contradicts, written as the build followed it unless the user rules otherwise; a retired skill name → the Build With row, from [skill-mapping-guide.md](../shared/skill-mapping-guide.md); a `Not covered` object to build → [extract-guide.md § Partial Re-extraction](../extract/extract-guide.md). A build's request applies the edits without offering them |
25
31
| "Add detail to step X" | Workflow step X; add acceptance criteria if detail is testable |
26
32
| "Change complexity" / "complexity should be higher or lower" | Complexity section, then section depth per population matrix |
0 commit comments