Agent skill · dmmulroy
tech-spec
Write a typed call-stack architecture handoff.
What it needs
About 5k tokens when loaded.
What this skill does
Tech Spec A tech spec is a typed call-stack architecture handoff: code-shaped contracts plus execution flows. Prefer TypeScript pseudocode over prose wherever precision matters. This skill is design-only. Do not implement. Save a file only when the user asks for a file; otherwise return the spec inline. Branch selection 1. Use Path A: Convert context to spec when the conversation, docs, or codebase already contain enough background to describe the change. 2. Use Path B: Grill first when the user wants a new spec but has not provided enough problem, constraints, design direction, affected code, or acceptance criteria. If a question can be answered by exploring the codebase, inspect the codebase instead of asking. Completion criterion: the branch is chosen from actual available context; missing architectural decisions are not invented. Path A: Convert context to spec 1. Load standards and local context Inspect existing code and docs for local vocabulary, module layout, domain concepts, errors, adapters, observability, runtime patterns, and test style. Completion criterion: the spec uses project vocabulary and does not introduce a pattern, library, adapter, schema style, or test strategy before checking local precedent. 2. Extract the design problem Capture: current state; problem; users/callers; goals; non-goals; constraints; invariants; affected systems; likely entrypoints; operational/runtime concerns; risks; open questions. Mark unknowns as open questions instead of filling gaps with plausible design. Completion criterion: every claimed requirement or constraint is grounded in conversation, code, docs, or an explicit open question. 3. Explore design alternatives Produce materially different alternatives before choosing the recommended design. Alternatives should differ in interface shape, seam placement, ownership, call stack, runtime topology, or module boundaries — not just names. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills dmmulroy/tech-spec