Tech templates
The Tech layer answers how do we build it? — it lives under knowledge/tech/.
| Template | Purpose | Output path | Agent |
|---|---|---|---|
| Codebase | Intended codebase structure & conventions (no code) | knowledge/tech/codebase.md | codebase-agent |
| Current State | Reconstructed architecture baseline | knowledge/tech/current-state.md | architecture-agent |
| Architecture Notes | Working notes, not yet decided | knowledge/tech/architecture-notes.md | — |
| Decision Candidates | Candidate decisions for review | knowledge/tech/decision-candidates.md | adr-agent |
| Quality Attributes | Prioritized quality attributes + trade-offs | knowledge/tech/quality-attributes.md | bootstrap-agent |
| ADR | A single accepted decision | knowledge/tech/decisions/ | — |
Stack, standards, security and Git strategy are also Tech artifacts — see Operations templates, installable with
kaddo add.
Codebase
The intended codebase foundation: suggested structure, modules, boundaries and
conventions — coherent with business, product and the candidate stack. Generated by
kaddo bootstrap; refined with the codebase-agent. It describes the foundation, never
production code.
Current State
Components, data & integrations, cross-cutting concerns, known gaps and assumptions —
the baseline architecture-agent reconstructs from the context pack.
Architecture Notes
Explicitly non-binding: topic, context, options and what you are leaning towards. Promote into a Decision Candidate or ADR when ready.
Decision Candidates
DC-001 entries with context, options, recommended option and trade-offs. Promote
accepted candidates into individual ADRs.
Quality Attributes, Codebase Foundation & Bootstrap Summary
Generated by kaddo bootstrap for new projects: prioritized
quality attributes (no “all high”), the intended codebase foundation (structure and
conventions, never source code) and an index of the initial knowledge base with the
next step.
ADR
Front matter (id, status, date). Sections: Status · Context · Decision ·
Consequences (including downsides) · Alternatives considered. Install the adr module
with kaddo add adr to create them as work items.