| name | gsp |
| description | Gest Spec. Draft or update a Gest spec artifact for substantial or unclear work, then ensure implementation happens through follow-on Gest tasks. |
GSP: Gest Spec
Use when work needs product/design shaping before implementation.
When To Spec
Create a spec when behavior is unclear, there are meaningful trade-offs,
acceptance criteria need negotiation, multiple systems are affected, or GitHub
visible development is likely.
Gest Memory
Before drafting or updating a spec, search Gest for related specs, tasks,
iterations, prior decisions, and follow-ups:
gest search "<spec topic>" --all --json --limit 20
gest search "<affected feature/module>" --all --json --limit 20
Inspect relevant hits with gest task show, gest task note list, and
gest iteration show. Include durable references in the spec's References
section when they shape the proposal.
Also run the tag/dependency discovery from references/tag_dependency_workflow.md so
the spec captures existing semantic tags, proposed new tags, and code surfaces
that should be checked with ast-grep.
Spec Shape
# Spec: <Title>
## Problem Statement
## Proposed Solution
## Scope
### In Scope
### Out of Scope
## Acceptance Criteria
## Open Questions
## References
Keep specs concise enough to read quickly.
Save
Save as a Gest artifact tagged spec plus area tags:
gest artifact create "<title>" --tag spec --tag <area> --body "<body>" --quiet
Link to outline tasks where appropriate. Do not implement directly from the
artifact; use gpl/gis to create follow-on tasks.