# Knowledge-Base — Agent Collaboration Guide

## Purpose
Curated insights distilled from `research/`, daily logs, and cross-agent contributions. This is the “source of truth” that other agents should consult before making architectural decisions.

## File Naming
Descriptive, lowercase filenames with `.md` extension:
- `morpheus-identity.md`
- `forgejo-migration-checklist.md`
- `<topic>-overview.md`

## Front-Matter Template
```yaml
---
title: "<human readable title>"
date: YYYY-MM-DD
tags: ["#knowledge-base", "#topic-tag"]
status: published
related:
  - ../research/tech-study/2026-06-11-forgejo-url-change.md
  - ../daily/2026-06-11-log.md
---
```

## Workflow
1. **Read existing entries** before adding new ones to avoid duplication.
2. **Synthesize** findings from `research/` or `daily/` into a distilled summary.
3. **Link back** to source files using the `related` field.
4. **Mark status** as `draft`, `review`, or `published`.
5. **Add an entry** to `index.md` with a one-line description and link.

## Example Entry
```markdown
# Forgejo Migration Checklist

Quick checklist for moving repositories from the old sslip.io instance to git.errorlog.space.

- [ ] Update remotes
- [ ] Regenerate API keys
- [ ] Update CI variables
```