Skip to content

Make the planner SKILL.md a verb router and finalise plan and decompose (4/6) [PILOT-9071] - #4330

Merged
RaduAna-Maria merged 11 commits into
mainfrom
feat/genome-stack-4-sdd-and-genome
Nov 12, 2026
Merged

RaduAna-Maria merged 11 commits into
mainfrom
feat/genome-stack-4-sdd-and-genome

Conversation

@RaduAna-Maria

@RaduAna-Maria RaduAna-Maria commented Nov 2, 2026 •

Copy link
Copy Markdown
Collaborator

Issue

PILOT-9071

Stack 4 of 6 (#4327 → #4328 → #4329 → #4330 → #4358 → #4379), merged together.

Summary

  • SKILL.md routes by verb; decompose/decompose-guide.md keeps the dated plan
  • Retire the plan verb: an SDD goes design → author (genome) → uipath-build-from-genome; plan-guide.md, Pattern 7 and the Tasks file handoff row are gone
  • Add a caller contract to design: a planner-design-request: v1 block in, one planner-design-result: v1 block out (references/design/caller-request-guide.md) — for Delegate's business-analysis Phase 4 (UiPath/Autopilot#8610)
  • Every SDD template marks its body start with <!-- planner-sdd-body:v1 -->; Template validation: passed now means "every section present", whatever the Status
  • No catalog connector → custom connector; direct HTTP only with an SDD justification
  • Critical Rule 2: every verb reads by its Read Plan, never file by file

Task ids change: lane_* → decompose_*; the plan_* tasks are removed and plan_marker_detect becomes sdd_build_routing.

Caller contract

  • Request carries what the caller settled: source, facts, output, product (counts as user-named), execution, language, audience: business, open-item-marker (→ [SME REVIEW]), existing-output: replace, stop-after: sdd, traceability: required (Alternatives Considered + Requirements Traceability sections), frames (annotated UI frames beside each robot-driven step), diagram (agreed Mermaid map used verbatim), client Word template, one-section revise
  • execution missing → the planner asks it once; interactive keeps one checkpoint (the Phase 2 review), autonomous none; no language, keep/regenerate or SME questions; stop-after: sdd skips the genome and the turn boundary
  • Hooks in SKILL.md, design-guide.md, sdd-writing-guide.md and scope-recommendation-guide.md point at the guide; flavor blocks untouched

Testing

  • tests/scripts/test_planner_sdd_contract.py (17 checks), added to the uipath-planner checker unit tests job
  • pytest tests/tasks/uipath-planner + contract guard: 264 passed at the stack top; skills:validate and skills:check-links OK

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

skill-lint: 0 new errors, 2 new warnings

Rule Location Message
warning AGENT-READ-TRUNCATED skills/uipath-planner/references/design/design-guide.md:1 40,302 bytes, 302 lines: Codex keeps 10,000 tokens (40,000 bytes) of one read. Split it or route to smaller files
warning AGENT-READ-TRUNCATED skills/uipath-planner/references/shared/genome-format-guide.md:1 40,028 bytes, 230 lines: Codex keeps 10,000 tokens (40,000 bytes) of one read. Split it or route to smaller files
What these rules check
  • AGENT-READ-TRUNCATED: Markdown files an agent reads should fit in one read of each target agent. Each agent caps what one read returns. Codex keeps 10,000 tokens, counted as UTF-8 bytes / 4, and drops the middle. Delegate's ReadFile, which LoadSkill also uses, returns the first 2,000 lines and at most 100,000 characters of them. Claude Code's Read returns the first ~25,000 tokens with a partial-view notice and, by default, refuses a whole file over 256 KB. Gemini CLI's read_file returns the first 2,000 lines and cuts lines over 2,000 characters. Past a cap the agent sees part of the file unless it reads it in pages. Split the file, or move detail into smaller references the skill routes to. SKILL.md is checked for Codex and Delegate only: Claude Code and Gemini load it whole when the skill activates. Claude Code's count is real tokens, estimated with claude_code_bytes_per_token; the others are exact.

Only what this PR adds is listed, compared with the commit it branched from; issues already on the base branch are not. Updated on every push.

@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch 2 times, most recently from 6d2a153 to 9e92432 Compare November 2, 2026 17:03
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch 3 times, most recently from de4aa62 to 9a9f6e0 Compare November 2, 2026 17:38
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from 9a9f6e0 to 90cf3f1 Compare November 3, 2026 10:05
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from 90cf3f1 to 6321c66 Compare November 3, 2026 13:57
@RaduAna-Maria RaduAna-Maria changed the title Write the genome of a ready SDD by default and build it through Pattern 7 (4/4) [PILOT-9071] Write the genome of a ready SDD by default and build it through Pattern 7 (4/6) [PILOT-9071] Nov 3, 2026
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from 6321c66 to b5adc48 Compare November 4, 2026 13:34
@RaduAna-Maria RaduAna-Maria changed the title Write the genome of a ready SDD by default and build it through Pattern 7 (4/6) [PILOT-9071] Make the planner SKILL.md a verb router and finalise plan and decompose (4/6) [PILOT-9071] Nov 4, 2026
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from b5adc48 to d3570ef Compare November 4, 2026 14:52
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch 2 times, most recently from 2fb5977 to f5b22b6 Compare November 4, 2026 16:17
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from 1df6636 to f95de9a Compare November 10, 2026 14:58

@danmunteanu1 danmunteanu1 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Commented · 2 blockers · 2 non-blockers
Re-review: new findings on this PR's fix commits; replies are on the earlier threads, and the stack-wide summary is on #4379.

Comment thread skills/uipath-planner/SKILL.md Resolved
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from f95de9a to 4011656 Compare November 10, 2026 15:48
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Smoke test coverage gap — the following changed skills have no tests under tests/tasks/:

  • uipath-genome

Consider adding smoke tests before merging.

@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from 4011656 to ca03a1b Compare November 11, 2026 09:25
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch 3 times, most recently from ec6ba6c to e5c775f Compare November 12, 2026 08:56
Base automatically changed from feat/genome-stack-3-genome-split to main November 12, 2026 08:56
RaduAna-Maria and others added 11 commits November 12, 2026 10:56
SKILL.md routes design, plan, decompose, author, extract and edit; the
lane guides become plan/plan-guide.md and decompose/decompose-guide.md
and the guides several verbs read move to references/shared. plan hands
a genome build to uipath-genome (Pattern 7). Lane-era task
ids are renamed to plan_* and decompose_*.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An SDD now goes to author for its genome and then to
uipath-genome, so design chains design -> author -> build. The
Tasks file handoff row, plan-guide.md, Pattern 7 and the per-skill task
fallback are gone; a publish asked for in the request follows the build.
decompose keeps its plan and takes over the UI question batch, and
plan-and-tasks-format.md describes only the decompose plan. The plan_*
tasks are removed and plan_marker_detect becomes sdd_build_routing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A skill that owns the business conversation (Delegate's business analysis)
ran design by reading the planner's guides and translating its phases, so
each planner restructure broke it. A planner-design-request block now fixes
what that caller decides (source, output, product, language, audience,
open-item marker, regenerate, stop after the SDD, client Word template,
one-section revise), holds the run to the architecture review, and ends it
with a planner-design-result block. Every SDD template marks its body start,
and a contract guard keeps the signals a caller's host reads in place.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The guide described the calling skill and this skill from outside, like an
interface spec, while every other planner guide instructs the agent running
the verb. It now tells that agent what to do with each request key, which
steps change, and what to write as the result; the contract is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ates

The calling skill was translating the planner's question and subagent
instructions for its host. The planner now states it: ask in the host's own
question tool, and do subagent work inline, since the user is present.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…mes and its process map

Delegate's Cartographer lets the user run solution design autonomously and
requires source-linked traceability, annotated UI frames and the agreed
process map in the SDD; it had been instructing the planner's templates
directly. The request now carries those choices (execution, traceability,
frames, diagram) and the planner owns what each one puts in the SDD. A
missing execution key is asked once, as Step 0 already does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… SDD

Delegate's business-analysis skill checked the planner's SDD images with a
script of its own; it now leaves that to the planner, so the frames key
states the rule the script enforced.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…d-off

Choosing the Verb item 2, author Step 9 and design's build turn passed only
the genome path. The builder then inferred build or check from the
conversation, and a subagent boundary dropped the user's wording, which is
the only thing that waives the build's configuration questions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The skill-sdd-* IDs named the tasks after the document, not the skill or
verb that writes it; they are now skill-planner-design-*, beside the
skill-planner-case-* and skill-planner-genome-* tasks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… tighten the planner router

A design change on a genome with a Designed in: line goes to design revise on
its SDD; the fingerprint, now required and covering a solution's root and every
child SDD, then drives the edit. genome-from-sdd resolves a child SDD to its
root and stops on a missing or draft child. The checker fails an unpinned
Designed in: line on strict and names the behaviour, not planner files.

Router: Critical Rule 1 applies to deliverables only, the gap-marker detail and
most of the design navigation move to the design guides, and the description
gets back the blueprint, refactor and rebuild triggers within the listing
budget. Word PDDs are read again through any converter on the machine; design
reads the whole template and copies table columns verbatim (main #4563); a
correction after the SDD goes to the SDD before the genome.

Studio Web blocks shrink to the clauses that differ, dropping the stale
turn-boundary copy. Ports #4403's shared-behaviour and run-log rules into the
format guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RaduAna-Maria
RaduAna-Maria force-pushed the feat/genome-stack-4-sdd-and-genome branch from e5c775f to ef7fdad Compare November 12, 2026 08:56
@RaduAna-Maria
RaduAna-Maria merged commit 9e33121 into main Nov 12, 2026
35 of 40 checks passed
@RaduAna-Maria
RaduAna-Maria deleted the feat/genome-stack-4-sdd-and-genome branch November 12, 2026 08:57
alexenica added a commit that referenced this pull request Nov 12, 2026
…ation smoke

skill-planner-smoke-skill-activation asks the agent to write the verbs
the skill defines and grades them against skills/uipath-planner/SKILL.md
§ Verbs. 9e33121 (#4330, PILOT-9071) wrote that assertion with `build`,
but the planner's verbs at that commit were design, decompose, author,
extract and edit: `build` belongs to uipath-genome (its SKILL.md § Verbs).
a4ccda0 (#4379) then added `check`. So an agent that copies the table
correctly scored 4/5 = 0.85 and failed every run, on main too (#4638,
run 43209115399).

Align only the includes list to the current table: design, decompose,
author, extract, edit, check. Weight, pass_threshold, tags, prompt and
the planner skill are unchanged. Checked with coder-eval's own
file_contains code: the current verbs pass at 1.00; the old list with
build (0.67), either missing verb (0.83) and build alone (0.00) fail.
The CI agent's real paths.txt from run 43238788631 scores 6/6.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
alexenica added a commit that referenced this pull request Nov 13, 2026
…es (cli#6015) (#4647)

* fix(uipath-knowledge-bundles): treat a content 404 on a visible bundle as a permission stop

UiPath/cli#6015 moves `uip or kb` content commands onto Orchestrator's
generic /api/bundles routes, which hide a bundle kind the caller cannot
access. A caller with the bundle record but no knowledge-bundle content
permission, or a tenant with skill bundles but not knowledge bundles, now
gets 404 `BundleDto does not exist.` where it used to get a 403. Tell the
agent to confirm with `kb get`, then stop and report, instead of
concluding the bundle is gone and re-creating it. Add a smoke task that
grades that path.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-knowledge-bundles): name the get check by verb, not a second full command

The Studio Web ratchet caps Node-only command mentions per skill, and the
Commands table already spells out `uip or kb get`. Refer to it by verb,
as the rest of the skill does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-knowledge-bundles): branch the 404 check on get's envelope

A failed `get` does not prove the bundle is absent: authorization,
feature, network and server failures pass through it, and a tenant with
knowledge bundles off fails `get` too. Branch on its envelope: success
means missing content permission, `not_found` means ask which folder,
anything else is reported as it came. Soften Rule 5 to "does not prove
the bundle is missing".

The smoke task moves to its own leaf directory. Help calls get their own
response and are excluded from every count; the positive criteria are
pinned to the prompt's key, folder and destination; failure mocks exit 1
like the CLI. Checked against coder-eval's argv matcher.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-knowledge-bundles): narrow the login guard, cap sibling content retries

The login guard counted read-only `login status` / `login which`; read
the call log and fail only a re-login (bare `login`, `login --flags`,
`login refresh`). Add a guard so an agent cannot loop over `file`,
`versions` and `archive` after the 404.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-knowledge-bundles): strip global flags before judging a login, guard every download

The call log keeps raw argv, but the CLI strips its global options before
parsing, so `uip --output json login refresh` passed the re-login guard
and `uip login --output json status` failed it. Move the check into
check_no_relogin.py, which strips the global options from
`stripGlobalOptions` first.

The pinned download criterion missed a retry to another destination.
Add a max-one guard over every non-help `kb download`, and accept the
`-d` spelling of `--destination`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-knowledge-bundles): skip login option values before naming the subcommand

The re-login check matched a subcommand name anywhere in argv, so an
option value read as a subcommand: `login --tenant status` (a real
login) passed and `login --tenant refresh status` (read-only) failed.
Consume `uip login`'s own options and their values (long, short and
`=` forms, from cli commands/login.ts) and take the first positional,
as Commander does. Fail with exit 2 on a missing log, malformed JSON,
or a record without a list `argv`, instead of passing or throwing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(uipath-skill-bundles): add the skill-bundles skill (preview)

UiPath/cli#6015 adds `uip or skill-bundles` (alias `skill-bundle`), a
separate command group for skill bundles: folder-scoped, versioned file
trees of agent skills that publish later versions directly and carry
version tags, unlike knowledge bundles, whose later versions come only
from reviewed change proposals. The two lifecycles contradict each other
on the rule that matters most, so they get separate skills with
redirects both ways.

The skill covers preflight, addressing by name or GUID, the folder rule,
download/read by number, tag, digest or latest, publishing a full
workspace (a missing base file is a deletion), WorkspaceUpdated after a
publish, conflicts, immutable tags, and the content-404 branch on
`get`. It documents no `share` and no `build`, which the CLI does not
offer. Two smoke tasks grade the immutable-tag stop and publishing the
whole workspace rather than a partial directory.

Registers the skill in skill-status.json (preview), skills.sh.json,
CODEOWNERS and the README table, records its Node-only Studio Web
mentions as ratchet ceilings, and adds a skill-bundles redirect to the
knowledge-bundles description.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-skill-bundles): name fixture files instructions.md, not SKILL.md

A SKILL.md anywhere in the repo can be picked up as a skill by repo-wide
linting; the fixture only needs file content, not skill discovery.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-planner): list uipath-skill-bundles as an operate-only skill

The genome checker's skill lists must cover every shipped skill. Skill
bundles operate a platform resource and build no artifact, so the skill
joins OPERATE_SKILLS next to uipath-knowledge-bundles.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-skill-bundles): follow the final tags grammar and publish base rules

cli#6015 settled `tags set <tag> --bundle <bundle>` and `tags delete
<tag> --bundle <bundle>`: the tag is positional, the bundle an option,
as KB proposals nest under --bundle-key. `--base-version` now has to
match a workspace's marker, `create --input` refuses a directory that
is already a workspace, a plain directory never gets a marker, and
publish reports DeletedPaths. Update the commands, the publishing
rules, the failure table and both task mocks; the immutable-tag task's
other-name guard reads the positional tag from the call log.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-skill-bundles): add skill-activation eval coverage

skill-lint EVAL-DATASET-SYNC requires every skill in the activation
suite. Add 22 intent-based positives (publish, download, read, tags,
status/sync, conflicts) and three adversarial negatives near the domain
(authoring a SKILL.md, a JS bundle release, installing a skills plugin),
plus the skill_triggered criterion with stop_early.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(uipath-skill-bundles): state the content and record permissions

Every remote content command, the first publish included, needs
SkillBundleContent.View for the kind check; a write also needs the
matching Create, Edit or Delete content grant. A name is resolved
through the record, which needs SkillBundles.View; a key skips it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-skill-bundles): address review: hidden files, alias, bundle binding, e2e

Skill: hidden base files are kept by default and need --include-hidden
on both status and publish; list's HasMore is exact (lookahead) and the
windowed lists report Total; only this group guards the bundle kind;
whole uppercase placeholders.

Smoke tasks: mocks and guards accept the `skill-bundle` alias; graders
parse argv the way Commander does (attached -iDIR, --opt=value, last
value wins) after stripping global options, bind publish and tags to
finance-skills or its key, require status on the published directory
and tags list before tags set, in log order. Every value option is
declared, since the matcher otherwise splits -ichanges into -h. The
task tells the agent to run uip from the task root, because the log
records no working directory. Help mocks list no `build`.

E2E: add a live publish/tag/read lifecycle task on a unique scratch
bundle, graded on what the server holds afterwards, with a preflight
that aborts as ERROR without the CLI build or the feature, and
best-effort cleanup. skip: true until the eval tenant has
Features.SkillBundles on; it has not been run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-skill-bundles): grade final flag values and seed bytes

record_cli rules and cli_called match ANY recorded value of a flag,
while Commander keeps the last one. Drop the canned refusals keyed on a
partial --input and the folder predicate on the publish count; the
Python grader now also requires the final --folder-path to be Shared,
so a repeated --folder-path ending elsewhere fails. The versions mocks
answer each window of their two rows consistently.

E2E: `intact` compares v1 and the newest untouched files byte for byte
with the protected reference seed, and the newest invoice file must be
the seed plus the rule. Every mode, cleanup included, acts only on a
name of the generated sb-e2e-<12 hex> shape. Still skip: true; not run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(uipath-planner): expect the planner's current verbs in the activation smoke

skill-planner-smoke-skill-activation asks the agent to write the verbs
the skill defines and grades them against skills/uipath-planner/SKILL.md
§ Verbs. 9e33121 (#4330, PILOT-9071) wrote that assertion with `build`,
but the planner's verbs at that commit were design, decompose, author,
extract and edit: `build` belongs to uipath-genome (its SKILL.md § Verbs).
a4ccda0 (#4379) then added `check`. So an agent that copies the table
correctly scored 4/5 = 0.85 and failed every run, on main too (#4638,
run 43209115399).

Align only the includes list to the current table: design, decompose,
author, extract, edit, check. Weight, pass_threshold, tags, prompt and
the planner skill are unchanged. Checked with coder-eval's own
file_contains code: the current verbs pass at 1.00; the old list with
build (0.67), either missing verb (0.83) and build alone (0.00) fail.
The CI agent's real paths.txt from run 43238788631 scores 6/6.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(bundles): recover a create --input whose publish was not confirmed

UiPath/cli#6015 (c925ae86d) makes `kb create --input` and
`skill-bundles create --input` report a failure after the record was
created as "Bundle '<key>' was created, but its initial publication was
not confirmed." with Data { Key, Name, RecordCreated: true,
PublicationConfirmed: false }. PublicationConfirmed: false means the CLI
got no confirmed commit, not that the bundle is empty.

Both skills now say: run `versions` on Data.Key in the same folder and
tenant first; v1 listed means done, none means `publish` that key;
never repeat `create`, never delete the record. In the KB skill a 409
from `create` is a taken name, and a 409 from `publish` while finishing
such a create means v1 landed, not that a change proposal is needed.
KB also notes that a bad --input is refused before any record exists.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(bundles): key partial-create recovery on RecordCreated and "no content yet"

Review of 9e79ba5 against cli#6015 c925ae86d: the partial-create
failure keeps the underlying HTTP status, so `create --input` can answer
409 with Data.RecordCreated: true; the "409 on create, pick another
name" advice now applies only without that marker, and RecordCreated
takes precedence whatever the status. An unpublished bundle's
`versions` answers 404 "Bundle '<key>' has no content yet."
(BundleStore.cs), not an empty list: the resume `publish` now follows
only that answer (or a successful empty list); any other `versions`
failure stops under Step 0 rather than being read as "empty".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(bundles): recover a partial create whose record key is unknown

cli#6015 8b41163b0 makes Data.Key optional on the partial-create failure:
when the server returned no key after the record POST, the message names
the bundle by name and Data carries only Name, RecordCreated: true and
PublicationConfirmed: false, and the Instructions say to list by name
first. The recovery Instructions now also print the real folder, tenant,
input and message, shell-quoted.

Both skills: without Data.Key, first `list` the same folder with
--search set to Data.Name and take the exact match's key, then the
versions check on that key; and point at the printed commands.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(uipath-skill-bundles): ask before a plain-directory publish deletes files

cli#6015 61d98dc6a: `skill-bundles publish` from a directory without a
marker, with --base-version above 0, that would delete base paths now
stops before any upload or commit: ErrorCode confirmation_required,
RetryWillNotFix, exit 1, Data { Key, BaseVersion, DeletedPaths }, and
proceeds only with -y/--yes. Workspace publishes are unchanged.

The skill shows the user every DeletedPaths entry and asks before
re-running with --yes, never adds --yes on its own, and prefers a
downloaded workspace for edits. Adds [--yes] to the publish row and a
failure-table row.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(bundles): name the wrong-kind key refusal and a failed download's state

cli#6015 a1db4cbef (head 1cb482ffe): every KB content command now checks
the bundle kind first and refuses a skill-bundle key with
invalid_argument "This key is not a knowledge bundle. ..." before any
content call; the KB skill names it and routes to uipath-skill-bundles.
`skill-bundles download` now stages its extraction, so a failure leaves
the destination as it was with no marker, and a destination filled
meanwhile is refused ("The destination is no longer empty. Download into
a new path."); the skill-bundles Reading section says so.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(bundles): keep the 404 branches attached; scope download retries

Review of 662d472: in the KB skill the wrong-kind bullet sat between
the content-404 bullet and its nested Success / not_found / other
branches, detaching them; it now follows them. In the skill-bundles
skill, "run it again" covered refusals, the content 404 and a wrong-kind
key, which fail before anything is written; the retry now applies only
to a download that failed while writing, once its cause is fixed, and
those failures keep the Step 0 handling.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(bundles): share the skill-bundle call-log parser; trim repeated guidance

- Move the argv layer the two skill-bundle graders copied (global-option
  stripping, Commander-style option parsing, call-log reading, mode dispatch)
  into tests/tasks/uipath-skill-bundles/_shared/sb_calls.py; both tasks now
  stage the group folder as their reference (directory: ..), like the
  uipath-maestro-bpmn and uipath-insights tasks.
- Drop the unused `tags delete` option table from check_immutable_tag.py.
- check_no_relogin.py: login_subcommand returns the token or None instead of
  a redundant (found, token) pair.
- live.py: derive UNTOUCHED from SEED_FILES, drop unused exit codes, one
  preview helper for failure messages.
- uipath-skill-bundles: the failure-table row for an unconfirmed create points
  to the Publishing recovery instead of restating it.
- uipath-knowledge-bundles: drop the third "worth recognizing" bullet, which
  repeated Rule 5 and Step 0.

No grading change: the old and new graders give identical exit codes and
output on 182 synthetic call logs (all modes, malformed and missing logs,
global and short options, aliases, help renders).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(uipath-skill-bundles): download only into a path that does not exist

cli#6015 c73d26f88: `skill-bundles download` now refuses any existing
--destination, even an empty directory, before contacting Orchestrator
(invalid_argument, "The destination already exists.", "Pass
--destination with a new path that does not exist. Do not create it
first."), and never removes an existing path. The skill says to pass a
path that does not exist and not create it first, retries a failed write
into a new path, drops the "no longer empty" message the CLI removed,
and adds the refusal to the failure table. kb download is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(uipath-bundles): merge the knowledge- and skill-bundle skills into one

Replace uipath-knowledge-bundles and uipath-skill-bundles with one preview
skill, uipath-bundles, covering every kind of Orchestrator bundle: knowledge
bundles through `uip or kb` and skill bundles through `uip or skill-bundles`,
with room for later kinds.

A mixed-up agent cannot do harm: the server refuses a direct later-version
publish on a knowledge bundle (api/bundles grants BundleAccess.Publish to no
knowledge-bundle caller and answers 400), and cli#6015's kind guard makes each
command group refuse the other kind's key before reading content.

The skill identifies the kind first (from what the user or task names, or
from whose `get`/`list` returns the record; `get` has no Kind field), then
shares one Step 0 (both groups preview-only, per-kind feature refusal), one set
of folder/key/paging rules, workspace and marker rules, version 1 and the
create --input recovery, and one failure table. What differs is kept per
kind: the destination rule and failed-download handling, workspace
inference, later versions (change proposals vs. publish with --yes only after
the user approves DeletedPaths), tags, share and build. Every quoted message,
ErrorCode and field from the two skills is kept.

Registries move with it: skill-status.json (preview), skills.sh.json,
CODEOWNERS, the README table, the Studio Web ratchet, and the planner's
OPERATE_SKILLS. Tests move under tests/tasks/uipath-bundles/ with their leaf
directories, so the `..` reference and _shared/sb_calls.py keep resolving;
task ids become skill-bundles-kb-* / skill-bundles-sb-*. The activation set
becomes uipath-bundles.jsonl, with knowledge-bundle positives added.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(uipath-bundles): keep workspace and marker recovery per kind

Review of 1ab078c against cli#6015 c73d26f88:
- "Drop the key" on a workspace mismatch is knowledge-bundle inference
  only; skill bundles keep the named bundle and folder and download it
  into its own new directory.
- local_permission_denied with Context.path is the knowledge-bundle
  marker refusal; skill bundles answer "The workspace marker is invalid
  or unreadable. Download a fresh workspace before publishing."
  (publish), "No valid workspace marker. Run 'uip or skill-bundles
  download' first." (status) and "Pass a workspace downloaded from this
  skill bundle." (sync).
- The kb download server_error advice applies to its two archive
  messages (mismatched bundle/version, unreadable shipped marker); any
  other server_error is reported as it came.
- Rule 9 again says an immutable tag can never be moved or deleted, by
  anyone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants