| name | auto-spec-intake |
| description | Automatically create or update a local Agentic OS spec packet for long OS-shaping requests before implementation work continues. Use when the user gives a multi-part Agentic OS feature/rules/conventions request or says /auto-add-spec. |
Auto Spec Intake
Use this skill when a request is large enough that losing the chat would lose
the work definition.
Intake Loop
- Load the routed OS layer and
harness/rules/os-authoring-rules.md.
- Run
agentic-os doc-config plan with the original request.
- Search active and intake work-items for a matching spec.
- Create or update a packet with
SPEC, PLAN, WORKLOG, NEXT, and
QUESTIONS when unresolved questions exist.
- Add
CONVENTIONS when the request creates reusable OS behavior.
- Record any required source worktree registration.
- Hand the packet path back to the orchestrator before implementation.
- Create the unified intake row (non-blocking):
agentic-os-intake-row \
--title "<spec title>" \
--type spec \
--route-text '<user's original words>' \
--body-file <packet SPEC.md path>
If the row create fails, record the error in the packet worklog and continue.
Context Budget
Do not load all prior work. Search by title/request terms, active work indexes,
and doc-config search methods. Load only the matching packet and the compact
authoring rules.
Guardrails
- Do not generate
IDEA.md for new packets. Existing IDEA.md files remain
readable legacy capture.
