kebab/tasks/_template.md

phase, component, task_id, title, status, depends_on, unblocks, contract_source, contract_sections

phase	component	task_id	title	status	depends_on	unblocks	contract_source	contract_sections
P<N>	<crate-or-module-name>	p<N>-<i>	<Component title>	planned			../docs/superpowers/specs/2026-04-27-kb-final-form-design.md

<task_id> —

Goal

Why now / why this size

Allowed dependencies

• kb-core
• <other crates per design §8>

Forbidden dependencies

• <list — every crate banned per design §8 Allowed/Forbidden table>

If any item here is needed during implementation, STOP and update the frozen design doc first.

Inputs

input	type	source
...	...	...

Outputs

output	type	downstream consumer
...	...	...

Public surface (signatures only — no new types)

// Cite only types/traits already defined in the frozen design doc.
// If a new helper is needed, mark it "internal" and keep it crate-private.

Behavior contract

• <determinism / version recording / error policy>

Storage / wire effects

• DB tables touched (read/write)
• LanceDB tables touched (read/write)
• Filesystem paths created/read
• Wire schema objects emitted (must conform to *.v1)

Test plan

kind	description	fixture / data
unit	...	...
snapshot	... (JSON freeze)	fixtures/...
contract	trait round-trip	mock impls
integration	end-to-end via kb-app facade	tmp workspace

All tests must run under cargo test -p <crate> and not require external network or Ollama unless explicitly stated.

Definition of Done

• cargo check -p <crate> passes
• cargo test -p <crate> passes
• No imports outside Allowed dependencies
• All emitted wire JSON validates against docs/wire-schema/v1/<schema>.schema.json (when applicable)
• All record version fields populated per design §9
• PR body links the relevant design section numbers

Out of scope

• <explicit list — features that other tasks cover>

Risks / notes

• <one paragraph max — known traps, version coupling, perf concerns>