Repository navigation
refactor(uipath-rpa): mode-partition SKILL.md + coded service quick card (T3) - #1458
RaduAna-Maria wants to merge 1 commit into
Conversation
…k card SKILL.md 7,603 → 4,970 words; Task Navigation router moved from 57% to ~30% into the file. XAML Rules 16-24 + XAML quick reference → references/xaml/critical-rules-xaml.md (read-in-full gate kept in SKILL.md); coded reference tables → references/coded/critical-rules-coded.md; long rule bodies deduplicated against the references that already owned them verbatim (validation-guide, trigger-pattern-guide, debugging, tenant-library-search-guide, environment-setup, uia-prerequisites — the last also resolving a real disagreement on the no-CLI fallback ladder). All 14 inbound rule citations updated to name the new files. New references/coded/service-quick-card.md (~750 words): most-used system/excel/testing signatures, 100% provenance-traced to the bundled activity-docs; wired as step 0 of the coded API resolution order. Replaces ~11.8k words of generated API-dump reading for common scenarios. Merge gate — the audit's original simulation scenario re-run against this restructure: 32,900 → 18,289 words read (−44%), usefulness 32% → 49%, verdict complete (init flags, .cs structure, Excel + queue signatures, validation loop all reached). Gate-flagged friction fixed in this commit: packages-install dedup (validation-guide → cli-reference pointer), verbatim A/B/C escalation template dedup (validation-guide owns it), stray @-include in coding-guidelines, Build/run/validate nav-row order, project-structure.md vs project-structure-guide.md mutual disambiguation, queue-semantics note on the quick card (doc-sourced), Excel COM-vs-Portable clarification in Rule 2a. codedworkflow-reference.md reduced to its unique content (IS connections, hooks, job context); built-in methods table folded into critical-rules-coded.md; dead infra-packages pointer fixed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
Claude finished @RaduAna-Maria's task in 3m 6s —— View job PR Review: refactor(uipath-rpa): mode-partition SKILL.md + coded service quick card (T3)
SummaryMode-partitions the uipath-rpa SKILL.md so coded consumers stop paying for XAML rules and vice versa. XAML Critical Rules 16–24 + quick reference moved to Change-by-Change Review1.
|
| Area | Status | Notes |
|---|---|---|
| Frontmatter | OK | Untouched (426 chars) |
| E2E Tests | OK | Not applicable — no new skill, and these are doc restructuring changes that don't alter CLI workflows |
| Skill Body | OK | Clean mode-partition; Critical Rules → Task Navigation now front-loaded; all extraction is lossless |
| References & Assets | OK | 3 new files well-structured; 89+ relative links all resolve; no orphaned files; UIA boundary clean |
| Repo Hygiene | OK | No secrets, no cross-skill refs, no new skill path (CODEOWNERS N/A) |
Issues for Manual Review
- Service-quick-card signature accuracy: The PR description states signatures were "copied from bundled activity-docs with per-row provenance." I verified the card's structure and link discipline, but cannot independently verify that each C# signature matches the actual UiPath SDK API surface. The provenance claim is credible given the methodology described.
- Token-reduction metrics: The PR claims −44% words read for the simulation scenario. The structural changes support this (coded consumers skip XAML rules; XAML consumers skip coded tables), but the exact numbers are from an external simulation I cannot reproduce.
Conclusion
Clean, well-scoped refactoring that achieves its stated goal: mode-partition uipath-rpa's SKILL.md so agents only pay for the rules they need. The extraction is lossless — every rule, table, and procedure lands in exactly one authoritative home. Reference pointer discipline is good throughout: bridge sentences link to references without restating them. The service quick card is a high-value addition for coded workflow scenarios. No issues found that would block merge.
Summary
Tranche 3, stacked on #1457. The highest-token-ROI change in the series: uipath-rpa's SKILL.md is mode-partitioned so coded consumers stop paying for XAML/UIA rules and vice versa, plus a provenance-traced service quick card that replaces generated API-dump reads for common scenarios.
Merge gate (measured)
The audit's original simulation scenario ("create a coded workflow project that reads Excel rows into an Orchestrator queue, validate it") re-run against this branch, same protocol:
Gate-flagged required fixes (all addressed in this PR): packages-install documented 4× → canonical in cli-reference; verbatim A/B/C escalation template duplicated coding-guidelines↔validation-guide → single home; stray
@../validation-guide.mdinclude; Build/run/validate nav-chain order;project-structure.mdvsproject-structure-guide.mdcollision → mutual scope lines; quick-card queue semantics (doc-sourced only); Excel COM-vs-Portable framework trap in Rule 2a.Structure
references/xaml/critical-rules-xaml.md(numbers preserved; read-in-full gate stays in SKILL.md)references/coded/critical-rules-coded.mdCritical Rule Ncitations updated to name the new files (including 8 bundled activity docs)codedworkflow-reference.mdreduced to unique content; its dead "infrastructure packages" pointer fixedQuick card
references/coded/service-quick-card.md(~750 words): system (queues, assets, credentials), excel (Portable + Interop surfaces), testing (verifications, test data) — every signature copied from the bundled activity-docs with per-row provenance (in the PR-linked agent report), zero prior-knowledge content. UIA row is a pointer only, per the skill's CLAUDE.md boundary. Wired as step 0 of the coded API resolution order; escalation rule sends agents to the full coded-api.md only when a signature/overload/enum is missing.Validation
scripts/check-cross-skill-links.py— OKhooks/validate-skill-descriptions.sh— pass (426 chars, frontmatter untouched)🤖 Generated with Claude Code