# Concepts

Second-brain semantic layer: nouns map atomically to file sets (EXTRACTED); verbs aggregate structural edges (INFERRED).

| Concept | Files | Mentions | Top Files |
|---------|-------|----------|-----------|
| `readmenator` | 104 | 201 | `readmenator.py`, `readmenator/__init__.py`, `readmenator/__main__.py`, `readmenator/_agent_injector.py`, `readmenator/_agent_output.py` |
| `returns` | 98 | 496 | `readmenator/_agent_injector.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py` |
| `file` | 91 | 652 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py` |
| `graph` | 73 | 353 | `readmenator/__init__.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `node` | 67 | 267 | `readmenator/__init__.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `files` | 66 | 209 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py` |
| `when` | 65 | 231 | `readmenator/_agent_injector.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `args` | 62 | 372 | `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py` |
| `symbols` | 61 | 100 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_apidocs.py`, `readmenator/_components.py`, `readmenator/_cpg.py` |
| `empty` | 60 | 132 | `readmenator/_app.py`, `readmenator/_bundlegraph.py`, `readmenator/_cache.py`, `readmenator/_category.py`, `readmenator/_components.py` |
| `project` | 59 | 296 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py` |
| `edges` | 59 | 292 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py` |
| `return` | 59 | 287 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `imports` | 56 | 87 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_app.py`, `readmenator/_category.py`, `readmenator/_cpg.py` |
| `nodes` | 55 | 222 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py` |
| `build` | 54 | 256 | `readmenator/__main__.py`, `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py` |
| `contract` | 54 | 227 | `tests/test_agent_friendliness.py`, `tests/test_agent_injector.py`, `tests/test_agent_output.py`, `tests/test_analyzer.py`, `tests/test_apidocs.py` |
| `config` | 54 | 157 | `readmenator/__init__.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py` |
| `symbol` | 53 | 155 | `readmenator/__init__.py`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py` |
| `every` | 53 | 134 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `all` | 53 | 91 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `one` | 52 | 189 | `deploy.sh`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py` |
| `set` | 52 | 110 | `readmenator/_analyzer.py`, `readmenator/_app.py`, `readmenator/_category.py`, `readmenator/_concepts.py`, `readmenator/_diagrams.py` |
| `text` | 51 | 241 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py` |
| `import` | 51 | 188 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py` |
| `content` | 51 | 108 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_bundlegraph.py` |
| `path` | 49 | 198 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `source` | 49 | 180 | `readmenator.py`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `map` | 47 | 198 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_category.py` |
| `edge` | 47 | 145 | `readmenator/__init__.py`, `readmenator/_app.py`, `readmenator/_bundlegraph.py`, `readmenator/_bundlegraph_page.py`, `readmenator/_category.py` |
| `without` | 46 | 76 | `readmenator/__init__.py`, `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py` |
| `line` | 43 | 175 | `readmenator/__main__.py`, `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `analysis` | 42 | 172 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_app.py`, `readmenator/_cache.py` |
| `per` | 41 | 99 | `deploy.sh`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `deterministic` | 41 | 94 | `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `configuration` | 41 | 79 | `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py` |
| `not` | 41 | 63 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_cache.py` |
| `name` | 40 | 164 | `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py`, `readmenator/_components.py` |
| `only` | 40 | 75 | `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_bundlegraph.py`, `readmenator/_cache.py`, `readmenator/_components.py` |
| `list` | 39 | 89 | `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `knowledge` | 39 | 70 | `readmenator/__init__.py`, `readmenator/_agent_injector.py`, `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py` |
| `directory` | 38 | 171 | `deploy.sh`, `readmenator/_agent_output.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `resolved` | 38 | 110 | `readmenator/_agent_output.py`, `readmenator/_analytics.py`, `readmenator/_analyzer.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py` |
| `none` | 38 | 79 | `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_bundlegraph.py`, `readmenator/_cache.py`, `readmenator/_category.py` |
| `parser` | 37 | 111 | `readmenator/__main__.py`, `readmenator/_apidocs.py`, `readmenator/_docstrings.py`, `readmenator/_models.py`, `readmenator/_project_config.py` |
| `never` | 37 | 71 | `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_app.py`, `readmenator/_dataflow.py`, `readmenator/_dead_code.py` |
| `extract` | 37 | 65 | `readmenator/_agent_injector.py`, `readmenator/_apidocs.py`, `readmenator/_concepts.py`, `readmenator/_cursorrules_generator.py`, `readmenator/_dataflow.py` |
| `output` | 36 | 145 | `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py`, `readmenator/_bundlegraph.py` |
| `json` | 36 | 126 | `readmenator/_agent_output.py`, `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py`, `readmenator/_app.py` |
| `class` | 36 | 102 | `readmenator/_apidocs.py`, `readmenator/_apidocs_page.py`, `readmenator/_apidocs_render.py`, `readmenator/_category.py`, `readmenator/_flowpage.py` |

## Verb Edges

| Source | Verb | Target | Strength |
|--------|------|--------|----------|
| `graph` | `depends_on` | `readmenator` | 1.00 |
| `file` | `depends_on` | `readmenator` | 0.99 |
| `graph` | `depends_on` | `file` | 0.93 |
| `readmenator` | `depends_on` | `file` | 0.93 |
| `returns` | `depends_on` | `readmenator` | 0.91 |
| `project` | `depends_on` | `readmenator` | 0.87 |
| `build` | `depends_on` | `readmenator` | 0.85 |
| `project` | `depends_on` | `file` | 0.80 |
| `return` | `depends_on` | `readmenator` | 0.80 |
| `returns` | `depends_on` | `file` | 0.80 |
| `text` | `depends_on` | `readmenator` | 0.80 |
| `map` | `depends_on` | `readmenator` | 0.79 |
| `build` | `depends_on` | `file` | 0.78 |
| `files` | `depends_on` | `readmenator` | 0.78 |
| `graph` | `depends_on` | `every` | 0.77 |
| `node` | `depends_on` | `readmenator` | 0.77 |
| `edge` | `depends_on` | `readmenator` | 0.76 |
| `file` | `depends_on` | `graph` | 0.76 |
| `readmenator` | `depends_on` | `every` | 0.76 |
| `readmenator` | `depends_on` | `source` | 0.75 |
| `file` | `depends_on` | `every` | 0.74 |
| `readmenator` | `depends_on` | `graph` | 0.74 |
| `symbol` | `depends_on` | `readmenator` | 0.73 |
| `edges` | `depends_on` | `readmenator` | 0.72 |
| `file` | `depends_on` | `source` | 0.72 |
| `files` | `depends_on` | `file` | 0.72 |
| `graph` | `depends_on` | `source` | 0.72 |
| `node` | `depends_on` | `file` | 0.72 |
| `source` | `depends_on` | `readmenator` | 0.72 |
| `all` | `depends_on` | `readmenator` | 0.71 |
| `nodes` | `depends_on` | `readmenator` | 0.70 |
| `readmenator` | `depends_on` | `all` | 0.70 |
| `readmenator` | `depends_on` | `import` | 0.70 |
| `returns` | `depends_on` | `graph` | 0.70 |
| `empty` | `depends_on` | `readmenator` | 0.69 |
| `symbol` | `depends_on` | `file` | 0.69 |
| `file` | `depends_on` | `import` | 0.68 |
| `per` | `depends_on` | `readmenator` | 0.68 |
| `readmenator` | `depends_on` | `symbol` | 0.68 |
| `text` | `depends_on` | `file` | 0.68 |
| `config` | `depends_on` | `readmenator` | 0.67 |
| `edges` | `depends_on` | `file` | 0.67 |
| `graph` | `depends_on` | `import` | 0.67 |
| `graph` | `depends_on` | `map` | 0.67 |
| `returns` | `depends_on` | `every` | 0.67 |
| `contract` | `depends_on` | `readmenator` | 0.66 |
| `file` | `depends_on` | `map` | 0.66 |
| `graph` | `depends_on` | `return` | 0.66 |
| `project` | `depends_on` | `every` | 0.66 |
| `when` | `depends_on` | `readmenator` | 0.66 |

## Dialectic Prompts

- Thesis: `all` centralizes 53 files; Antithesis: `build` pulls 54 files with 28 shared (Jaccard 0.35); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `content` pulls 51 files with 24 shared (Jaccard 0.30); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `directory` pulls 38 files with 22 shared (Jaccard 0.32); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `every` pulls 53 files with 27 shared (Jaccard 0.34); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `file` pulls 91 files with 43 shared (Jaccard 0.43); Synthesis: should they merge, split by layer, or keep `depends_on` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `files` pulls 66 files with 34 shared (Jaccard 0.40); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `graph` pulls 73 files with 33 shared (Jaccard 0.35); Synthesis: should they merge, split by layer, or keep `depends_on` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `list` pulls 39 files with 27 shared (Jaccard 0.42); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `map` pulls 47 files with 24 shared (Jaccard 0.32); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `all` centralizes 53 files; Antithesis: `nodes` pulls 55 files with 28 shared (Jaccard 0.35); Synthesis: should they merge, split by layer, or keep `bridges` explicit?