@uipath/delegate-sdk 1.203.0 → 1.203.2
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/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +722 -0
- package/dist/skills/business-analysis/as-is-capture.md +440 -0
- package/dist/skills/business-analysis/assets/progress.yaml +19 -0
- package/dist/skills/business-analysis/assets/task-list.md +34 -0
- package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
- package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
- package/dist/skills/business-analysis/case-to-be-design.md +223 -0
- package/dist/skills/business-analysis/diagram-authoring.md +215 -0
- package/dist/skills/business-analysis/industry-gaps.md +134 -0
- package/dist/skills/business-analysis/interview-spine.md +297 -0
- package/dist/skills/business-analysis/locales/de.json +54 -0
- package/dist/skills/business-analysis/locales/en.json +54 -0
- package/dist/skills/business-analysis/locales/es-MX.json +54 -0
- package/dist/skills/business-analysis/locales/es.json +54 -0
- package/dist/skills/business-analysis/locales/fr.json +54 -0
- package/dist/skills/business-analysis/locales/ja.json +54 -0
- package/dist/skills/business-analysis/locales/ko.json +54 -0
- package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
- package/dist/skills/business-analysis/locales/pt.json +54 -0
- package/dist/skills/business-analysis/locales/ro.json +54 -0
- package/dist/skills/business-analysis/locales/tr.json +54 -0
- package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
- package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
- package/dist/skills/business-analysis/pdd-generation.md +204 -0
- package/dist/skills/business-analysis/pdd-template.md +562 -0
- package/dist/skills/business-analysis/progress-presentation.json +13 -0
- package/dist/skills/business-analysis/recording-first.md +19 -0
- package/dist/skills/business-analysis/recording-processing.md +152 -0
- package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
- package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
- package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
- package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
- package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
- package/dist/skills/business-analysis/research-offer.md +104 -0
- package/dist/skills/business-analysis/research-pass.md +149 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
- package/dist/skills/business-analysis/to-be-design.md +199 -0
- package/dist/skills/confluence/SKILL.md +386 -0
- package/dist/skills/doc-coauthoring/SKILL.md +295 -0
- package/dist/skills/excel-architect/SKILL.macos.md +161 -0
- package/dist/skills/excel-architect/SKILL.md +180 -0
- package/dist/skills/excel-architect/SKILL.windows.md +61 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
- package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
- package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
- package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
- package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
- package/dist/skills/excel-architect/building.md +279 -0
- package/dist/skills/excel-architect/create.md +64 -0
- package/dist/skills/excel-architect/data-and-formulas.md +186 -0
- package/dist/skills/excel-architect/generator.md +272 -0
- package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
- package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
- package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
- package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
- package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
- package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
- package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
- package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
- package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
- package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
- package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
- package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
- package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
- package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
- package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
- package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
- package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
- package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
- package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
- package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
- package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
- package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
- package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
- package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
- package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
- package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
- package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
- package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
- package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
- package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
- package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
- package/dist/skills/excel-architect/reference/api/basic.md +747 -0
- package/dist/skills/excel-architect/reference/guides.md +348 -0
- package/dist/skills/excel-architect/reference/repair.md +174 -0
- package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
- package/dist/skills/excel-architect/scripting.md +266 -0
- package/dist/skills/excel-architect/styling-and-features.md +433 -0
- package/dist/skills/excel-architect/windows/api/composites.md +337 -0
- package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
- package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
- package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
- package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
- package/dist/skills/github/SKILL.md +446 -0
- package/dist/skills/github/recipes/add-comment.md +85 -0
- package/dist/skills/github/recipes/check-pr-status.md +122 -0
- package/dist/skills/github/recipes/compare-branches.md +79 -0
- package/dist/skills/github/recipes/create-issue.md +103 -0
- package/dist/skills/github/recipes/create-pr.md +97 -0
- package/dist/skills/github/recipes/get-file-contents.md +76 -0
- package/dist/skills/github/recipes/get-last-commit.md +128 -0
- package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
- package/dist/skills/github/recipes/list-recent-commits.md +84 -0
- package/dist/skills/github/recipes/search-issues.md +115 -0
- package/dist/skills/google-workspace/SKILL.md +217 -0
- package/dist/skills/google-workspace/services/calendar.md +311 -0
- package/dist/skills/google-workspace/services/docs.md +426 -0
- package/dist/skills/google-workspace/services/drive.md +504 -0
- package/dist/skills/google-workspace/services/gmail.md +466 -0
- package/dist/skills/google-workspace/services/sheets.md +370 -0
- package/dist/skills/internal-comms/SKILL.md +35 -0
- package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
- package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
- package/dist/skills/internal-comms/examples/general-comms.md +15 -0
- package/dist/skills/jira/SKILL.md +397 -0
- package/dist/skills/jira/recipes/add-comment.md +123 -0
- package/dist/skills/jira/recipes/assign-issue.md +157 -0
- package/dist/skills/jira/recipes/create-issue.md +274 -0
- package/dist/skills/jira/recipes/get-issue-details.md +154 -0
- package/dist/skills/jira/recipes/list-projects.md +151 -0
- package/dist/skills/jira/recipes/my-issues.md +180 -0
- package/dist/skills/jira/recipes/search-issues.md +215 -0
- package/dist/skills/jira/recipes/transition-issue.md +154 -0
- package/dist/skills/jira/recipes/troubleshooting.md +387 -0
- package/dist/skills/knowledge-base/SKILL.md +289 -0
- package/dist/skills/media-tools/SKILL.md +204 -0
- package/dist/skills/media-tools/references/encode-runbook.md +24 -0
- package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
# Recipe: Troubleshooting Common Issues
|
|
2
|
+
|
|
3
|
+
## When to Use
|
|
4
|
+
Use this guide when Jira API calls fail or behave unexpectedly.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Diagnostic Workflow
|
|
9
|
+
|
|
10
|
+
### Step 1: Check Connection Health
|
|
11
|
+
|
|
12
|
+
**Symptom:** Any API call fails with 401 or connection errors
|
|
13
|
+
|
|
14
|
+
```json
|
|
15
|
+
{
|
|
16
|
+
"method": "GET",
|
|
17
|
+
"url": "/api/v1/Connections/{connection_id}/ping",
|
|
18
|
+
}
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**Expected Response:**
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"isHealthy": true,
|
|
25
|
+
"message": "Connection is healthy"
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**Troubleshooting:**
|
|
30
|
+
- `isHealthy: false` → Connection expired, user needs to re-authorize in UiPath Cloud
|
|
31
|
+
- `404 Not Found` → Connection ID is invalid or deleted
|
|
32
|
+
- `403 Forbidden` → User lacks permission to check connection
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
### Step 2: Verify User Permissions
|
|
37
|
+
|
|
38
|
+
**Symptom:** 403 Forbidden on specific operations
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"method": "GET",
|
|
43
|
+
"url": "/myself",
|
|
44
|
+
"path": "/myself"
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
This returns the current user's info. Then check their project permissions:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"method": "GET",
|
|
53
|
+
"url": "/user/permission/search",
|
|
54
|
+
"query": {
|
|
55
|
+
"permissions": "CREATE_ISSUES,EDIT_ISSUES,DELETE_ISSUES",
|
|
56
|
+
"projectKey": "PROJ"
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**Permissions Required:**
|
|
62
|
+
- View issues: `BROWSE_PROJECTS`
|
|
63
|
+
- Create issues: `CREATE_ISSUES`
|
|
64
|
+
- Edit issues: `EDIT_ISSUES`
|
|
65
|
+
- Delete issues: `DELETE_ISSUES`
|
|
66
|
+
- Add comments: `ADD_COMMENTS`
|
|
67
|
+
- Transition issues: `TRANSITION_ISSUES`
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
### Step 3: Validate Project Access
|
|
72
|
+
|
|
73
|
+
**Symptom:** 404 on project operations or issues
|
|
74
|
+
|
|
75
|
+
```json
|
|
76
|
+
{
|
|
77
|
+
"method": "GET",
|
|
78
|
+
"url": "/project",
|
|
79
|
+
"path": "/project"
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
This lists all projects the user can access. If the target project is missing:
|
|
84
|
+
- Project doesn't exist
|
|
85
|
+
- User has no access
|
|
86
|
+
- Project key is incorrect (case-sensitive)
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
### Step 4: Test with Simple Request
|
|
91
|
+
|
|
92
|
+
**Symptom:** Complex request fails, need to isolate the problem
|
|
93
|
+
|
|
94
|
+
Start with the simplest possible request:
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"method": "GET",
|
|
99
|
+
"url": "/serverInfo",
|
|
100
|
+
"path": "/serverInfo"
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
If this works, the connection and auth are fine. Problem is in request format.
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Common Error Patterns
|
|
109
|
+
|
|
110
|
+
### Pattern 0: 200 OK with 401 Error in Body (MOST COMMON)
|
|
111
|
+
|
|
112
|
+
**Symptom:** Request returns 200 OK status but response body contains 401 Unauthorized error
|
|
113
|
+
|
|
114
|
+
**Cause:** Wrong URL path in request body - usually includes `/rest/api/3` when using UiPath connector
|
|
115
|
+
|
|
116
|
+
**Solution:**
|
|
117
|
+
1. **Check URL in request body** - Should be `/project`, NOT `/rest/api/3/project`
|
|
118
|
+
2. **UiPath connector rule:** OMIT `/rest/api/3` prefix - Integration Service adds it automatically
|
|
119
|
+
3. **Direct API fallback rule:** USE `/rest/api/3` prefix
|
|
120
|
+
4. **Verify endpoint:** Ensure using `/search/jql` not `/search`
|
|
121
|
+
5. **Try again** with corrected URL
|
|
122
|
+
|
|
123
|
+
**Example of WRONG URL:**
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"url": "/rest/api/3/project" // ❌ WRONG for UiPath connector
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
**Example of CORRECT URL:**
|
|
131
|
+
```json
|
|
132
|
+
{
|
|
133
|
+
"url": "/project" // ✅ CORRECT for UiPath connector
|
|
134
|
+
}
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
### Pattern 1: "Field 'X' cannot be set" (400)
|
|
140
|
+
|
|
141
|
+
**Cause:** Trying to set a field that's not editable for this issue type or workflow state
|
|
142
|
+
|
|
143
|
+
**Solution:**
|
|
144
|
+
1. Fetch create metadata to see which fields are available:
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"method": "GET",
|
|
148
|
+
"url": "/issue/createmeta",
|
|
149
|
+
"query": {
|
|
150
|
+
"projectKeys": "PROJ",
|
|
151
|
+
"expand": "projects.issuetypes.fields"
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
2. Check `fields[fieldKey].operations` to see if field is settable
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
### Pattern 2: "Issue does not exist" (404)
|
|
161
|
+
|
|
162
|
+
**Cause:** Issue key is wrong or deleted
|
|
163
|
+
|
|
164
|
+
**Solution:**
|
|
165
|
+
1. Verify issue key format: `PROJ-123` (project key must match exactly)
|
|
166
|
+
2. Check if issue was deleted (search recently deleted):
|
|
167
|
+
```json
|
|
168
|
+
{
|
|
169
|
+
"method": "GET",
|
|
170
|
+
"url": "/search/jql",
|
|
171
|
+
"query": {
|
|
172
|
+
"jql": "key = 'PROJ-123'"
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
### Pattern 3: "JQL Query Error" (400)
|
|
180
|
+
|
|
181
|
+
**Cause:** Invalid JQL syntax
|
|
182
|
+
|
|
183
|
+
**Common JQL Mistakes:**
|
|
184
|
+
| Mistake | Correct |
|
|
185
|
+
|---------|---------|
|
|
186
|
+
| `status = In Progress` | `status = 'In Progress'` (quote values with spaces) |
|
|
187
|
+
| `assignee = john@example.com` | `assignee = currentUser()` or get accountId first |
|
|
188
|
+
| `created = 2024-01-01` | `created >= 2024-01-01` (use operators) |
|
|
189
|
+
| `priority = 1` | `priority = High` (use name, not ID) |
|
|
190
|
+
|
|
191
|
+
**Solution:**
|
|
192
|
+
1. Use JQL validator:
|
|
193
|
+
```json
|
|
194
|
+
{
|
|
195
|
+
"method": "POST",
|
|
196
|
+
"url": "/jql/parse",
|
|
197
|
+
"body": "{\"queries\": [\"project = PROJ AND status = 'In Progress'\"]}"
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
2. **📖 Refer to official JQL reference:** [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search) for complete syntax guide
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
### Pattern 4: "Transition not valid" (400)
|
|
206
|
+
|
|
207
|
+
**Cause:** Trying to transition to a state that's not allowed from current state
|
|
208
|
+
|
|
209
|
+
**Solution:**
|
|
210
|
+
1. Get available transitions for this issue:
|
|
211
|
+
```json
|
|
212
|
+
{
|
|
213
|
+
"method": "GET",
|
|
214
|
+
"url": "/issue/{issueKey}/transitions",
|
|
215
|
+
"path": "/issue/{issueKey}/transitions"
|
|
216
|
+
}
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
2. Only use transition IDs returned by this endpoint
|
|
220
|
+
3. Workflow may have conditions (assignee, resolution, etc.)
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
### Pattern 5: Rate Limit (429)
|
|
225
|
+
|
|
226
|
+
**Symptom:**
|
|
227
|
+
```json
|
|
228
|
+
{
|
|
229
|
+
"statusCode": 429,
|
|
230
|
+
"message": "Rate limit exceeded"
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
**Solution:**
|
|
235
|
+
1. Check `Retry-After` header (seconds to wait)
|
|
236
|
+
2. Implement exponential backoff
|
|
237
|
+
3. Reduce request frequency
|
|
238
|
+
4. Use field filtering to reduce response size
|
|
239
|
+
|
|
240
|
+
**Rate Limit Headers:**
|
|
241
|
+
- `X-RateLimit-Limit`: Total allowed per time window
|
|
242
|
+
- `X-RateLimit-Remaining`: Requests remaining
|
|
243
|
+
- `X-RateLimit-Reset`: Unix timestamp when limit resets
|
|
244
|
+
- `Retry-After`: Seconds to wait before retrying
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
### Pattern 6: "ADF validation error" or "Operation value must be a string" (400) ⚠️ VERY COMMON
|
|
249
|
+
|
|
250
|
+
**Symptom:**
|
|
251
|
+
```json
|
|
252
|
+
{
|
|
253
|
+
"errors": { "description": "Operation value must be a string" }
|
|
254
|
+
}
|
|
255
|
+
```
|
|
256
|
+
or
|
|
257
|
+
```json
|
|
258
|
+
{
|
|
259
|
+
"errors": { "body": "Operation value must be a string" }
|
|
260
|
+
}
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
**Cause:** The UiPath IS connector uses **Jira API v2**, where `description` and comment `body` are **plain strings** — NOT Atlassian Document Format (ADF) objects. Passing an ADF object causes this error.
|
|
264
|
+
|
|
265
|
+
**❌ WRONG — ADF object:**
|
|
266
|
+
```json
|
|
267
|
+
{
|
|
268
|
+
"body": "{\"fields\": {\"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}}"
|
|
269
|
+
}
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
**✅ CORRECT — Plain string with `\n` for newlines:**
|
|
273
|
+
```json
|
|
274
|
+
{
|
|
275
|
+
"body": "{\"fields\": {\"description\": \"First paragraph.\\n\\n- Bullet one\\n- Bullet two\"}}"
|
|
276
|
+
}
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
**Plain text formatting (API v2 wiki markup):**
|
|
280
|
+
- Paragraph break: `\n\n`
|
|
281
|
+
- Bullet item: `- item`
|
|
282
|
+
- Bold: `*text*`
|
|
283
|
+
- Code: `{{text}}`
|
|
284
|
+
- Heading: `h1. Title`
|
|
285
|
+
|
|
286
|
+
**Note:** ADF is only supported when calling the **direct Jira REST API v3** — not via the UiPath IS connector.
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
## Debugging Checklist
|
|
291
|
+
|
|
292
|
+
When a Jira operation fails, check these in order:
|
|
293
|
+
|
|
294
|
+
- [ ] **⚠️ URL path** - OMIT `/rest/api/3` when using UiPath connector (most common issue!)
|
|
295
|
+
- [ ] **200 OK with 401 error** - Check if response body has error despite 200 status
|
|
296
|
+
- [ ] **Connection health** - Ping endpoint returns healthy
|
|
297
|
+
- [ ] **Connection state** - State is "Enabled", not "Expired" or "Disabled"
|
|
298
|
+
- [ ] **User permissions** - User has required permission for operation
|
|
299
|
+
- [ ] **Project access** - User can see the project in project list
|
|
300
|
+
- [ ] **Project key case** - Project key is uppercase and exact match
|
|
301
|
+
- [ ] **Issue key format** - Format is `PROJECTKEY-123`
|
|
302
|
+
- [ ] **JQL syntax** - Values with spaces are quoted
|
|
303
|
+
- [ ] **Query params are strings** - `{"maxResults": "50"}` not `{"maxResults": 50}`
|
|
304
|
+
- [ ] **Body is escaped JSON** - For POST/PUT, body is a JSON string
|
|
305
|
+
- [ ] **Description/comment are plain strings** - Use `"description": "text with \\n"` NOT ADF objects — see Pattern 6
|
|
306
|
+
- [ ] **Required fields** - All required fields for issue type are present
|
|
307
|
+
- [ ] **Required fields** - All required fields for issue type are present
|
|
308
|
+
- [ ] **Field types** - Field values match expected types (string, number, object)
|
|
309
|
+
- [ ] **Workflow transitions** - Transition ID is valid for current state
|
|
310
|
+
|
|
311
|
+
---
|
|
312
|
+
|
|
313
|
+
## Performance Debugging
|
|
314
|
+
|
|
315
|
+
### Slow Response Times
|
|
316
|
+
|
|
317
|
+
**Symptoms:** Requests take >5 seconds
|
|
318
|
+
|
|
319
|
+
**Diagnostics:**
|
|
320
|
+
1. Check if fetching too many results: Use `maxResults` to limit
|
|
321
|
+
2. Check if requesting all fields: Use `fields` parameter to filter
|
|
322
|
+
3. Check if JQL is inefficient: Add indexed field filters (project, status, assignee)
|
|
323
|
+
|
|
324
|
+
**Optimizations:**
|
|
325
|
+
|
|
326
|
+
**Slow approach:**
|
|
327
|
+
- Fetching all fields for 1000 issues
|
|
328
|
+
- Using only full-text search without indexed filters
|
|
329
|
+
|
|
330
|
+
**Fast approach:**
|
|
331
|
+
- Limit to 50 issues with `maxResults: "50"`
|
|
332
|
+
- Use indexed field filters (`project`, `status`) before full-text search
|
|
333
|
+
- Request only specific fields: `fields: "key,summary,status"`
|
|
334
|
+
|
|
335
|
+
---
|
|
336
|
+
|
|
337
|
+
## Response Validation Helpers
|
|
338
|
+
|
|
339
|
+
### Check Response Structure
|
|
340
|
+
|
|
341
|
+
**Validation checklist:**
|
|
342
|
+
1. **Status code:** Must be 200-299, else error with `response.statusCode` and `response.body.message`
|
|
343
|
+
2. **Error messages:** Check `response.body.errorMessages` array, join with commas if present
|
|
344
|
+
3. **Field errors:** Check `response.body.errors` object, format as `field: error` for each entry
|
|
345
|
+
4. **Warnings (non-fatal):** Check `response.body.warningMessages` array, log warnings but don't fail
|
|
346
|
+
5. **Return null if valid**
|
|
347
|
+
|
|
348
|
+
---
|
|
349
|
+
|
|
350
|
+
## Emergency Recovery
|
|
351
|
+
|
|
352
|
+
### Connection Lost During Operation
|
|
353
|
+
|
|
354
|
+
If connection fails mid-operation:
|
|
355
|
+
|
|
356
|
+
1. **Check if operation completed:**
|
|
357
|
+
- For create: Search for recently created issues
|
|
358
|
+
- For update: Fetch issue and check if changes applied
|
|
359
|
+
- For delete: Try to fetch the issue (404 means deleted)
|
|
360
|
+
|
|
361
|
+
2. **Don't retry blindly:**
|
|
362
|
+
- Creates might duplicate issues
|
|
363
|
+
- Updates might apply twice
|
|
364
|
+
- Always verify state before retrying
|
|
365
|
+
|
|
366
|
+
3. **Idempotent operations are safe:**
|
|
367
|
+
- GET requests can always be retried
|
|
368
|
+
- PUT with same data can be retried
|
|
369
|
+
- POST (create) should NOT be retried without verification
|
|
370
|
+
|
|
371
|
+
---
|
|
372
|
+
|
|
373
|
+
## Key Learnings
|
|
374
|
+
|
|
375
|
+
1. **⚠️ MOST IMPORTANT: URL paths** - OMIT `/rest/api/3` when using UiPath connector, include it for direct API
|
|
376
|
+
2. **⚠️ DESCRIPTION/COMMENT ARE PLAIN STRINGS** - The IS connector uses Jira API v2. `description` and comment `body` are plain strings with `\n` for newlines — NOT ADF objects. Passing ADF objects causes `"Operation value must be a string"` (400).
|
|
377
|
+
3. **200 OK doesn't mean success** - Check response body for errors even with 200 status
|
|
378
|
+
3. **Always check connection health first** - Saves time debugging auth issues
|
|
379
|
+
4. **Validate permissions before operations** - Avoids confusing 403 errors
|
|
380
|
+
5. **Test with simple requests** - Isolates problems to request format vs. auth/connection
|
|
381
|
+
6. **Use metadata endpoints** - Discover what's possible before attempting operations
|
|
382
|
+
7. **Check response structure** - Jira returns detailed error info in `errorMessages` and `errors`
|
|
383
|
+
8. **Monitor rate limits** - Check headers to avoid hitting limits
|
|
384
|
+
9. **Don't retry creates blindly** - Verify operation completed before retrying
|
|
385
|
+
10. **Use JQL validator** - Catch syntax errors before executing search
|
|
386
|
+
11. **Keep project keys exact** - Case-sensitive and must match exactly
|
|
387
|
+
12. **ADF structure is strict** - Must have `type`, `version`, and `content` with proper nesting
|
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: knowledge-base
|
|
3
|
+
friendly_name: Knowledge Base
|
|
4
|
+
version: 2.2.0
|
|
5
|
+
description: "Build and maintain a persistent, OKF-compliant markdown knowledge base. Ingest sources, compile interlinked concept pages with YAML frontmatter, query accumulated knowledge, and lint for consistency. Trigger when the user mentions building a knowledge base, wiki, research compilation, or organizing information from multiple sources into a structured reference."
|
|
6
|
+
icon: book
|
|
7
|
+
color: 8B5CF6
|
|
8
|
+
tags: [research, knowledge-base, okf, wiki]
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Knowledge Base
|
|
12
|
+
|
|
13
|
+
Build and maintain a persistent, compounding knowledge base as interlinked markdown files in the **Open Knowledge Format (OKF)**.
|
|
14
|
+
|
|
15
|
+
The human curates sources and directs analysis. You summarize, cross-reference, file, and maintain consistency. The knowledge base is yours to write and maintain. The user reads it, queries it, and guides what goes in.
|
|
16
|
+
|
|
17
|
+
## Format: OKF
|
|
18
|
+
|
|
19
|
+
The knowledge base is an OKF bundle — a directory tree of markdown files, each with YAML frontmatter. Two rules make it conformant:
|
|
20
|
+
|
|
21
|
+
1. Every concept file has frontmatter with a non-empty `type`.
|
|
22
|
+
2. Relationships are **standard markdown links in the prose** — there is no separate graph file. The graph view is derived from these links, so link liberally.
|
|
23
|
+
|
|
24
|
+
`index.md`, `log.md`, and `stakeholders.md` are reserved filenames (see below); every other `.md` is a concept.
|
|
25
|
+
|
|
26
|
+
## Knowledge Base Location
|
|
27
|
+
|
|
28
|
+
**Path:** `{WikiPath}`
|
|
29
|
+
|
|
30
|
+
Use the path above for all operations. Do not compute or guess the path.
|
|
31
|
+
|
|
32
|
+
## First Read: Classify Wiki State
|
|
33
|
+
|
|
34
|
+
On the first knowledge-base operation in a session, read the contents of `{WikiPath}/index.md`. Classify from content, not from file or directory existence:
|
|
35
|
+
|
|
36
|
+
- Missing or blank `index.md` means the knowledge base is uninitialized.
|
|
37
|
+
- An `index.md` containing the host placeholder `Empty. No sources ingested yet.` is a scaffold, not an initialized knowledge base. Run Initialization, replace the placeholder index, and create `log.md` if it is missing.
|
|
38
|
+
- Any other `index.md` is initialized. Resume from it.
|
|
39
|
+
|
|
40
|
+
An initialized `index.md` may carry `language:` in its frontmatter — the language this knowledge base is written in. Read it and keep writing in it; never re-ask, and never switch language because a later turn arrives in a different one.
|
|
41
|
+
|
|
42
|
+
Do not treat `WikiPath`, a wiki directory, a non-empty file, or a host-provided `hasWiki` signal as proof of initialization. After initializing a missing, blank, or scaffolded wiki, re-read `index.md` and verify that the placeholder is gone and `log.md` exists before writing concept pages.
|
|
43
|
+
|
|
44
|
+
## Initialization
|
|
45
|
+
|
|
46
|
+
When starting a new knowledge base:
|
|
47
|
+
|
|
48
|
+
1. Determine the domain from the user request, project context, or calling skill. Ask the user only when it cannot be inferred (e.g. "AI research", "competitive analysis", "project documentation").
|
|
49
|
+
2. Confirm the knowledge base language, before creating any file. Skip when `UserUiLanguage` is English (`en`, `en-*`) **and** the user has been writing to you in English. Otherwise ask once through one `AskUser` — batched with the domain question when you need that too:
|
|
50
|
+
- `English (Recommended)` — keeps the knowledge base reusable across teams
|
|
51
|
+
- the `UserUiLanguage` language, native name
|
|
52
|
+
- `{"kind":"userinput"}` for any other language
|
|
53
|
+
|
|
54
|
+
Record the answer as `language: <BCP-47 code>` in `index.md` frontmatter and never ask again; later sessions and other skills read it from there. Page prose, titles and `description` follow it. Structure stays English regardless: frontmatter field names, `type` values, reserved filenames, folder and file slugs, link targets.
|
|
55
|
+
3. Create the directory with this structure:
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
{WikiPath}/
|
|
59
|
+
├── index.md # Reserved. Directory listing for progressive disclosure.
|
|
60
|
+
├── log.md # Reserved. Chronological update history.
|
|
61
|
+
├── raw/ # Immutable source material (the primary research corpus).
|
|
62
|
+
├── <category-a>/ # Top-level category folder. Folder name = graph color group.
|
|
63
|
+
│ ├── page.md # Concept pages directly under the category.
|
|
64
|
+
│ └── <kind>/ # Subfolders allowed at any depth; the L2 subfolder
|
|
65
|
+
│ └── ... # (`<kind>/`) sets the graph color for everything below it.
|
|
66
|
+
└── <category-b>/
|
|
67
|
+
└── ...
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
`raw/` is the only reserved folder. Every other top-level folder is a free-form category root: pick names that cluster this domain's entities (e.g. `anthropic/`, `methodologies/`, `treaties/`).
|
|
71
|
+
|
|
72
|
+
4. Create `index.md` (frontmatter carries only the optional OKF version marker and `language`):
|
|
73
|
+
|
|
74
|
+
```markdown
|
|
75
|
+
# Knowledge Base — {domain}
|
|
76
|
+
|
|
77
|
+
> Content catalog. Read this first to find relevant pages for any query.
|
|
78
|
+
|
|
79
|
+
# Pages
|
|
80
|
+
|
|
81
|
+
* [Page Title](/category/page.md) - one-line summary
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
5. Create `log.md`:
|
|
85
|
+
|
|
86
|
+
```markdown
|
|
87
|
+
# Update Log
|
|
88
|
+
|
|
89
|
+
## YYYY-MM-DD
|
|
90
|
+
* **Initialization**: Created knowledge base for {domain}.
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
6. Create `raw/` plus one or more top-level category folders that fit the domain. Add categories later by creating folders.
|
|
94
|
+
7. Confirm ready and explain the three operations: ingest, query, lint.
|
|
95
|
+
|
|
96
|
+
## Resuming an Existing Knowledge Base
|
|
97
|
+
|
|
98
|
+
Resume only when `index.md` is initialized according to First Read. Read it to orient, then proceed with the requested operation (ingest, query, lint). A host scaffold containing `Empty. No sources ingested yet.` must go through Initialization even though the file exists and is non-empty.
|
|
99
|
+
|
|
100
|
+
## Operations
|
|
101
|
+
|
|
102
|
+
### 1. Ingest
|
|
103
|
+
|
|
104
|
+
When the user provides sources (URLs, files, pasted text) or asks you to research a topic:
|
|
105
|
+
|
|
106
|
+
**Capture raw sources:**
|
|
107
|
+
- Copy external files into `raw/` first. The bundle must be self-contained.
|
|
108
|
+
- Save each source to `raw/` with a descriptive filename (e.g. `raw/karpathy-on-llms.md`) and minimal frontmatter so the source is itself a conformant concept:
|
|
109
|
+
|
|
110
|
+
```markdown
|
|
111
|
+
---
|
|
112
|
+
type: Source
|
|
113
|
+
resource: https://example.com/original-url
|
|
114
|
+
timestamp: 2026-06-16T00:00:00Z
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
(full extracted content)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
- For URLs: extract the content and save the markdown to `raw/`.
|
|
121
|
+
- If delegating research to an agent, instruct it to: cite full URLs, return complete extracted content (not summaries), use clear headings, separate distinct sources. Save each returned source to `raw/` as a separate file.
|
|
122
|
+
|
|
123
|
+
**Process one source at a time (do NOT read multiple sources in parallel):**
|
|
124
|
+
- Read ONE raw source, fully process it (fan out into multiple concept pages), then move to the next. Reading 2+ sources per turn overwhelms context and collapses into 1:1 source-to-page mapping.
|
|
125
|
+
- For each source:
|
|
126
|
+
1. Read the source (one file only).
|
|
127
|
+
2. Identify every distinct subject it covers.
|
|
128
|
+
3. For each subject: create or update a concept page under the best category folder (see placement rules).
|
|
129
|
+
4. Also update existing pages the source adds to — don't only create new pages.
|
|
130
|
+
5. Update `index.md` with new/changed pages.
|
|
131
|
+
6. Drop the source from working memory; move to the next.
|
|
132
|
+
- Between sources, re-read `index.md` to reorient. Don't rely on memory.
|
|
133
|
+
|
|
134
|
+
**Write concept pages:**
|
|
135
|
+
- **One source often spawns many pages.** Each distinct subject gets its own page. Fan out: a company report might spawn pages for the CEO, each product line, the market.
|
|
136
|
+
- Frontmatter on every page: `type` (required), `title`, `description` (one line — this is the page's summary in the index and UI), `tags`, `generated: { by, at }` (who wrote it, when — see Trust signals).
|
|
137
|
+
- Provenance lives in frontmatter `sources` (OKF v0.2 — supersedes the old `# Citations` body section). Every entry needs a **specific locator** in `title`, not just a filename:
|
|
138
|
+
```yaml
|
|
139
|
+
sources:
|
|
140
|
+
- resource: /raw/article.md
|
|
141
|
+
id: article-heading
|
|
142
|
+
title: Article — "Heading Title"
|
|
143
|
+
- resource: /raw/paper.md
|
|
144
|
+
title: Paper p.3, Table 1
|
|
145
|
+
```
|
|
146
|
+
A bare `resource` with no section/locator in `title` is not enough. Give an `id` when body claims need per-claim attribution.
|
|
147
|
+
- Cross-link related pages with standard markdown links, bundle-root-relative: `[Claude](/anthropic/claude.md)`. The graph is built from these links.
|
|
148
|
+
- Every page links to at least 2 others. No exceptions — if you can't find 2 connections, the page is too narrow; merge it.
|
|
149
|
+
- **To merge a narrow page:** move its content into the broader page, delete the narrow file, remove its `index.md` entry, and repoint any links that targeted it.
|
|
150
|
+
|
|
151
|
+
**Final pass (after all sources — do NOT skip):**
|
|
152
|
+
1. Re-read `index.md` for the full picture.
|
|
153
|
+
2. Fix early pages: pages from the first source often lack links to pages that didn't exist yet. Add them.
|
|
154
|
+
3. Scan for missing cross-references between pages that should link.
|
|
155
|
+
4. Check gaps: topics mentioned across multiple pages that deserve their own page.
|
|
156
|
+
5. Update stale `index.md` summaries.
|
|
157
|
+
6. Append one summary entry to `log.md` covering the full ingest.
|
|
158
|
+
|
|
159
|
+
**Report what changed:** list every file created or updated. One source touching many pages is normal and desired.
|
|
160
|
+
|
|
161
|
+
### 2. Query
|
|
162
|
+
|
|
163
|
+
When the user asks a question against the knowledge base:
|
|
164
|
+
|
|
165
|
+
1. Read `index.md` to find relevant pages.
|
|
166
|
+
2. Read only the 2-3 most relevant pages. Do not load the whole base.
|
|
167
|
+
3. Follow links for connected information.
|
|
168
|
+
4. Synthesize an answer, citing pages.
|
|
169
|
+
5. If the answer is substantial (a comparison, deep dive, novel connection), offer to file it as a new page so it compounds.
|
|
170
|
+
6. Append to `log.md`: `* **Query**: {question summary}` under today's date.
|
|
171
|
+
|
|
172
|
+
### 3. Lint
|
|
173
|
+
|
|
174
|
+
When the user asks to health-check, lint, or audit:
|
|
175
|
+
|
|
176
|
+
1. **Orphans**: pages no other page links to.
|
|
177
|
+
2. **Contradictions**: conflicting claims across pages on overlapping topics.
|
|
178
|
+
3. **Stale content**: pages not updated despite newer sources on the same topic.
|
|
179
|
+
4. **Gaps**: subjects linked to but with no page yet (broken links — OKF tolerates these as not-yet-written knowledge).
|
|
180
|
+
5. **Index completeness**: every page appears in `index.md`.
|
|
181
|
+
6. **Frontmatter**: every concept has a non-empty `type`, a one-line `description`, and `generated: { by, at }`.
|
|
182
|
+
7. **Source coverage**: raw sources not yet integrated into pages.
|
|
183
|
+
8. **Weak sources**: `sources` entries with a bare `resource` (no locator in `title`), or claims with no source at all.
|
|
184
|
+
9. **Staleness**: pages whose `stale_after` date has passed, or `status: deprecated` pages still heavily linked.
|
|
185
|
+
10. **Oversized pages**: pages over 1,000 words that should split.
|
|
186
|
+
11. Report findings with file paths and suggested actions.
|
|
187
|
+
12. Append to `log.md`: `* **Lint**: {N} issues found` under today's date.
|
|
188
|
+
|
|
189
|
+
## Concept Page Frontmatter (OKF v0.2)
|
|
190
|
+
|
|
191
|
+
```markdown
|
|
192
|
+
---
|
|
193
|
+
type: Concept # REQUIRED. Free-form (Concept, Person, Product, Metric, Playbook, ...).
|
|
194
|
+
title: Claude # Human-readable display name.
|
|
195
|
+
description: Anthropic's flagship assistant family. # One line — the page summary.
|
|
196
|
+
tags: [anthropic, llm]
|
|
197
|
+
generated: # Who produced this page, when (supersedes v0.1 `timestamp`).
|
|
198
|
+
by: knowledge-base/1.1
|
|
199
|
+
at: 2026-08-11T09:00:00Z
|
|
200
|
+
verified: # Optional confirmation events. Only human:<id> makes it human-reviewed.
|
|
201
|
+
- by: human:jane.doe
|
|
202
|
+
at: 2026-08-11
|
|
203
|
+
status: stable # Optional: draft | stable | deprecated.
|
|
204
|
+
stale_after: 2027-02-01 # Optional: date after which the page needs re-checking.
|
|
205
|
+
sources: # Provenance (supersedes the v0.1 `# Citations` body section).
|
|
206
|
+
- resource: /raw/claude-model-card.md
|
|
207
|
+
title: Model card — "Training"
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
# Claude
|
|
211
|
+
|
|
212
|
+
Anthropic's assistant family, trained with [RLHF](/methodologies/rlhf.md) and
|
|
213
|
+
positioned against [GPT-4](/openai/gpt-4.md).
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
## Trust Signals (OKF v0.2)
|
|
217
|
+
|
|
218
|
+
Trust tiers are DERIVED by consumers, never stored: no `verified` → *unverified*; verified only by non-human actors → *machine-confirmed*; any `human:<id>` verifier → *human-reviewed*. The Delegate UI shows these tiers in the file explorer and on case-diagram attachment chips.
|
|
219
|
+
|
|
220
|
+
Actor convention: `<producer>/<version>` for agents and tools (write `by: knowledge-base/<this skill's version>` for pages you author), `human:<id>` for people, `process:<id>` for automation.
|
|
221
|
+
|
|
222
|
+
- Write `generated: { by, at }` on every page you create or substantially rewrite.
|
|
223
|
+
- Never write `verified` entries with a `human:` actor yourself. Add a `human:<id>` verification only when the user explicitly confirms the page's content — record their id, not yours.
|
|
224
|
+
- You may add a machine verification (`by: knowledge-base/<version>`) after a lint pass confirms a page against its sources.
|
|
225
|
+
- Migration from v0.1: `timestamp` → `generated.at`; the `# Citations` body section → `sources` frontmatter. Migrate pages opportunistically when you touch them; do not mass-rewrite.
|
|
226
|
+
|
|
227
|
+
## index.md Format
|
|
228
|
+
|
|
229
|
+
Reserved file. Frontmatter carries only the optional `okf_version: "0.2"` marker and `language` (the BCP-47 code the knowledge base is written in, set at Initialization). One section per group; entries carry the linked page's `description`:
|
|
230
|
+
|
|
231
|
+
```markdown
|
|
232
|
+
# Pages
|
|
233
|
+
|
|
234
|
+
* [Claude](/anthropic/claude.md) - Anthropic's flagship assistant family.
|
|
235
|
+
* [RLHF](/methodologies/rlhf.md) - Reinforcement learning from human feedback.
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## log.md Format
|
|
239
|
+
|
|
240
|
+
Reserved file. Date-grouped, newest first; the leading bold word is a convention:
|
|
241
|
+
|
|
242
|
+
```markdown
|
|
243
|
+
# Update Log
|
|
244
|
+
|
|
245
|
+
## 2026-06-16
|
|
246
|
+
* **Ingest**: Added [Claude](/anthropic/claude.md) and [RLHF](/methodologies/rlhf.md) from the model card.
|
|
247
|
+
* **Creation**: Established the `anthropic/` category.
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
## stakeholders.md Format
|
|
251
|
+
|
|
252
|
+
Reserved file. People involved in the project and their roles. The UI renders this file directly as a rail widget — data lives in frontmatter, not prose:
|
|
253
|
+
|
|
254
|
+
```markdown
|
|
255
|
+
---
|
|
256
|
+
description: People involved in this project and their roles.
|
|
257
|
+
stakeholders:
|
|
258
|
+
- name: Alex Rivera
|
|
259
|
+
role: Process owner
|
|
260
|
+
group: internal # internal | external
|
|
261
|
+
email: alex.rivera@example.com # optional
|
|
262
|
+
---
|
|
263
|
+
|
|
264
|
+
Free-form notes about each stakeholder (agent-maintained).
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Add or update entries when the user names project people (BA interview, transcript, "the process owner is X"). Missing file: create it with this shape — don't ask the user for permission first.
|
|
268
|
+
|
|
269
|
+
## Page Guidelines
|
|
270
|
+
|
|
271
|
+
- **Place pages in a top-level category folder; pick a folder name that fits the entity.** `raw/` is reserved for sources. Every other top-level folder is a category root and colors its pages by the folder name in the graph.
|
|
272
|
+
- **Folder names are free-form.** Cluster pages by kind: `anthropic/claude.md`, `openai/gpt-4.md`, `methodologies/rlhf.md`.
|
|
273
|
+
- **Nest as deep as you want.** The **L2 subfolder** (first folder under the top-level category) sets the graph color, so siblings deep in a subtree share a bubble.
|
|
274
|
+
- **Be consistent.** Once a kind of entity lives in a folder, put future ones there. Don't split `people/` and `persons/`.
|
|
275
|
+
- **No loose pages at the root.** Files at the bundle root other than `index.md`, `log.md`, and `stakeholders.md` are ignored.
|
|
276
|
+
- **Filenames**: lowercase, hyphens, no spaces.
|
|
277
|
+
- **Structure**: `# Title` heading, then `##` sections. Provenance lives in frontmatter `sources`, not in the body.
|
|
278
|
+
- **Length**: 500-1,000 words. Split pages over 1,000 words.
|
|
279
|
+
- **Links**: bundle-root-relative `[text](/folder/page.md)`. More links = richer graph.
|
|
280
|
+
- **Portable**: standard markdown links open in any markdown tool or editor.
|
|
281
|
+
|
|
282
|
+
## Important Rules
|
|
283
|
+
|
|
284
|
+
- **Write to disk, not to memory.** The base on disk is your persistent memory; context is scratchpad.
|
|
285
|
+
- **Never modify files in `raw/`.** Sources are immutable. Corrections go in concept pages.
|
|
286
|
+
- **Always update `index.md` and `log.md`** when making changes.
|
|
287
|
+
- **Copy external sources into `raw/`.** The bundle must be self-contained.
|
|
288
|
+
- **Ask before mass updates.** If an ingest would touch 10+ existing pages, confirm first.
|
|
289
|
+
- **File valuable query answers back in.** Don't let good analysis disappear into chat history.
|