zhayujie/cowagent/knowledge-wiki

Knowledge Wiki

Maintain a persistent, structured knowledge base in the knowledge/ directory.

Core Operations

1. Ingest — User shares an article, document, or resource

1. Read and understand the source material
2. Extract key facts, insights, and structured knowledge
3. Determine the appropriate subdirectory:

• Read knowledge/index.md to see existing categories
• If a matching category exists, follow that structure
• If not, create a new subdirectory with a clear name

1. Create the knowledge page: knowledge/<category>/<slug>.md
2. Update knowledge/index.md and append to knowledge/log.md

2. Synthesize — Conversation produces valuable structured knowledge

1. Create a knowledge page under the appropriate category
2. Update related pages with cross-references
3. Update knowledge/index.md and knowledge/log.md

3. Query — User asks about accumulated knowledge

1. Check knowledge/index.md (already in your context) for relevant pages
2. Read specific pages with the read tool
3. Supplement with memory_search if needed

Page Format

# Page Title
 
> Source: <URL or description of the original material>
 
Content here. Cross-reference related pages with markdown links:
[Related Page](../category/related-page.md)
 
## Key Points
 
-...
 
## Related
 
-[Page A](../category/page-a.md) — how it relates
-[Page B](../category/page-b.md) — how it relates

The > Source: line records where the knowledge came from (URL, document name, conversation, etc.). Always include it when the material originates from a specific source.

Cross-references build a knowledge graph. When creating or updating a page, link to related pages and update those pages to link back. Only link to pages that already exist — if a concept deserves its own page, create it first, then add the link.

Index Format (knowledge/index.md)

Flat list, one line per page: [Title](path) — one-line summary. Group by category (matching subdirectories). No tables, no emoji.

# Knowledge Index
 
## Category A
-[Page Title](category-a/page-slug.md) — one-line summary
 
## Category B
-[Page Title](category-b/page-slug.md) — one-line summary

Category names and structure are flexible — follow whatever organization already exists in the index, or create new categories based on the content.

Log Format (knowledge/log.md)

Append-only, newest at bottom:

## [YYYY-MM-DD] ingest | Page Title
## [YYYY-MM-DD] synthesize | Page Title

Guidelines

• File naming: lowercase kebab-case (e.g. machine-learning.md)
• One topic per page: link between pages rather than duplicating
• Update, don't duplicate: if a page exists, update it
• Cross-reference: every page should link to related pages; keep the knowledge graph connected
• Index is mandatory: always update knowledge/index.md after any change
• Be concise: capture essence, not copy entire sources
• Full paths in replies: when referencing knowledge files in conversation replies, use the full path from workspace root (e.g. [Title](knowledge/<category>/<slug>.md)), not relative paths. Relative paths are only for cross-references inside knowledge pages themselves.
• Cite sources: when answering based on knowledge pages, include links to the relevant pages so the user can explore further.