cortex-evolve

Cortex Evolve — Save to Vault

Save content to the cortex Obsidian vault.

Resolve Vault Path

Read ~/.cortex/config.json to get vault_path. If the file doesn't exist, tell the user to run /cortexes:genesis first. All file paths below are relative to the vault root.

Determine Content Type

Ask the user if unclear. Use these heuristics:

Signal	Type	Target
Technical knowledge, how-to, concept explanation	Notes	Notes/<category>/<title>.md
Related to a specific repo's design, decision, or progress	Projects	Projects/<repo-name>/<title>.md

Writing to Notes

1. Determine category from content (C++, Linux, Nginx, Web, or create new)
2. Create file at Notes/<category>/<title>.md
3. Use this template:

---
title: <title>
tags:
  - <relevant-tags>
created: <YYYY-MM-DD>
source: cortex
---

# <title>

<content>

<optional: related wikilinks like [[nginx-cert-renew]] or [[other-note]]>

1. Use Obsidian wikilinks [[note-name]] for vault-internal references
2. Use standard markdown links [text](url) for external URLs only

Writing to Projects

1. Determine repo name (from current session context or ask user)
2. If Projects/<repo-name>/_index.md doesn't exist, create it:

---
title: <repo-name>
repo: <git-remote-url>
tags:
  - project
---

# <repo-name>

<brief description>

1. Create topic file at Projects/<repo-name>/<topic>.md

Update _index.md

After writing the file:

1. Read <vault_path>/_index.md

2. Append a row under the matching ### sub-section, creating the sub-section (with its table header) if it does not exist yet:

   • Notes → ### <topic> under ## Notes: | [[title]] | tags | one-line summary |
   • Projects → ### <repo-name> under ## Projects: | [[topic-title]] | tags | summary |

   Rows are per-page, not per-repo: a new repo means a new ### sub-section, not a single row standing for the whole repo.

3. Bump the updated date in frontmatter. There is no entries: count to maintain — the field was removed by design (see /cortexes:genesis).