Skip to content

Commit 6e77d70

Browse files
RaduAna-Mariaclaude
andcommitted
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>
1 parent 241f2ba commit 6e77d70

8 files changed

Lines changed: 26 additions & 18 deletions

File tree

‎skills/uipath-planner/assets/templates/component-genome-template.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
1212
> 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.)*
1313
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.)*
1515
1616
## Overview
1717

@@ -153,10 +153,11 @@ Outcomes — these rows, whatever the source calls its per-item results (approve
153153
| Row | Source artifact | Notes |
154154
|-----|-----------------|-------|
155155
| {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} |
156157
| Related resources | {path or link} — {kind} | {what it settled, or "not read" and why} |
157158
| Resource discrepancies | {resource}: {what it says} | {what the source does} |
158159

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.*
160161

161162
### Steps
162163

‎skills/uipath-planner/assets/templates/process-genome-template.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
1111
> **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**.
1212
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.)*
1414
1515
## Overview
1616

@@ -174,9 +174,10 @@ Outcomes — these rows, whatever the source calls its per-item results (approve
174174
|-----------|-----------------|-------|
175175
| Source framework | {`UiPath` for a UiPath source, else the framework name as the migration pack's README spells it} {version the source states} | |
176176
| 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} |
177178
| {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} |
180181
| Excluded / unreachable | {objects the source guide excludes; dead code, superseded copies, objects reached only through disabled calls — by name} | {why} |
181182
| 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} |
182183
| Related resources | {path or link} — {kind} | {what it settled, or "not read" and why} |

‎skills/uipath-planner/references/edit/edit-guide.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,23 @@ The writing rules of [genome-format-guide.md § Writing Rules](../shared/genome-
1010
|---|---|---|
1111
| 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 |
1212
| 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) |
1315
| 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 |
1416

1517
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.
1618

1719
## Edits
1820

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+
1923
### Any genome
2024

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+
2127
| Request | Update |
2228
|---|---|
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 |
2430
| "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 |
2531
| "Add detail to step X" | Workflow step X; add acceptance criteria if detail is testable |
2632
| "Change complexity" / "complexity should be higher or lower" | Complexity section, then section depth per population matrix |

0 commit comments

Comments
 (0)