# Mo Arch

> 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". Use when this capability is needed.

- Skill: `tomevault-io/mo-arch` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mo-arch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mo-arch/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mo-arch

---


# 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
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dreamlx) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->