---
name: neural-vfs-indexer
description: Scans the VFS to create semantic mappings between concepts and file paths.
tags: [neural-vfs, semantic, indexing, newos4]
category: system
---

# Neural VFS Indexer

## Purpose
To implement the "Neural VFS" pillar of newOS4 by creating a semantic layer over the hierarchical filesystem.

## Workflow
1. **Discovery**: List all files in the VFS using `list_files`.
2. **Analysis**: Read the contents of each file.
3. **Keyword Extraction**: Identify primary themes, technical terms, and "concepts" within the file.
4. **Indexing**: Create a mapping file in `.semantic_index/` named after the concept (e.g., `.semantic_index/cognitive-kernel.map`).
5. **Mapping**: The mapping file should contain the path to the source file and a brief semantic summary.

## Usage
Run this skill when new documentation is added or when the architectural structure changes.