/mo-arch

Name

mo-arch

Description

Query code architecture using README_AI.md index files. Use when user asks about project structure, where features are implemented, how modules work, or wants to understand codebase architecture. Triggered by questions like "what does this do", "where is X implemented", "how does module Y work".

# mo-arch - Code Architecture Query

Query code architecture using README_AI.md index files generated by codeindex.

## Workflow

### Step 1: Check Project Index

```bash
cat PROJECT_INDEX.md 2>/dev/null
```

If exists, this gives you the project overview with all modules listed.

### Step 2: Find Directory Indexes

```bash
find . -name "README_AI.md" -type f | head -10
```

### Step 3: Read Relevant Module Index

Based on user's question, locate the relevant module and read its README_AI.md:

```bash
# Example: user asks about parser
cat src/parser/README_AI.md
```

### Step 4: Trace Dependencies

Check the **Consumes** and **Provides** sections in README_AI.md to understand module relationships.

### Step 5: Deep Dive (if needed)

Only read actual source files when README_AI.md doesn't have enough detail.

## Response Format

When answering architecture questions:

1. **Start with the module location** - "The parser is in `src/codeindex/parser.py`"
2. **Explain its purpose** - From the Purpose section
3. **Show relationships** - From Consumes/Provides
4. **Provide code reference** - Line numbers if relevant

## Example

**User**: "Where is the parser implemented?"

**Response**:
```
Based on README_AI.md, the parser is in `src/codeindex/parser.py`.

**Purpose**: Tree-sitter based Python parser that extracts Symbol
(classes, functions, methods) and Import statements into ParseResult.

**Key exports**:
- `parse_file()` - Parse a single Python file
- `ParseResult` - Container for parsed data
- `Symbol` - Represents a code symbol

**Dependencies**: tree-sitter, tree-sitter-python
```

## When No Index Exists

If README_AI.md files don't exist, suggest:

```
This directory is not indexed. Run:
  codeindex scan ./path/to/dir

Or for the entire project:
  codeindex list-dirs | xargs -P 4 -I {} codeindex scan {}
  codeindex index
```