Repository navigation
docs: propose local skill source governance - #30574
hkrishg-aws wants to merge 1 commit into
Conversation
Define an allow-only policy ceiling for repository and config-selected skill sources. Add a pre-enforcement inventory phase and align the enterprise control table. Refs: kirodotdev#29686
|
Closing in favour of #34728, which carries the same design and merges cleanly. This branch cannot merge. It edits #34728 is the same RFC as one commit on current
The proposed key Tracking issue #29686 is unaffected. |
Problem / Motivation
Goal: Record the governance design for letting an operator's policy narrow which repository and config-selected local directories may supply skills to an agent.
A project's
.kiro/skills,skills.extra_paths, localskill://mappings and theKIROCREW_PROJECT_DIRsource can supplySKILL.mdinstructions, but no policy key represents those source roots today. Project skills have a local off switch and directory trust grant; neither gives an enterprise operator a central ceiling.Why it matters
A repository or local configuration can select skill content that enters the agent's context. The operator can govern discovery registries and many tool effects, but cannot centrally restrict these source directories. The design adds that missing ceiling without turning policy approval into a project trust grant.
Not a goal
What changed (motivation → approach → change)
This docs-only PR adds
rfc-local-skill-sources-governance.md. It proposes an allow-onlyskills.local_sourcespolicy key over canonical source roots, with policy acting as a conjunct beside the existing local controls. Four maintainer decisions are called out at the top.The rollout has two gates. Phase 0 inventories detected roots and previews the policy decision without changing admission. Phase 1 enforces the enterprise default-off behavior only after that preview exists. The RFC defines 22 executable Phase 1 assertions, including profile handling, path aliases, source replacement, catalog-generation races, duplicate-name shadowing, audit deduplication and harness parity.
The accepted enterprise-edition RFC's single "Extension sources" row is split into registry hosts and local skill sources, raising the appendix count from 66 to 67. The request-for-change index gains the new draft row.
Backwards compatibility
Compatible: this PR changes documentation only. The RFC records that its future Phase 1 would be a breaking enterprise default, preceded by a non-enforcing Phase 0 preview and migration recipe.
Removes nothing: no runtime, policy parser, skill source, configuration or user-facing behavior changes in this PR.
Tests
Proof: not provable -- docs-only change.
make buildpassed../scripts/docs-lint.shpassed..venv/bin/python scripts/local-gate.pypassed: 505 backend tests and 13,395 frontend tests.Manual verification
Reviewed all three changed documents against upstream
mainand confirmed the RFC index, enterprise control counts and cross-links agree. Confirmed no customer, private security-report or internal-only content appears in the diff.Screenshots / video
N/A, docs-only design proposal with no user-interface change.
Related Issues
Refs #29686
Checklist
Contribution License Agreement
Contributed under the repository's Apache-2.0 license.