agentsclimarketplace

Plumbline spec engine

Skill nickyfactz/plumbline/skills/plumbline-spec-engine

Internal Plumbline engine. Use only after the Plumbline router or a Plumbline phase wrapper selects specification work.From its SKILL.md

Install
npx -y skills add nickyfactz/plumbline --skill plumbline-spec-engine

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.8 KB, as published. Nobody here has run it

Specification engine

Outcome and completion

Create or adopt one controlling product specification for the current task. A specification is complete when it states the product outcome, users/workflows, scope, non-goals, required behavior, constraints, acceptance/proof direction, and remaining assumptions or residual questions clearly enough for planning.

Adopt the strongest source

Assess sufficiency, not Plumbline conformance. Accept a user-supplied internal or external design, handoff, attachment, or prior plan when it settles outcome, users/workflows, scope, non-goals, behavior, constraints, and acceptance/proof. Adopt it at the latest safe phase without replaying settled shaping.

When an artifact is sufficient for execution but lacks a separate specification file, preserve the artifact. Do not require a separate file when the supplied artifact is sufficient. Recommend a companion only when it materially improves product clarity or recovery. Keep one controlling source for the task; name competing candidates and ask the user to select one rather than silently merging them.

Read references/specification-template.md, references/artifact-lifecycle.md, and references/product-autonomy.md when creating, adopting, or expanding a specification. Use the repository's existing canonical/transient locations. For a blank repository, use docs/specs/<feature-slug>.md.

Adopt a shaping handoff

When an approved shaping handoff exists, promote it in place as the active specification. Expand its compact headings into the existing specification template instead of creating a competing file. Preserve decisions, research findings and source links, open product questions, fog items, rejected alternatives, and non-goals. Carry non-blocking fog into assumptions or residual questions; leave it visible without blocking planning.

Materialize chat-only or attachment-only requirements before long-running work when a durable record is needed. Preserve source and provenance, avoid rewriting large or binary inputs wholesale, hash large inputs when appropriate, and use a safe Markdown extraction when committing the original is unsafe.

Resolve product questions only

Ask only blocking product questions, one at a time, with a recommendation. Technical choices belong to the agent and should come from repository evidence, research, conventions, and safe defaults. Record product amendments explicitly and keep the approved source's intent intact.

When the controlling artifact is sufficient for the next phase, report the adoption or companion recommendation once and direct the user to plumbline-plan or plumbline-execute. Specification creates or adopts the contract; it does not implement code.

Keep looking

Skills are one crate of 613,872. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.