# Proj Init

> Bootstrap a project workspace at projects/{slug}/ with README, requirements/, architecture/, work/, compound/.

- Skill: `karlorz/proj-init` (Agent Skill)
- Install (CLI): `npx skillmds@latest add karlorz/proj-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/karlorz/proj-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: karlorz (https://skillmd.com/u/karlorz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/karlorz/proj-init

---


# proj-init

## When to invoke
- User starts a new project that should live inside the vault.

## Pre-orientation reads
Standard four reads (vault SCHEMA, index, log) — no project context yet.

## Inputs
- Slug (lowercase, hyphenated).
- One-line intent.

## Steps
1. Verify `projects/{slug}/` does not exist.
2. Create folders: `projects/{slug}/{requirements,architecture,work,compound}/`.
3. Render `projects/{slug}/README.md` from `project-README.md` template, filling `{{slug}}` and `{{date}}`. The template includes a `## Knowledge Pages` section with a placeholder; agents populate it on first ingest via `skillwiki project-index`.
4. Update vault `index.md` "Projects" section: add `- [[projects/{slug}]]`.
5. Append vault `log.md` entry: "Project {slug} initialized."

## Stop conditions
- `projects/{slug}/` already exists.

## Forbidden
- Modifying any other project's files.