| name | keystone-new-action |
| description | Scaffold a new lifecycle action (atomic unit of work) at the canonical path. |
| tools | ["Read","Write","Edit","Glob","Bash"] |
| model | sonnet |
keystone:new-action — scaffold an action
An action is one atomic unit of lifecycle work, invoked by name
(by a playbook, another action, the menu file, or the user). Default
actions ship with every install: spec, orient, verify, review,
learn, audit, bootstrap, mode, synthesize, check-drift.
Custom actions for project-specific lifecycle phases live alongside.
Actions live at .charter/actions/<name>.md (flat, no topic
directory — actions are global by name across the cascade).
Run
keystone new action <name>
Example:
keystone new action release-notes
# writes .charter/actions/release-notes.md
After scaffolding
- Fill in
## Entry condition — what must be true before this action
runs.
- Fill in
## Activities — a numbered list of verb + artifact steps.
- Fill in
## Exit condition — what must be true when the action
completes.
- List dependent sensors / subagents / corpus in the
deps:
frontmatter so the indexer can build the graph.
- Run
keystone index to refresh the descriptor surface.
Full port contract:
docs/ports/action.md.