| name | keystone-new-policy |
| description | Scaffold a new policy repo skeleton outside the current project. |
| tools | ["Read","Write","Edit","Glob","Bash"] |
| model | sonnet |
keystone:new-policy — scaffold a policy repo
A policy is a separately-versioned charter fragment that consumer
projects pin in their keystone.json (e.g. an org-wide policy that
ships strict guides). This generator writes a fresh policy repo
skeleton — manifest, charter directory layout, README — that you then
populate and publish.
Unlike the other generators, keystone new policy writes to
./<name>/ in the current working directory, not into an existing
charter install.
Run
From the directory where the policy repo should land:
keystone new policy <name>
Example:
keystone new policy acme-policies
# writes ./acme-policies/{keystone-policy.json, .charter/, README.md, ...}
After scaffolding
- Fill in
keystone-policy.json — name, version, required port
declarations, strict locks.
- Author the policy's
.charter/ content — guides, sensors, etc.
- Initialize git and push to a host so consumers can pin the source.
- Consumers add the policy via
keystone policy add <owner>/<repo>@<version>.
See the policy authoring guide for the full
policy lifecycle.