gtkb-spec-intake

Capture owner requirements as deferred candidates and promote them into KB specs after explicit confirmation.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill gtkb-spec-intake
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gtkb-spec-intake
Source: https://github.com/Remaker-Digital/groundtruth-kb/tree/main/groundtruth-kb/templates/skills/spec-intake
Command: npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill gtkb-spec-intake

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes helpers (resource) components.

What problem does it solve?

This Skill captures an owner-stated requirement as a deferred, auditable candidate and only creates a KB spec after explicit owner confirmation, keeping the governance trail consistent and explainable.

Core Features & Use Cases

  • Deferred requirement capture: Records a requirement-candidate deliberation at outcome deferred without creating specs or other artifacts.
  • Confirm-before-mutate workflow: Promotes a captured candidate into a KB spec only after confirmation, and records an owner decision deliberation.
  • Explicit rejection with rationale: Rejects a candidate with a required, non-empty reason and records a no-go deliberation without creating a spec.

Quick Start

Capture an owner requirement for later confirmation by invoking gtkb-spec-intake with your requirement text, then run confirm or reject once the owner explicitly approves or disapproves.

Frequently Asked Questions about gtkb-spec-intake

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture requirements for later review without creating artifacts prematurely?

Requirement intake workflows can capture owner-stated requirements as deferred deliberation candidates without creating specs or artifacts. The requirement remains in a pending state until the owner explicitly confirms or rejects it, ensuring an auditable governance trail.

What is the confirm-before-mutate pattern for governed knowledge base specs?

The confirm-before-mutate pattern defers any knowledge base spec creation until an explicit owner confirmation is provided. It enforces audit trail consistency by recording the changed_by attribution and capturing the owner_decision deliberation only upon successful promotion.

How do I record a rejected requirement with an audit trail?

To reject a requirement, you must provide a non-empty rationale. The system then records a no_go deliberation capturing the rejection reason without creating a specified artifact, maintaining a clear and explainable governance history.

Can I promote a deferred requirement candidate into a KB spec after initial capture?

Yes, a captured requirement candidate can be promoted into a governed knowledge base spec. Running the confirmation process after the owner's explicit approval creates the specified spec and records the corresponding owner decision deliberation.

Does requirement intake tracking work without external dependencies?

Yes, this requirement intake and governance tracking operates without external dependencies. It uses internal helpers to manage the deliberation lifecycle, ensuring requirements are tracked, reviewed, and confirmed entirely within its own workflow.

When should I use a deferred deliberation candidate for spec creation?

Use a deferred deliberation candidate when requirements must be tracked and reviewed before altering a governed knowledge base. This approach prevents premature mutations by ensuring specs are only created after explicit owner confirmation and attribution.