Role: the tech meta-skill. Add a non-language concern the descriptor does not cover: a lane entry, a spine task, or a hook policy. Generate the matching artifact from its schema and wire it into the descriptor.

Prerequisites

~/.agentic-sdk/<project>/project.edn exists (run bootstrap-project first). A real project need the curated config does not cover: a new build target, a deterministic clerical task the model does by hand, or a policy that belongs in a hook rather than a prompt.

Procedure

Follow the shared add-* procedure in docs/design.md section 8.3: detect the gap, interview for the skeleton's variable slot, generate against the skeleton, wire into the descriptor, validate. The artifact kind depends on the gap.

Detect the gap and classify it. One of three kinds:
- Lane entry: a new command in :lanes :cheap, :wave, or :pre-land (a formatter, a linter, a release gate, a deep test tier).
- Spine task: a new deterministic clerical task that joins the interface in skills/shared/references/spine.md. The model does it identically every time, so it earns promotion to the spine.
- Hook policy: a new template in :hooks that enforces a policy at the tool boundary, the way format-on-write, deny-secrets, and require-tests-before-land do.
Interview for the schema. Ask one batch of at most three questions for what the artifact's schema needs:
- For a lane entry: the command, the tier (cheap, wave, pre-land), and what failure stops.
- For a spine task: the invocation name and arguments, what it reads, what it writes, the invariant it owns, and the exit contract (one line on stdout, exit code). It must be pure and deterministic on the unambiguous cases and refuse with a structured escalation on the ambiguous ones.
- For a hook policy: the trigger (PreToolUse or PostToolUse, on which tools), the check, and the deny or warn action.
Generate the artifact.
- For a lane entry: no new file; the command lands in the descriptor.
- For a spine task: author the task entry against the interface in spine.md. It joins the five stable names (triage, integrate, run, compile-rules, lint) or extends the catalog with a new name that answers the same contract shape.
- For a hook policy: author the hook template into the toolkit's hook templates, parameterized by the descriptor.
Wire the descriptor. Add the lane command to :lanes, the spine task name to the spine adapter, or the hook key to :hooks. The descriptor is the single tuning valve; the artifact is dead config without a descriptor entry.
Validate. Run the artifact once dry: the lane command green on a clean tree; the spine task run on a sample input with the expected exit contract; the hook policy firing on a sample trigger and passing on a clean one. Tune from what the validation surfaced.
Land. One commit, category Skills: (or Build: for a pure lane addition).

Boundaries

Produces one project-local artifact (a spine task, a hook template) or one descriptor amendment (a lane entry). The artifact is a candidate for promotion to a toolkit master via incorporate-feedback; promotion is deliberate, never automatic. Does not add a language (that is add-language) or a review dimension (that is add-dimension). Amends only the descriptor and adds only the artifact file. Atoms referenced: skills/shared/references/spine.md for the spine task interface, docs/design.md section 9 for the hook templates, the project descriptor.

Return

One line: the artifact kind and path (or the descriptor field for a lane entry), the descriptor field amended, and the validation verdict.

Más de este repositorio

mismo repositorio

check-style

leifericf/agentic-sdk

Review dimension for naming, idiom, comment debt, and AI tells against the codified per-language and prose standards. Invoked by reviewer agents over one module shard.

2026-07-045

write-c

leifericf/agentic-sdk

Recipe for writing C in the runtime, module placement and the ownership and control-flow discipline. Invoked by writer agents when a C unit is dispatched.

2026-07-045

write-clj

leifericf/agentic-sdk

Recipe for writing Clojure, Functional Core / Imperative Shell at the function level (namespaces by domain), native wrappers, and the boundary discipline. Invoked when writing Clojure for the project.

2026-07-045

write-elixir

leifericf/agentic-sdk

Recipe for writing Elixir, pure functions in modules as the core and GenServer plus OTP as the shell, supervision trees, and NIF discipline for the C and Zig edge. Invoked when writing Elixir for the project.

2026-07-045

write-prose

leifericf/agentic-sdk

Recipe for any English the agent produces in this project, commits, comments, docstrings, ADRs, design docs, skill bodies, changelog, error messages, project guides. Optimizes for terse, humanized prose with no em dashes and no AI tells. Invoke for any prose-writing activity.

2026-07-045

write-zig

leifericf/agentic-sdk

Recipe for writing Zig, native bodies and edge wrappers, the allocator and lifetime discipline, and the hot-path rules. Invoked when writing or editing any Zig source.

2026-07-045

add-tech

Prerequisites

Procedure

Detect the gap and classify it. One of three kinds:

Lane entry: a new command in :lanes :cheap, :wave, or :pre-land (a formatter, a linter, a release gate, a deep test tier).
Spine task: a new deterministic clerical task that joins the interface in skills/shared/references/spine.md. The model does it identically every time, so it earns promotion to the spine.
Hook policy: a new template in :hooks that enforces a policy at the tool boundary, the way format-on-write, deny-secrets, and require-tests-before-land do.

Interview for the schema. Ask one batch of at most three questions for what the artifact's schema needs:

For a lane entry: the command, the tier (cheap, wave, pre-land), and what failure stops.
For a spine task: the invocation name and arguments, what it reads, what it writes, the invariant it owns, and the exit contract (one line on stdout, exit code). It must be pure and deterministic on the unambiguous cases and refuse with a structured escalation on the ambiguous ones.
For a hook policy: the trigger (PreToolUse or PostToolUse, on which tools), the check, and the deny or warn action.

Generate the artifact.

For a lane entry: no new file; the command lands in the descriptor.
For a spine task: author the task entry against the interface in spine.md. It joins the five stable names (triage, integrate, run, compile-rules, lint) or extends the catalog with a new name that answers the same contract shape.
For a hook policy: author the hook template into the toolkit's hook templates, parameterized by the descriptor.

Wire the descriptor. Add the lane command to :lanes, the spine task name to the spine adapter, or the hook key to :hooks. The descriptor is the single tuning valve; the artifact is dead config without a descriptor entry.

Validate. Run the artifact once dry: the lane command green on a clean tree; the spine task run on a sample input with the expected exit contract; the hook policy firing on a sample trigger and passing on a clean one. Tune from what the validation surfaced.

Land. One commit, category Skills: (or Build: for a pure lane addition).

Boundaries

Return

One line: the artifact kind and path (or the descriptor field for a lane entry), the descriptor field amended, and the validation verdict.