Wiki Query

Answer questions about the asset library by searching synthesis pages and underlying asset metadata.

Input

Accept a natural-language question about the asset library. Examples:

• "What Kubernetes tools do we have?"
• "Which prompts help with Terraform state management?"
• "Are there any assets for incident response?"

Search Process

Step 1: Read the synthesis index

Read docs/synthesis/README.md to get the full list of synthesis pages with their titles and descriptions. This serves as the top-level table of contents for the wiki.

Step 2: Search synthesis pages

Search across all files in docs/synthesis/ for content relevant to the question:

• Match against page titles (H1 headings)
• Match against description fields in YAML frontmatter
• Match against body content (section headings, paragraphs, lists)
• Match against tags arrays in frontmatter

Rank results by relevance. Prefer pages where the match appears in the title or description over body-only matches.

Step 3: Search asset metadata

Read metadata.json and search individual asset entries for matches against the question. This catches assets that may not yet be covered by a synthesis page. For each matching asset, note its id, title, description, tags, and file_path.

Step 4: Cross-reference

For each matching synthesis page, read its sources frontmatter to identify which individual assets contribute to it. For each matching individual asset, check whether it appears in any synthesis page's sources list.

Answer Format

Provide a clear, direct answer to the question with the following structure:

Answer

A concise paragraph (2-5 sentences) directly answering the question based on findings.

Relevant Synthesis Pages

A bulleted list of synthesis pages that informed the answer:

• Page title (docs/synthesis/{filename}.md) -- one-line summary of relevance

Source Assets

A bulleted list of individual assets referenced:

• Asset title ({asset-path}) -- brief description

Related Pages

Suggest 1-3 additional synthesis pages the user might find useful for further reading, even if they did not directly match the query.

Optional: Propose New Synthesis

If the search reveals a cluster of 3 or more related assets that are not covered by any existing synthesis page, offer to create one:

1. State the gap: "There are N assets related to {topic} but no synthesis page covers them."
2. List the assets that would be sources.
3. Suggest a title and filename for the new page.
4. Wait for user approval before creating any files. Do not create synthesis pages without explicit confirmation.