sdlc-recall

Search the ZZ knowledge base and synthesize prior team decisions into a plain-English briefing.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill sdlc-recall-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdlc-recall
Source: https://github.com/zhixuan312/zz-stack/tree/main/catalog/sdlc/sdlc-flow/skills/sdlc-recall
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill sdlc-recall-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before designing or deciding something, teams often re-propose ideas they already tried or miss constraints they already settled. This Skill searches the shared ZZ knowledge base — team documents and journal nodes — and turns ranked search results into a plain-English answer about what the team already decided or learned on one topic. ## Core Features & Use Cases - Multi-query knowledge retrieval: Runs several knowledge_search queries with varied phrasings, filters, and both English and Chinese terms to avoid missing relevant nodes. - Evidence-grounded synthesis: Reads full nodes with document_read before citing anything as critical or high, distinguishes distilled nodes from dated documents, and flags superseded decisions. - Structured JSON output: Returns a briefing with weighted findings, evidence quotes, supersession status, and a record of the queries run. - Use Case: An agent dispatched by sdlc-explore to research "token expiry" searches decisions and designs, finds a superseded node showing the team already abandoned refresh rotation, and reports it so the caller marks that direction as already explored. ## Quick Start Dispatch this skill with one topic, such as asking it to find what the team already decided about session lifetime, and it will return a JSON briefing of relevant prior learnings.

Frequently Asked Questions about sdlc-recall

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

FAQPage Schema
How do I search a team knowledge base for prior decisions before designing?▼

Run knowledge_search with several differently phrased queries, then read the full nodes with document_read before citing them. Vary wording the way the original author might have written it, and search without a type filter when you mean everything the team knows.

How does knowledge_search rank and filter results?▼

knowledge_search fuses full-text relevance, tag overlap, and initiative evidence into a score, returning matched excerpts with provenance. Filters include query, type, status, initiative, flow, tags, include_superseded, and limit, but type spans two corpora so filtering on one silently hides the other.

Why does a Chinese knowledge search return empty results?▼

The index uses PostgreSQL's english configuration, which splits CJK on whitespace, so unspaced Chinese becomes one token that queries cannot match. Search Chinese topics in English too, prefer one Chinese word per query, and report empty Chinese results as inconclusive retrieval rather than no prior learning.

Why does document_read say a node does not exist?▼

document_read needs the initiative and path joined, such as _knowledge/nodes/0010-….md, not the path alone. For nodes on the platform shelf, you must also pass scope: "platform" or the read fails against the wrong store.

Should superseded decisions be excluded from search findings?▼

No, a superseded decision is often the most valuable finding because it shows the team already tried that direction and moved on. Report it clearly marked with its superseded_by reference, excluding it only if the caller explicitly asked for current state only.

Can this skill write new nodes to the knowledge base?▼

No, it is strictly read-only and never calls knowledge_add or knowledge_supersede. Recording new learnings is the handover stage's job, which runs after the initiative closes.