quoth-genesis

# Quoth Genesis v3.0

Generates comprehensive documentation from your codebase with configurable depth.

## Prerequisites

- Quoth MCP must be connected (`claude mcp add quoth`)
- Project should be initialized (`/quoth-init` or existing `.quoth/config.json`)

## Phase 0: Configuration Check

First, check if `.quoth/config.json` exists:

```bash
ls -la .quoth/config.json 2>/dev/null || echo "Not initialized"
```

**If not initialized:** Run `/quoth-init` first to configure:
- Strictness level (blocking/reminder/off)
- Knowledge types (decisions, patterns, errors, knowledge, selectors, api)
- Documentation gates (require_reasoning_before_edit, require_quoth_search)

**If already initialized:** Proceed to Phase 1.

## Phase 1: Choose Depth

Ask the user to select documentation depth:

| Depth | Documents | Time | Use Case |
|-------|-----------|------|----------|
| **minimal** | 3 | ~3 min | Quick overview, basic context |
| **standard** | 5 | ~7 min | Team onboarding, regular development |
| **comprehensive** | 11 | ~20 min | Enterprise audit, full documentation |

### Document Coverage by Depth

**Minimal (3 docs):**
- project-overview.md
- tech-stack.md
- repo-structure.md

**Standard (5 docs):**
- All minimal docs +
- coding-conventions.md
- testing-patterns.md

**Comprehensive (11 docs):**
- All standard docs +
- api-schemas.md
- database-models.md
- shared-types.md
- error-handling.md
- security-patterns.md
- tech-debt.md

## Phase 2-5: Documentation Generation

Use the `quoth_genesis` tool with the selected depth:

```
quoth_genesis({ depth: "standard" })
```

The tool handles:
- Reading local files using native file access
- Analyzing codebase structure and patterns
- Generating documentation with YAML frontmatter
- Uploading to Quoth incrementally (not batched)
- Automatic versioning via database triggers

### Genesis Phases

- **Phase 1: Foundation** (all depths) - `project-overview.md`, `tech-stack.md`
- **Phase 2: Architecture** (all depths) - `repo-structu