ref-sp-agents-policylisted
Install: claude install-skill swiftpostlabs/agentic-tools
# Swiftpost Agents Policy
## Purpose
Document this repository's concrete AI policy implementation: the canonical policy file, the grouped `agentic-tools policy` CLI surface, the generated client outputs, and the service-selection model that decides which vendors receive managed files.
## When to use this skill
- Working on the agents-policy feature or its generator logic.
- Updating policy docs, CI enforcement, or command references in this repo.
- Debugging why `.aiexclude`, `.claude/settings.json`, or `.vscode/settings.json` did or did not change.
- Explaining how the `policy` section in `.agents/config.json` should be authored in this repo.
## Scope boundaries
This skill is the **repo-local layer**: how the `agents-policy` feature is actually built here — the
`.agents/config.json` policy section, the sync command, and the generated vendor outputs.
- `ref-sp-agents-security` — the portable model behind it: protected vs excluded files, the
multi-client enforcement story, and why the policy exists. Read that for the *why*, this for the
*how it is wired here*.
- `ref-sp-agents-skills-management` — the other consumer of `.agents/config.json`. The two features
share a config file, not a subject.
- `ref-sp-dev-repo-conventions` — where the feature's code belongs in this repo's layout.
## Stable Surface
- Canonical policy file: `.agents/config.json` with a top-level `policy` object
- Canonical commands:
- `uv run agentic-tools policy sync`
- `uv run agentic-tool