knowledge-base

Organizes durable project knowledge into canonical docs/resources paths with ADR, runbook, and digest conventions.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill knowledge-base-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: knowledge-base
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/knowledge-base
Command: npx skills add https://github.com/toderian/project_template --skill knowledge-base-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Agents and developers lose time guessing where authoritative project knowledge lives, duplicating facts across root files, task pages, and scattered notes. This Skill defines a single source-of-truth layout so durable knowledge is written once and discovered reliably. ## Core Features & Use Cases - Source-of-truth split: Assigns canonical ownership for glossaries, system maps, area summaries, dependency graphs, feature contracts, runbooks, and component contexts under docs/resources/. - Conventions and templates: Ships ADR, runbook, local-bindings, area-sources, and inbox-batch templates plus references for runbook, ADR, and generated-artifact naming rules. - Knowledge lifecycle lanes: Separates raw inbox staging, curated digests, rerunnable timestamped reports, and durable attachments so unstable material never pollutes canonical docs. - Use Case: After a teammate call, drop the transcript into docs/resources/_inbox/, distill it into a digest, promote stable facts into the area summary, and record provenance in sources.md. ## Quick Start Ask the agent to decide where a new architecture decision or operational procedure belongs and have it create the ADR or runbook using this skill's conventions.

Frequently Asked Questions about knowledge-base

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

FAQPage Schema
How do I decide where project documentation should live in a repo?

Use the source-of-truth split: domain language goes in docs/resources/CONTEXT.md, area architecture in docs/resources/<area>/summary.md, and operational procedures in runbooks. The skill's discovery order lists 13 canonical locations checked before asking the user.

When should I write an architecture decision record?

Write an ADR only when a decision is hard to reverse, surprising without context, and the result of a real trade-off. ADRs live in docs/adr/NNNN-slug.md with a one-to-three sentence body covering context, decision, and rationale.

How do I keep secrets out of committed runbooks?

Committed runbooks use placeholders like <HOST> and <USER> only; real values go in .local/runbooks/<scenario-slug>.local.md, which is gitignored. Never commit secrets, tokens, private hostnames, or account names.

What is the difference between _inbox, _digests, and _reports folders?

_inbox stages raw unprocessed source material, _digests stores curated summaries of those sources by area, and _reports holds timestamped rerunnable agent outputs like audits. Only stable facts get promoted into canonical docs.

Should generated task status pages be treated as architecture documentation?

No. Generated ledgers and area status pages under docs/areas/ are evidence about work status, not durable knowledge. Durable architecture notes belong in docs/resources/<area>/summary.md and related canonical files.