# Init

> Initialize and analyze a new project. First engages in discovery conversation to understand user requirements, then generates documentation. Use when starting work on any new codebase. Use when this capability is needed.

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

---


# Project Initialization Skill

## Usage
```
/init [path] [--discover|--generate|--full|--quick|--sync|--update]
```

### Parameters

| Mode | Input | Output | Use When |
|------|-------|--------|----------|
| `--full` | None | .codex/ + DISCOVERY + Docs + Phases | New project (RECOMMENDED) |
| `--discover` | None | DISCOVERY.md | Idea stage only |
| `--generate` | DISCOVERY.md | PRD + TECH-SPEC + PROGRESS + CONTEXT | After discovery |
| `--sync` | .codex/ | Merged .codex/ | Existing project |
| `--update` | None | Updated ultra-codex-init + sync | Framework update |
| `--quick` | Code | AGENTS.md | Quick context |

### Examples
```bash
/init --full               # Full workflow (NEW PROJECT)
/init --discover           # Discovery conversation only
/init --generate           # Generate from existing DISCOVERY.md
/init --sync               # Sync framework to existing project
/init --update             # Update ultra-codex-init + sync
/init ./my-project --full  # Initialize specific path
```

### Workflow Chain
```
/init --full   → Framework Setup → Discovery → Confirmation → Generate → Phase Split
/init --sync   → Analyze .codex/ → Merge missing → Validate → Report
/init --update → Locate source → git pull → Sync → Report
```

### Critical Rule
> For new projects, ALWAYS start with discovery. Never generate docs without understanding.

---

> **Full implementation**: Load [references/DETAIL.md](references/DETAIL.md) for mode details, step implementations, decision flow, best practices, integration points, and framework sync details.

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